mcp-persona

@codespar/mcp-persona

适用于 Persona 的 MCP 服务——现代化、以开发者为先的身份验证与 KYC。

Persona 是现代初创企业和金融科技公司青睐的可编程身份层，这些公司重视开发者体验（DX）和基于模板的工作流。Persona 不使用固定的 KYC 流程，而是由你在 Persona 控制面板中组合查询模板，复用各种构建模块——证件、人脸自拍、数据库、电话、银行——再由 Persona 编排托管流程。

这是 CodeSpar identity 类别中的第四个条目。它与其他服务的定位如下：

提供商	定位
Unico	巴西市场领先者——本地 PEP、法院记录、巴西联邦税务局生物特征数据库
Onfido	全球挑战者——覆盖 195 多个国家的证件验证与人脸相似度比对
Jumio	全球企业级服务——更深入的欺诈情报、更长的运营历史
Persona	现代化、以开发者为先——出色的开发者体验、基于模板的可编程工作流

如果你希望快速上线、无需提交供应商工单即可迭代流程，并将验证接入自己的产品界面，请选择 Persona。

工具（20）

工具	用途
create_inquiry	创建 Persona 查询——一个绑定到你在 Persona... 中配置的查询模板的验证会话
retrieve_inquiry	按 ID 获取查询。
list_inquiries	列出查询，可按 reference-id（你的内部用户 ID）或状态筛选。
approve_inquiry	将查询标记为已批准。
decline_inquiry	将查询标记为已拒绝。
redact_inquiry	对查询进行隐去处理（GDPR 删除权）。
create_account	创建持久化的 Persona 账户——可供多个查询关联的长期终端用户记录。
retrieve_account	按 ID 获取 Persona 账户，包括 PII 摘要和关联的查询／验证。
list_reports	列出报告——单项验证记录（例如
retrieve_report	按 ID 获取单份报告——返回完整的验证详情（匹配项、评分、原始来源数据）。
create_case	创建案件——用于持续调查的工作区，可关联一个或多个查询／账户。
resume_inquiry	恢复已暂停的查询——返回新的单次会话令牌／链接，以便终端用户继续流程...
update_account	更新现有 Persona 账户的属性（例如
list_accounts	列出 Persona 账户，可按 reference-id（你的内部用户 ID）或电子邮件筛选。
run_report	创建并运行独立的 Persona 报告——不关联查询流程。
retrieve_case	按 ID 获取案件——完整详情包括状态、负责人、关联对象、附加字段和标签。
list_cases	列出调查案件，可按状态、负责人或优先级筛选。
add_case_tag	为案件添加标签。
list_templates	列出在 Persona 控制面板中配置的查询模板——返回每个模板的 ID（itmpl_...）、名称，...
list_webhooks	列出已配置的 webhook 订阅（Persona 称其为“Webhook 订阅”）。

流程

create_inquiry (inquiry-template-id=itmpl_...)
    -> user completes Persona-hosted flow (doc + selfie + whatever the template runs)
    -> retrieve_inquiry   (poll until status = 'completed' | 'approved' | 'declined' | 'needs_review')
    -> approve_inquiry / decline_inquiry   (record your final decision)
    -> list_reports / retrieve_report       (for standalone reports like watchlist / adverse-media)

账户（create_account / retrieve_account）会在多个查询间持久保存终端用户记录——在 create_inquiry 中通过 account-id 将后续会话关联到账户。

案件（create_case）会创建用于持续调查的工作区（定期重新验证、标记用户、人工审核）。

安装

npm install @codespar/mcp-persona

环境变量

PERSONA_API_KEY="..."              # API key (required, secret)
PERSONA_API_VERSION="2023-01-05"   # Optional. Sent as Persona-Version header.

身份验证

Authorization: Bearer <PERSONA_API_KEY>
Persona-Version: 2023-01-05

服务会自动处理这两种请求头。

JSON:API 信封

Persona 使用 JSON:API 风格的请求信封：每个 POST 请求体都会包装为 { data: { attributes: {...} } }。此服务会为你处理包装——工具输入直接对应内部的 attributes 结构，并按照 Persona 的惯例使用 kebab-case 键：

{
  "inquiry-template-id": "itmpl_ABC123",
  "reference-id": "user_42",
  "fields": {
    "name-first": "Ada",
    "name-last": "Lovelace",
    "birthdate": "1815-12-10",
    "address-country-code": "US"
  }
}

服务在线路上发送的内容如下：

{ "data": { "attributes": { "inquiry-template-id": "itmpl_ABC123", ... } } }

运行

# stdio (default — for Claude Desktop, Cursor, etc)
npx @codespar/mcp-persona

# HTTP (for server-to-server testing)
MCP_HTTP=true MCP_PORT=3000 npx @codespar/mcp-persona

何时选择 Persona 而不是其他身份提供商

信号	选择
快速发展的初创公司／金融科技公司，重视开发者体验（DX），希望快速迭代流程	Persona
需要自定义工作流，复用文档、人脸自拍、银行和手机号验证	Persona
用户是巴西人，需要 CPF + Receita Federal 生物特征匹配	Unico
覆盖全球 195+ 个国家／地区，受监管的金融科技公司需要 AML／PEP 服务	Onfido
银行／大型受监管的交易平台需要深入的欺诈情报	Jumio

企业版

需要为 Agent 付款提供治理、预算上限和审计追踪？CodeSpar Enterprise 在这些 MCP 服务之上增加策略引擎、支付路由和合规模板。

许可证

MIT