Bynn Intelligence

官方

文件詐欺偵測（圖片、PDF）

你可以用 Bynn Intelligence MCP 做什麼？

偵測 AI 生成圖片 — 請您的助理透過 detect_ai_generated_image 檢查圖片是否為 AI 生成，並回傳判定結果、機率及可能的生成工具。
執行文件詐欺分析 — 使用 submit_document 提交文件以進行完整真實性分析，然後輪詢 get_document 直到鑑識報告準備就緒。
建立 KYC 驗證工作階段 — 使用 create_session 啟動身分驗證流程，並取得可傳送給申請者的託管連結或 QR code。
從自拍照估算年齡 — 呼叫 verify_age_from_selfie 估算個人年齡，並與 18 或 21 等門檻值比對，可選擇啟用活體偵測。
在集合中搜尋人臉 — 使用 enroll_face 註冊人臉，並透過 search_faces 在您組織的集合中尋找相符項目。
管理 API 金鑰與帳單 — 使用 list_api_keys／rotate_api_key 列出、擷取或輪換 API 金鑰，並透過帳單工具檢查使用量或發票。

文件

Fetch the complete documentation index at: https://docs.bynn.com/llms.txt. Use this file to discover all available pages before exploring further. Append .md to any documentation page URL to get its markdown version.

Bynn MCP

Connect any MCP-compatible AI client to Bynn: identity verification (KYC), document fraud detection, age verification, content moderation, face search, AutoDoc workflows, fraud reasoning agents, and account management. 143 tools over the Bynn API, one connection. Works in Claude (claude.ai, Desktop, Claude Code), ChatGPT, Cursor, VS Code, Windsurf, and Zed.

https://mcp.bynn.com

The endpoint is the root path. Do not append /mcp; https://mcp.bynn.com/mcp will not work. The only other route is 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

設定 → Apps & Connectors → 啟用開發者模式 → 建立 → 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 個工具）

存取徽章：Read = 安全、非變更操作。Write = 建立或變更資料。 Destructive = 刪除、取消或撤銷（delete_*、cancel_*、rotate_api_key）；請在你的用戶端中為這些工具保持確認功能啟用。每個工具也帶有機器可讀的 readOnlyHint / destructiveHint 註解，因此 MCP 用戶端可以自動為它們設限。

文件（4）

工具	存取	說明
`delete_document`	Destructive	刪除文件提交。
`get_document`	Read	擷取文件提交及其鑑識分析結果。
`list_documents`	Read	列出並搜尋你的文件提交。
`submit_document`	Write	提交文件進行完整的詐騙／真實性分析。

文件分析是非同步的：submit_document，然後輪詢 get_document，直到 status 為 analyzed。

年齡驗證（5）

工具	存取	說明
`complete_age_verification_liveness`	Write	完成活體捕捉。
`create_age_verification_session`	Write	建立新的活體年齡驗證工作階段。
`get_age_verification_result`	Read	讀取活體年齡驗證工作階段的結果。
`start_age_verification_liveness`	Write	開始工作階段的活體捕捉。
`verify_age_from_selfie`	Write	僅從單張自拍照估算年齡，不需活體。

verify_age_from_selfie 接受 age_verification_model 門檻（21、18 及更低，預設 18）以及 legal_age_21 管轄權旗標。活體流程為：建立工作階段 → 開始活體 → 完成活體 → 取得結果。

內容審核（12）

工具	存取	說明
`check_age`	Write	估算圖片中臉部的年齡（年齡驗證／未成年人偵測）。
`create_moderation_inference`	Write	執行審核／AI 偵測推論。
`detect_ai_generated_image`	Write	檢查圖片是 AI 生成還是真實照片。
`get_moderation_dashboard_stats`	Read	取得你組織的審核儀表板統計資料。
`get_moderation_inference`	Read	依 ID 擷取過去的審核推論。
`get_moderation_model`	Read	取得單一審核模型及完整文件。
`list_all_moderation_models`	Read	列出所有類型的所有公開審核模型。
`list_audio_moderation_models`	Read	列出依類別分組的音訊審核模型。
`list_image_moderation_models`	Read	列出依類別分組的圖片審核模型。
`list_text_moderation_models`	Read	列出依類別分組的文字審核模型。
`list_video_moderation_models`	Read	列出依類別分組的影片審核模型。
`public_moderation_inference`	Write	執行免費的公開 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`	Write	建立新的臉部集合。
`delete_face`	Destructive	從集合中刪除單一已註冊臉部。
`delete_face_collection`	Destructive	刪除臉部集合及其所有已註冊臉部。
`enroll_face`	Write	將單一臉部註冊到集合中。
`list_face_collections`	Read	列出你組織的臉部集合。
`search_faces`	Read	在集合中搜尋與探測圖片相似的臉部。

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`	讀取	依 token 取得單一代理（編排器或操作員）。
`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 與校驗和）位於 releases 頁面。

驗證一次（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	該工具群組的憑證類型錯誤；請參閱 auth 表格。API 金鑰與帳單需要儀表板權杖，而非原始 `private_` 金鑰。
影像工具表示未提供影像	出現的卡片接受拖放；將影像拖入其中。或傳入公開的 `image_url`。
文件卡在 `pending`	分析是非同步的；輪詢 `get_document` 直到 `status` 為 `analyzed`。不要每隔幾秒就輪詢超過一次。
OAuth 連接器停止運作	中斷並重新連接連接器，以重新執行登入流程。

支援

問題與疑問：github.com/Bynn-Intelligence/bynn-mcp-server · bynn.com · dashboard.bynn.com

MIT 授權。