Bynn Intelligence

官方

文档欺诈检测（图像、PDF）

你可以用 Bynn Intelligence MCP 做什么？

检测AI生成的图像 — 让您的助手检查图像是否为AI生成，通过 detect_ai_generated_image 返回判定结果、概率及可能的生成工具。
运行文档欺诈分析 — 提交银行对账单或发票进行取证欺诈分析，并轮询 get_document 直至风险评估完成。
创建KYC验证会话 — 生成带有托管链接的身份验证会话，然后通过 get_session_preflight 和 get_session 跟踪进度。
从照片估算年龄 — 通过自拍或图像验证个人年龄，支持活体检测和法定年龄阈值选项，使用 verify_age_from_selfie。
在集合中搜索人脸 — 将人脸登记到集合中，并使用探针图像通过 search_faces 进行搜索以查找匹配项。
管理AutoDoc工作流 — 创建、复制并监控文档收集工作流、卷宗及人工介入审批。

文档

Bynn MCP

将任何兼容 MCP 的 AI 客户端连接到 Bynn：身份验证（KYC）、文档欺诈检测、年龄验证、内容审核、人脸搜索、AutoDoc 工作流、欺诈推理代理和账户管理。通过 Bynn API 提供 143 个工具，一次连接即可使用。适用于 Claude（claude.ai、Desktop、Claude Code）、ChatGPT、Cursor、VS Code、Windsurf 和 Zed。

https://mcp.bynn.com

端点是根路径。 不要附加 /mcp；https://mcp.bynn.com/mcp 将无法工作。唯一其他路由是 GET /health。

快速开始（30 秒）

Claude Code：

claude mcp add --transport http bynn https://mcp.bynn.com

Claude 或 ChatGPT（托管）： 添加 https://mcp.bynn.com 作为自定义连接器，并在浏览器打开时使用您的 Bynn 账户登录。无需处理密钥。

API 风格客户端： 在 dashboard.bynn.com/authenticate 获取令牌，并在连接时将其作为 Authorization: Bearer <token> 发送。

然后尝试您的第一个提示：

Check whether this image is AI-generated.

附加一张图片，结果将以交互式卡片形式呈现，包含判定、AI 概率和最可能的生成器。

示例提示

欺诈与文档

Submit this bank statement for fraud analysis and summarize the risk when it finishes.
Is this invoice manipulated? Show me the forensic findings.
Run my passport-fraud orchestrator against the latest analyzed document.

验证

Create a KYC verification session for this applicant and give me the hosted link.
Estimate the age of the person in this photo and tell me if they look under 25.
Create an age verification session with liveness for user 8841.

审核与媒体

Check whether this image is AI-generated.
Which moderation models can I run on video?
Search this face against my employees collection.

账户与操作

List my API keys and when they were last used.
Rotate my live private key but keep the grace period.
Show this month's usage and my latest invoices.

文档欺诈和 AI 图像结果在 ChatGPT 和 Claude 中均以交互式卡片形式呈现（参见交互式小部件）。

安装

Claude Code

claude mcp add --transport http bynn https://mcp.bynn.com

Claude Desktop 和 claude.ai

设置 → 连接器 → 添加自定义连接器 → URL https://mcp.bynn.com。首次使用时将自动启动 OAuth 登录。

ChatGPT

设置 → 应用与连接器 → 启用开发者模式 → 创建 → MCP 服务器 URL https://mcp.bynn.com。Bynn 是作为 ChatGPT 应用构建的：欺诈报告和 AI 图像检查以交互式卡片形式呈现，附加的图像会原生转发给工具。

Cursor

点击上方一键添加，或手动添加到 ~/.cursor/mcp.json（或每个项目的 .cursor/mcp.json）：

{
  "mcpServers": {
    "bynn": {
      "url": "https://mcp.bynn.com"
    }
  }
}

VS Code（GitHub Copilot）

.vscode/mcp.json：

{
  "servers": {
    "bynn": {
      "type": "http",
      "url": "https://mcp.bynn.com"
    }
  }
}

