CorroborateMe

CorroborateMe

向 Agent 和应用证明终端用户的身份。

CorroborateMe 为 Agent 和应用提供公司 API 密钥和人工登录链接，并通过多渠道通知，让它们能够证明终端用户的身份；此外还支持 OIDC 客户端注册、集成密钥和按预算计费。REST 是一等功能；MCP 则为可选项。

在线端点： https://corroborateme.com/mcp

此代码库是供目录爬虫使用的公开目录和架构存根，并非托管服务。请让 MCP 客户端通过上方在线 URL 连接，并使用 CorroborateMe API 密钥（aa_...）或 MCP OAuth（PRM 位于 /.well-known/oauth-protected-resource）。绑定新的 OAuth 客户端需要先提供该 aa_... 密钥（或使用控制台成员会话）。运行此代码库中的 TypeScript 不会验证用户身份，也不会存储密钥。

**Agent 指南：**有关发现 URL、身份验证和 MCP 连接片段，请参阅 AGENTS.md。

获取 API 密钥

无需人工参与（Agent）

1. 使用可选参数 { "company_name": "...", "contact_email": "[email protected]" } 向 POST https://corroborateme.com/api/agents/bootstrap 发送请求 -> 获取引导令牌（不会发送外发邮件）。
2. 使用 Authorization: Bearer <bootstrapToken> 和可选参数 { "sku": "pro_prepaid_30d" } 向 POST https://corroborateme.com/api/billing/machine-pay 发送请求。
3. 启用后结算 Stripe MPP（金额请参阅在线的 GET /api/config）-> 解锁成功后，响应会包含 secret（aa_...）。

请参阅 llms.txt 和 llms-full.txt。法律信息：条款 · 隐私。

人工流程

1. 打开 corroborateme.com 并创建账户。
2. 在定价页面订阅，然后在控制台中生成 API 密钥。密钥以 aa_ 开头。
3. 将公司密钥用于 REST 和 MCP。

切勿提交真实密钥。请在配置中使用 aa_... 占位符。

连接客户端

传输方式为 Streamable HTTP。使用以下任一方式进行身份验证：

• Authorization: Bearer aa_...（来自控制台的 API 密钥，或通过引导流程 + 机器支付获得的密钥），或
• MCP OAuth ——先获取 aa_... 密钥（通过引导流程 + 机器支付，或从控制台获取）。主机从 /.well-known/oauth-protected-resource 发现 PRM，通过 DCR 注册，然后在浏览器授权前，使用 Authorization: Bearer aa_...（从密钥获取公司信息）或控制台成员会话加上 company_id，通过 POST /api/oidc/start 绑定客户端。仅提供 company_id 会被拒绝（401）。

Cursor

通过 Cursor Marketplace 安装（插件）

此仓库包含 Cursor 插件清单 和根目录中的 mcp.json，可从 Cursor Marketplace 一键安装。

1. 从 Marketplace 安装 CorroborateMe 插件（或克隆此仓库以进行本地插件测试）。
2. 打开 Cursor 设置 -> 自定义 -> CorroborateMe，并设置 CorroborateMe API key（通过 bootstrap + machine-pay 或控制台获取的 aa_...）。
3. 重新加载窗口。MCP 工具应显示在 CorroborateMe 服务下。

此插件指向 https://corroborateme.com/mcp，并使用 Authorization: Bearer ${CORROBORATE_ME_API_KEY}。切勿提交真实密钥。

准备就绪后，在 cursor.com/marketplace/publish 提交公开仓库。

手动配置 MCP

用户或项目的 MCP 配置：

{
  "mcpServers": {
    "corroborate-me": {
      "url": "https://corroborateme.com/mcp",
      "headers": {
        "Authorization": "Bearer aa_..."
      }
    }
  }
}

Claude Desktop / Claude Code

{
  "mcpServers": {
    "corroborate-me": {
      "command": "npx",
      "args": ["mcp-remote", "https://corroborateme.com/mcp", "--header", "Authorization: Bearer aa_..."]
    }
  }
}

通用远程 MCP

