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

設定 → 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_...`	用戶端安全的 session 建立（`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
Session 步驟（同意、預檢、活體、上傳）	無：URL 中的 session 權杖即為憑證

僅在受信任的伺服器端環境中使用私人金鑰。切勿在前端程式碼、公開儲存庫或共享聊天中暴露它們。

使用權杖的範例用戶端設定

{
  "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`	寫入	建立新的活體年齡驗證 session。
`get_age_verification_result`	讀取	讀取活體年齡驗證 session 的結果。
`start_age_verification_liveness`	寫入	開始 session 的活體捕捉。
`verify_age_from_selfie`	寫入	從單張自拍照估算年齡，無需活體。

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

內容審核（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`	讀取	依 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 授權。