Windsurf

Windsurf 通过 mcp-remote 桥接器连接：

{
  "mcpServers": {
    "bynn": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.bynn.com"]
    }
  }
}

Zed

settings.json → context_servers：

{
  "context_servers": {
    "bynn": {
      "command": {
        "path": "npx",
        "args": ["-y", "mcp-remote", "https://mcp.bynn.com"]
      }
    }
  }
}

身份验证

OAuth 2.1（连接器）

托管连接器（Claude、ChatGPT）使用 OAuth 2.1 + PKCE 进行身份验证。授权服务器是 dashboard.bynn.com；您的 MCP 客户端打开浏览器登录，您批准请求的权限，然后客户端以您的 Bynn 仪表板用户身份连接。支持动态客户端注册（Claude、Cursor）的客户端会自动注册。

Bearer 令牌（API 风格客户端）

对于服务器端、脚本化或自托管使用，请在 MCP 连接上发送授权头：

Authorization: Bearer <token>

在 dashboard.bynn.com/authenticate 获取令牌。支持三种令牌类型：

令牌	前缀	功能
仪表板令牌（JWT）	无	全部功能。当工具需要 API 密钥时，服务器会自动将 JWT 兑换为您组织的密钥。
私有 API 密钥	`private_...`	产品和验证工具（文档、审核、年龄结果）。不足以用于仪表板工具，如 API 密钥或计费。
公共 API 密钥	`public_...`	客户端安全的会话创建（`create_session`、`create_age_verification_session`）。

按工具组划分：

工具组	最低凭据
API 密钥、计费、用户、AutoDoc、推理、网站	仪表板令牌（JWT）
文档、审核、人脸、NFC	私有密钥或 JWT
`create_session`、`create_age_verification_session`	公共密钥或 JWT
`verify_age_from_selfie`、`get_age_verification_result`	私有密钥或 JWT
会话步骤（同意、预检、活体、上传）	无：URL 中的会话令牌即为凭据

仅在受信任的服务器端环境中使用私有密钥。切勿在前端代码、公共仓库或共享聊天中暴露它们。

带令牌的示例客户端配置

{
  "mcpServers": {
    "bynn": {
      "url": "https://mcp.bynn.com",
      "headers": {
        "Authorization": "Bearer ${BYNN_API_KEY}"
      }
    }
  }
}

export BYNN_API_KEY="private_your_bynn_key_here"

工具参考（143 个工具）

访问徽章：读取 = 安全、非修改。写入 = 创建或更改数据。 破坏性 = 删除、取消或撤销（delete_*、cancel_*、rotate_api_key）；请为这些工具在客户端中保持确认启用。每个工具还带有机器可读的 readOnlyHint / destructiveHint 注解，以便 MCP 客户端自动门控它们。

文档（4）

工具	访问	描述
`delete_document`	破坏性	删除文档提交。
`get_document`	读取	检索文档提交及其取证分析结果。
`list_documents`	读取	列出并搜索您的文档提交。
`submit_document`	写入	提交文档进行完整的欺诈 / 真实性分析。

文档分析是异步的：submit_document，然后轮询 get_document 直到 status 为 analyzed。

年龄验证（5）

工具	访问	描述
`complete_age_verification_liveness`	写入	完成活体捕获。
`create_age_verification_session`	写入	创建新的活体年龄验证会话。
`get_age_verification_result`	读取	读取活体年龄验证会话的结果。
`start_age_verification_liveness`	写入	开始会话的活体捕获。
`verify_age_from_selfie`	写入	从单张自拍估算年龄，无需活体。

verify_age_from_selfie 接受 age_verification_model 阈值（21、18 及更低，默认 18）以及 legal_age_21 司法管辖区标志。活体流程为：创建会话 → 开始活体 → 完成活体 → 获取结果。

内容审核（12）