{
  "url": "https://corroborateme.com/mcp",
  "headers": {
    "Authorization": "Bearer aa_..."
  }
}

产品主机上的发现清单：

• /.well-known/mcp.json
• /.well-known/oauth-protected-resource（MCP OAuth）
• /llms.txt
• /openapi.json

工具

src/server.ts 中的架构与托管服务一致。

工具	功能
agent_bootstrap	启动无人参与的公司注册流程（电子邮件 OTP，然后获取 bootstrap 令牌）
budget_get	已认证公司的剩余配额
billing_checkout	为人工用户 Pro 创建 Stripe Checkout URL
billing_machine_pay	Agent 通过 Stripe MPP 预付解锁（sku 可选）
billing_portal	Stripe Customer Portal URL
keys_create	创建新的 aa_ API 密钥（仅显示一次）
oauth_client_create	注册 OIDC 信赖方客户端（启用 RP 注销；可选注销后 URI）
oauth_client_revoke	软撤销 OIDC 信赖方客户端（停止授权和令牌刷新）
integration_upsert	存储加密的集成密钥（Google/Apple 等）
integration_list	列出集成（仅显示前缀，不含密钥）
create_login_link	创建一次性人工登录 URL，并指定通知方式
get_login_status	轮询登录链接会话状态
retry_login_webhook	通知失败后重试已签名的 webhook 投递
webhook_allowlist_add	将回调 URL 前缀加入允许列表

典型 Agent 循环

1. 使用电子邮件 OTP 完成注册（agent_bootstrap 或 REST /api/agents/bootstrap），然后在需要时解锁预付 Pro（billing_machine_pay）。
2. 如果需要长期使用的 aa_... 密钥，使用 keys_create 创建密钥。
3. 将回调前缀加入允许列表（webhook_allowlist_add），然后调用 create_login_link 获取人工验证。
4. 使用 get_login_status 轮询（或等待 webhook / 重定向 / postMessage）。
5. 按需使用 REST 或 MCP 管理密钥、OIDC 客户端和集成。

对于可能变化的操作指南，请优先参考最新的文档和 llms-full.txt。

身份验证和错误

• 401 - 缺少或无效的 Authorization（API 密钥 aa_... 或 MCP OAuth 访问令牌）
• 402 / 429 - 套餐或配额问题；请遵循实时 API 返回的机器可读操作指引
• 定价金额：读取实时的 GET /api/config；不要将美元价格硬编码为永久不变的事实（撰写本文时：Pro 为 $5.99/月，Agent 预付 Pro 为每 30 天 $5.99）

产品文档

• 应用：corroborateme.com
• 文档：corroborateme.com/docs
• OpenAPI：corroborateme.com/openapi.json
• Swagger：corroborateme.com/swagger

CorroborateMe 产品（Worker、计费、IdP）为闭源。本目录采用 MIT 许可证，供目录站点列出工具和安装片段。

目录收录

注册表名称：com.cnrcode/corroborateme（通过 cnrcode.com 使用域名命名空间）。

1. 确保已部署 https://cnrcode.com/.well-known/mcp-registry-auth。

2. 设置 GitHub 仓库密钥 MCP_PRIVATE_KEY（现有的 cnrcode.com Ed25519 私钥十六进制值；切勿提交）。

3. 推送版本标签，以便 GitHub Actions 将 server.json 发布到 官方 MCP 注册表：

   git tag v0.1.4
   git push origin v0.1.4
   

接入官方注册表的目录（PulseMCP、MCPCentral、MCPFind、Glama connectors）会从那里收录该条目。其他目录（Glama server listing、Smithery、mcpservers.org、mcp.directory、MCP Market、McpMux）仅由维护者提交。请参阅 docs/directory-listings.md。

Stdio 桩（目录检查）

此仓库包含一个 stdio 目录桩（src/main.ts），供目录构建容器、启动进程并检查 13 个工具定义。它不实现身份验证或计费——客户端仍连接到上述托管端点。

本地验证：

npm ci && npm run build && npm start   # hangs on stdio - expected
docker build -t corroborate-me-stub . && docker run -i corroborate-me-stub

许可证

MIT - 仅包含目录、文档和架构桩。