Verifa

Verifa MCP Server

从任何 MCP 客户端运行身份验证——Claude Desktop、Cursor、Claude Code，或你自己的 Agent。 创建验证会话，向用户发送采集链接，根据制裁名单和 PEP 名单进行筛查，读取结果并处理审核队列，所有操作都可作为 Agent 能调用的工具。

{
  "mcpServers": {
    "verifa": {
      "command": "npx",
      "args": ["-y", "@verifasolutionsinc/mcp-server"],
      "env": { "VERIFA_API_KEY": "vk_sandbox_...", "VERIFA_ENV": "sandbox" }
    }
  }
}

这就是全部安装步骤。在 app.withverifa.com → Developers → API keys 获取沙盒密钥 （免费，无需银行卡，也无需销售人员联系）。沙盒密钥不会接触真实数据，并可模拟各种验证结果， 因此你只需几分钟就能了解完整流程——examples/id-check 正是这样做的。

工作原理

这个包刻意保持精简。它会与 Verifa 托管的 MCP 端点（https://api.withverifa.com/mcp，可流式传输的 HTTP）建立一个经过身份验证的连接， 并通过标准输入/输出转发 tools/list、tools/call、prompts/list 和 prompts/get。这里不会重新实现任何功能：工具架构、PII 清理、速率限制和 审计跟踪都在服务端，因此这个封装层始终与产品保持一致。

如果你的客户端已支持通过 OAuth 2.1 使用可流式传输的 HTTP，就可以跳过这个包，直接连接到 托管端点——工具相同，只需登录，而非使用 API 密钥。

工具

此服务提供 45 个工具，按工具集分组。默认情况下，除 destructive 外，所有工具集均已启用。

工具集	Agent 可以执行的操作
sessions	create_session、get_session、list_sessions、list_session_events、simulate_session（沙盒）、reprocess_session
checks	list_checks、get_check、list_check_hits、rerun_check — 制裁名单、PEP、负面媒体、监控名单
identities	search_identities、list_identities、get_identity、添加 / 移除标签
cases	list_cases、get_case、claim_case、assign_case、add_case_comment、approve_case、reject_case、escalate_case …
findings	list_findings、get_finding、acknowledge_finding、dismiss_finding
lists	读取和写入阻止名单及自定义名单
workflows	list_workflows、get_workflow、trigger_workflow、list_verification_policies
org	whoami、get_usage_stats、list_org_users、list_api_keys
search	面向 ChatGPT 风格连接器的 search / fetch
destructive	redact_session、redact_identity、bulk_redact_sessions、… — 默认关闭，需主动启用

每个工具都有权限范围限制：无论启用了哪些工具集，API 密钥的权限范围都会限制连接可执行的操作。 每次调用——无论读取还是写入——都会生成一条审计记录，记录调用由 Agent 发起，以及使用了哪个密钥或 OAuth 客户端，因此不会将 Agent 的决策误认为是人工操作。

缩小可用范围

工具越少，每次请求消耗的上下文就越少，工具选择也越准确。根据任务需要选择：

"env": {
  "VERIFA_API_KEY": "vk_sandbox_...",
  "VERIFA_MCP_TOOLSETS": "sessions,checks",
  "VERIFA_MCP_READ_ONLY": "1"
}

变量	作用
VERIFA_API_KEY	必需。使用 vk_sandbox_… 或 vk_live_…。不接受可公开密钥（vk_pub_…）。
VERIFA_ENV	sandbox 或 live。未指定时根据密钥推断；指定时必须与密钥匹配。
VERIFA_MCP_TOOLSETS	以逗号分隔的要公开的工具集。默认值：除 destructive 外的所有工具集。
VERIFA_MCP_READ_ONLY	设为 1 可隐藏所有写入工具。
VERIFA_MCP_ALLOW_DESTRUCTIVE	设为 1 可添加数据擦除工具。每次调用还需要 redact:write 权限范围和书面填写的 reason，并且每个密钥每小时最多调用 5 次。数据擦除在设计上不可逆。
VERIFA_API_URL	覆盖 API 主机（例如，暂存环境）。

无需打开客户端，即可查看给定配置公开了哪些内容：

VERIFA_API_KEY=vk_sandbox_... npx -y @verifasolutionsinc/mcp-server --check

五分钟内上手

git clone https://github.com/Verifa-Solutions/verifa-mcp-server
cd verifa-mcp-server/examples/id-check
npm install
cp .env.example .env        # paste your sandbox key
npm start                   # approve
npm run review              # the outcome that matters: a human has to decide

演示会创建一个会话，生成集成方要展示的一次性采集链接和二维码， 模拟一个结果（无需护照——仅限沙盒），并读取结果。它会在一列中打印 REST 调用， 在另一列中打印通过此 MCP 服务驱动的相同流程。添加 --webhooks 和一个 公开 URL（cloudflared tunnel --url http://localhost:8787 可用），即可接收已签名的 Webhook 投递 并查看签名验证——这是大多数集成容易出错的部分。

开发

npm install
npm run build
npm test                                     # unit tests
VERIFA_API_KEY=vk_sandbox_... node dist/index.js --check   # live smoke test

Node 20+。日志输出到 stderr；stdout 是 MCP 传输通道。

安全

• 评估期间请使用沙盒密钥。生产密钥应限定为 Agent 所需的工具集。
• 服务端绝不会存储或记录 API 密钥；密钥仅作为 Bearer 令牌发送到 VERIFA_API_URL。
• 响应默认不含 PII——托管服务会从工具结果中移除申请人标识符，除非密钥具有相关权限范围且会话的敏感数据窗口已开放。
• 请通过 withverifa.com/security/disclosure 报告漏洞。

许可证

MIT——请参阅 LICENSE。