工具	访问	描述
`check_age`	写入	估算图像中人脸的年龄（年龄验证 / 未成年人检测）。
`create_moderation_inference`	写入	运行审核 / AI 检测推理。
`detect_ai_generated_image`	写入	检查图像是 AI 生成的还是真实照片。
`get_moderation_dashboard_stats`	读取	获取您组织的审核仪表板统计信息。
`get_moderation_inference`	读取	按 ID 检索过去的审核推理。
`get_moderation_model`	读取	获取一个审核模型及完整文档。
`list_all_moderation_models`	读取	列出所有类型的全部公共审核模型。
`list_audio_moderation_models`	读取	按类别列出音频审核模型。
`list_image_moderation_models`	读取	按类别列出图像审核模型。
`list_text_moderation_models`	读取	按类别列出文本审核模型。
`list_video_moderation_models`	读取	按类别列出视频审核模型。
`public_moderation_inference`	写入	运行免费的公共 AI 检测推理，无需凭据。

detect_ai_generated_image 返回 result.is_ai_generated（判定）、 ai_probability、uncertain、top_generator、generators、c2pa_signer 和 detection_mode。check_age 返回每张人脸的 age、from_age/to_age、is_minor、 challenge_25、sex、confidence、uncertainty 和 bbox。

人脸搜索（6）

工具	访问	描述
`create_face_collection`	写入	创建新的人脸集合。
`delete_face`	破坏性	从集合中删除单个已注册人脸。
`delete_face_collection`	破坏性	删除人脸集合及其所有已注册人脸。
`enroll_face`	写入	将单张人脸注册到集合中。
`list_face_collections`	读取	列出您组织的人脸集合。
`search_faces`	读取	在集合中搜索与探针图像相似的人脸。

AutoDoc（37）

工具	访问权限	描述
`add_dossier_note`	写入	向案卷添加管理员备注。
`approve_approval`	写入	批准待处理的人工介入（HITL）审批。
`attach_dossier_tag`	写入	将组织标签附加到案卷。
`create_document_collection`	写入	创建文档集合。
`create_invitation`	写入	通过电子邮件或短信发送 AutoDoc 邀请。
`create_organization_tag`	写入	创建组织标签。
`create_workflow`	写入	创建工作流。
`delete_document_collection`	破坏性	删除文档集合（软删除）。
`delete_invitation`	破坏性	取消（硬删除）待处理的 AutoDoc 邀请。
`delete_organization_tag`	破坏性	删除组织标签。
`delete_workflow`	破坏性	删除工作流（软删除）。
`detach_dossier_tag`	写入	从案卷分离组织标签。
`download_dossier_zip`	读取	将案卷的文档和变量打包为 ZIP 文件。
`duplicate_workflow`	写入	复制工作流。
`get_autodoc_dashboard_stats`	读取	获取聚合的 AutoDoc 仪表板统计信息。
`get_document_collection`	读取	获取一个文档集合及其要求。
`get_dossier`	读取	获取一个案卷及其进度和工作流变量。
`get_dossier_form_fields`	读取	列出当前活动工作流中可用的表单字段名称。
`get_invitation`	读取	获取单个 AutoDoc 邀请。
`get_pending_approval_count`	读取	获取待处理的人工介入（HITL）审批数量。
`get_workflow`	读取	获取单个工作流。
`list_approvals`	读取	列出人工介入工作流审批。
`list_document_collections`	读取	列出组织的文档集合。
`list_document_types`	读取	列出可用于集合要求的文档类型。
`list_dossier_documents`	读取	列出上传到案卷的文档。
`list_dossier_notes`	读取	列出案卷的备注/审计时间线。
`list_dossiers`	读取	列出并筛选 AutoDoc 案卷。
`list_invitation_locales`	读取	列出支持的邀请语言区域。
`list_invitations`	读取	列出 AutoDoc 邀请。
`list_organization_tags`	读取	列出组织的案卷标签。
`list_workflows`	读取	列出组织的工作流。
`reject_approval`	写入	拒绝待处理的人工介入（HITL）审批。
`resend_invitation`	写入	重新发送 AutoDoc 邀请。
`update_document_collection`	写入	更新文档集合及（可选）其要求。
`update_dossier`	写入	重命名案卷。
`update_organization_tag`	写入	更新组织标签的颜色和/或名称。
`update_workflow`	写入	更新工作流。

推理与欺诈代理（25）

工具	访问权限	描述
`create_fraud_agent`	写入	创建欺诈分析代理/操作员。
`create_orchestrator`	写入	创建编排器（协调器）代理。
`create_reasoning_job`	写入	为文档排队异步欺诈推理作业。
`delete_fraud_agent`	破坏性	删除欺诈分析代理/操作员。
`delete_orchestrator`	破坏性	删除编排器代理。
`generate_fraud_agent_prompt`	写入	使用 AI 起草欺诈分析代理系统提示词。
`generate_orchestrator_prompt`	写入	使用 AI 起草编排器系统提示词。
`get_agent`	读取	按令牌获取单个代理（编排器或操作员）。
`get_agent_stats`	读取	获取组织的聚合代理统计信息。
`get_reasoning_job`	读取	获取推理作业的状态和完整结果。
`list_agent_categories`	读取	列出可用的代理类别选项。
`list_agent_ratings`	读取	列出公共代理的评分和评分摘要。
`list_document_content_types`	读取	列出文档内容类型以及哪些已被认领。
`list_fraud_agents`	读取	列出您组织的欺诈分析代理/操作员。
`list_orchestrators`	读取	列出您组织的编排器代理。
`list_public_fraud_agents`	读取	浏览全球社区的公共欺诈分析代理模板。
`list_public_orchestrators`	读取	浏览全球社区的公共编排器模板。
`list_reasoning_jobs`	读取	列出推理作业及筛选条件和组织范围统计。
`publish_agent`	写入	将您的代理之一发布到公共社区市场。
`rate_agent`	写入	为公共代理评分 1-5 星。
`reorder_orchestrator_agents`	写入	重新排序分配给编排器的欺诈分析代理。
`test_orchestrator`	写入	对现有文档同步运行编排器。
`unpublish_agent`	写入	从公共市场移除您的代理之一。
`update_fraud_agent`	写入	更新欺诈分析代理/操作员。
`update_orchestrator`	写入	更新编排器代理。

计费（14）

工具	访问权限	描述
`cancel_billing_plan`	破坏性	安排取消当前订阅。
`change_billing_plan`	写入	更改组织的订阅计划。
`confirm_payment_method`	写入	将已确认的卡片保存为默认支付方式。
`create_setup_intent`	写入	创建 Stripe SetupIntent 以收集支付方式。
`download_invoice`	读取	将发票下载为 PDF 文件。
`get_billing_info`	读取	获取组织的完整计费快照。
`get_current_usage`	读取	获取当前计费周期的未计费用量。
`get_stripe_config`	读取	获取 Stripe 客户端配置。
`list_billing_plans`	读取	列出所有可用的订阅计划及定价和功能。
`list_inference_history`	读取	列出组织的 AI 推理/验证请求历史记录。
`list_invoices`	读取	列出组织的发票，最近的在前。
`topup_balance`	写入	通过已保存的卡片向账户余额添加预付费资金。
`update_company_details`	写入	更新组织的公司/开票信息。
`validate_vat_number`	读取	通过外部查询验证欧盟增值税号。

topup_balance 以美元计，每次充值最低 10 美元，最高 10,000 美元。

用户与账户（7）

工具	访问权限	描述
`activate_trial`	写入	保存支付方式并激活 7 天免费试用，附赠 10 美元信用额度。
`add_passkey`	写入	开始向已认证用户账户添加通行密钥：获取 WebAuthn 创建选项。
`delete_passkey`	破坏性	删除已认证用户的某个通行密钥。
`get_current_user`	读取	获取已认证用户、其组织及快速账户统计信息。
`list_passkeys`	读取	列出已认证用户注册的通行密钥。
`report_public_data`	写入	报告已认证用户公开资料中的错误数据。
`submit_onboarding_survey`	写入	保存当前用户的组织入职调查。

网站（8）

工具	访问权限	描述
`create_website`	写入	创建新的年龄验证网站配置。
`delete_website`	破坏性	永久删除年龄验证网站配置。
`get_website`	读取	按 ID 获取一个年龄验证网站。
`list_countries`	读取	列出所有国家/地区及其代码和属性。
`list_verifications`	读取	浏览组织的年龄验证历史记录。
`list_websites`	读取	列出已认证组织的所有年龄验证网站。
`pause_website`	写入	暂停或恢复网站的年龄验证。
`update_website`	写入	更新现有的年龄验证网站配置。

Agemin 检查（3）

工具	访问权限	描述
`get_age_verification_status`	读取	在服务端重新检查先前的年龄验证结果。
`verify_age_with_email`	写入	根据电子邮件地址估算一个人的最低年龄。
`verify_age_with_selfie`	写入	根据单张自拍图像估算一个人的年龄。

验证会话（16）

工具	访问权限	描述
`cancel_session`	破坏性	取消/中止会话。
`check_email_verification`	读取	使用验证码完成电子邮件验证。
`check_phone_verification`	读取	使用短信验证码完成电话验证。
`complete_liveness`	写入	完成人脸活体检测采集。
`create_session`	写入	创建新的身份验证会话。
`get_session`	读取	显示有关进行中会话的信息。
`get_session_preflight`	读取	获取会话的下一个验证步骤。
`give_session_consent`	写入	记录申请人的同意决定。
`send_session_sms`	写入	向申请人发送短信，附上链接以便在其手机上继续操作。
`start_email_verification`	写入	通过发送包含验证码的电子邮件开始电子邮件验证。
`start_liveness`	写入	开始人脸活体检测采集。
`start_phone_verification`	写入	通过发送包含验证码的短信开始电话验证。
`submit_address_verification`	写入	上传地址证明文件。
`submit_funds_verification`	写入	上传资金证明文件。
`update_session`	写入	更新进行中会话的申请人详细信息。
`upload_session_media`	写入	将采集的媒体上传到会话。

API 密钥（3）

工具	访问权限	描述
`get_api_key`	读取	检索现有 API 密钥的完整、未脱敏值。
`list_api_keys`	读取	列出已认证组织的所有 API 密钥。
`rotate_api_key`	破坏性	轮换（重新生成）已认证组织的 API 密钥。

list_api_keys 返回脱敏值；只有 get_api_key 会揭示完整密钥，因此在共享环境中请保持其确认提示开启。rotate_api_key 默认保留旧密钥 12 小时宽限期；传递 immediate: true 可立即撤销。

NFC（1）

工具	访问权限	描述
`submit_nfc_data`	写入	将 NFC 扫描的身份文件数据提交到验证会话。

服务器与自我发现（2）

工具	访问权限	描述
`describe_api`	读取	返回 Bynn REST API 的 OpenAPI 3.0 规范（来自 /openapi.json）。
`describe_cli`	读取	返回 Bynn CLI（`bynn`）的安装、认证和使用说明。

交互式小组件

在支持 MCP 应用（ChatGPT 和 Claude）的主机中，两个工具系列返回交互式卡片而非原始 JSON：

文件欺诈检测（submit_document、get_document）：包含风险仪表、取证信号、提取字段和风险标签的实时报告卡片。待处理的分析会自动轮询直至完成。
AI 图像检测（detect_ai_generated_image）：包含 AI 概率和生成器细分的判定卡片。如果未提供图像，卡片会渲染拖放上传器，拖入的文件将直接发送到检测器，而不会进入聊天上下文。

其他 MCP 客户端则仅接收相同数据的结构化 JSON。

示例工作流

一个完整的 KYC 会话，以对话方式驱动：

1. "Create a verification session for applicant #4471 with my standard KYC level."
   → create_session returns {session_id, dossier_id, url, qr_base64_png, websocket_url}
2. Send the returned `url` to the applicant (or show the QR code).
3. "What's the next step for this session?"
   → get_session_preflight (after give_session_consent) walks each remaining step
4. "Show the session status."
   → get_session, repeated until the flow completes

异步模式在所有地方都是相同的：创建工具返回一个 ID，get_* 工具对其进行轮询。对于文件欺诈检测，submit_document → get_document 直到 status: "analyzed"；对于推理任务，create_reasoning_job → get_reasoning_job。

Bynn CLI：处理本地文件

托管的 MCP 服务器无法读取您机器上的文件。Bynn CLI 可以。在本地运行的代理（Claude Code、Cursor、终端）可以直接分析本地文件：

bynn submit ./bank-statement.pdf -o json      # full document-fraud analysis, auto-polls
bynn ai-generated ./profile-photo.png -o json # AI-generated-image check

安装（macOS/Linux）：

brew tap Bynn-Intelligence/bynn
brew install --cask bynn

安装（Windows）：

scoop bucket add bynn https://github.com/Bynn-Intelligence/scoop-bynn
scoop install bynn

直接下载（以及 .deb/.rpm 和校验和）位于发布页面。

一次性认证（bynn auth login 将密钥存储在您的操作系统钥匙串中），或使用 BYNN_API_KEY、--token 或 bynn auth login --with-token 进行非交互式认证。沙盒密钥（private_sandbox_...）会被自动识别。

为代理友好而设计：-o json 用于结构化输出，--jq 用于过滤，--dry-run 用于预览请求，--poll 用于异步结果，以及清晰的输出契约（stdout = 数据，stderr = 进度）。命令树由实时 Bynn OpenAPI 规范生成，bynn api <METHOD> <PATH> 是对任何端点的原始认证透传。CLI 涵盖会话、年龄验证、AutoDoc 邀请、文件、审核、NFC 和人脸；对于计费、API 密钥、档案、编排器和网站，请使用此 MCP 服务器。

给代理的提示： 调用此服务器上的 describe_cli 工具，以机器可读的形式获取本完整指南。

代理的自我发现

服务器会自我记录。如果您是连接到它的 LLM：

describe_api 返回完整的 Bynn OpenAPI 3.0 规范：每个端点、参数和模式，包括未封装为 MCP 工具的部分。无需认证。
describe_cli 返回在本地安装、认证和运行 bynn CLI 的结构化指南，用于处理本地文件。无需认证。
file://server/status（MCP 资源）返回实时工具列表和服务器状态。

这些也在服务器的 initialize 指令中公布，因此您无需本 README 即可找到它们。

高级

注解与响应契约

每个工具都携带 MCP ToolAnnotations（readOnlyHint、destructiveHint、idempotentHint、openWorldHint），并按动词一致应用：get_*/list_*/search_*/describe_*/download_*/validate_* 为只读；delete_*/cancel_*/rotate_api_key 为破坏性。失败以结构化的 {error: true, error_type, message} 负载返回，而非协议错误，因此代理可以读取并响应它们。

故障排除

症状	修复
404 / 连接立即失败	您在 URL 后附加了 `/mcp`。端点是根路径：`https://mcp.bynn.com`
`authentication_error` / `authentication_required`	在 dashboard.bynn.com/authenticate 获取令牌，并将其设置为 `Authorization` 标头。不要盲目重试。
工具在有效连接下返回 401	该工具组的凭据类型错误；请参阅认证表。API 密钥和计费需要仪表板令牌，而非原始 `private_` 密钥。
图像工具提示未提供图像	出现的卡片支持拖放；将图像拖入其中。或传递一个公开的 `image_url`。
文件卡在 `pending`	分析是异步的；轮询 `get_document` 直到 `status` 为 `analyzed`。不要每隔几秒以上就轮询一次。
OAuth 连接器停止工作	断开并重新连接连接器以重新运行登录流程。

支持

问题与疑问：github.com/Bynn-Intelligence/bynn-mcp-server · bynn.com · dashboard.bynn.com

MIT 许可。