Bynn Intelligence

公式

文書詐欺検出（画像、PDF）

Bynn Intelligence MCPで何ができますか？

AI生成画像の検出 — アシスタントにdetect_ai_generated_imageを使用して画像がAI生成かどうかを確認させ、判定結果、確率、推定される生成元を返します。
文書不正分析の実行 — submit_documentで文書を提出して完全な真正性分析を行い、その後get_documentをポーリングしてフォレンジックレポートの準備が整うまで待ちます。
KYC認証セッションの作成 — create_sessionを使用して本人確認フローを開始し、申請者に送信するホスト型リンクまたはQRコードを取得します。
自撮り写真からの年齢推定 — 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

Bynn MCP対応のAIクライアントをBynnに接続します：本人確認（KYC）、文書不正検出、年齢確認、コンテンツモデレーション、顔検索、AutoDocワークフロー、不正推理エージェント、アカウント管理。Bynn API上の143ツールを1つの接続で利用可能。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）をサポートするクライアントは自動的に登録されます。

ベアラートークン（APIスタイルのクライアント）

サーバーサイド、スクリプト、またはセルフホストでの使用には、MCP接続に認証ヘッダーを送信します：

Authorization: Bearer <token>

dashboard.bynn.com/authenticateでトークンを取得します。 3種類のトークンが使用可能です：

トークン	プレフィックス	できること
ダッシュボードトークン（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`	読み取り	完全なドキュメント付きで1つのモデレーションモデルを取得します。
`list_all_moderation_models`	読み取り	すべてのタイプにわたるすべての公開モデレーションモデルを一覧表示します。
`list_audio_moderation_models`	読み取り	カテゴリ別にグループ化されたAUDIOモデレーションモデルを一覧表示します。
`list_image_moderation_models`	読み取り	カテゴリ別にグループ化されたIMAGEモデレーションモデルを一覧表示します。
`list_text_moderation_models`	読み取り	カテゴリ別にグループ化されたTEXTモデレーションモデルを一覧表示します。
`list_video_moderation_models`	読み取り	カテゴリ別にグループ化されたVIDEOモデレーションモデルを一覧表示します。
`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`	書き込み	メールまたはSMSで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`	読み取り	1つのドキュメントコレクションとその要件を取得します。
`get_dossier`	読み取り	進捗状況とワークフロー変数を含む1つのドシエを取得します。
`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`	書き込み	エージェントの1つを公開コミュニティマーケットプレイスに公開します。
`rate_agent`	書き込み	公開エージェントを1〜5つ星で評価します。
`reorder_orchestrator_agents`	書き込み	オーケストレーターに割り当てられた不正分析エージェントを並べ替えます。
`test_orchestrator`	書き込み	既存のドキュメントに対してオーケストレーターを同期的に実行します。
`unpublish_agent`	書き込み	公開マーケットプレイスからエージェントの1つを削除します。
`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`	読み取り	外部ルックアップを介してEUのVAT番号を検証します。

topup_balanceは米ドルで、1回のチャージあたり最低$10、最高$10,000です。

ユーザーとアカウント (7)

ツール	アクセス	説明
`activate_trial`	書き込み	支払い方法を保存し、$10クレジット付きの7日間無料トライアルをアクティブにします。
`add_passkey`	書き込み	認証済みユーザーのアカウントにパスキーを追加し始めます：WebAuthn作成オプションを取得します。
`delete_passkey`	破壊的	認証済みユーザーのパスキーの1つを削除します。
`get_current_user`	読み取り	認証済みユーザー、その組織、およびクイックアカウント統計を取得します。
`list_passkeys`	読み取り	認証済みユーザーの登録済みパスキーを一覧表示します。
`report_public_data`	書き込み	認証済みユーザーの公開プロフィールの誤ったデータを報告します。
`submit_onboarding_survey`	書き込み	現在のユーザーの組織オンボーディング調査を保存します。

ウェブサイト (8)

ツール	アクセス	説明
`create_website`	書き込み	新しい年齢確認ウェブサイト設定を作成します。
`delete_website`	破壊的	年齢確認ウェブサイト設定を完全に削除します。
`get_website`	読み取り	IDで1つの年齢確認ウェブサイトを取得します。
`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`	読み取り	SMSコードを使用して電話確認を完了します。
`complete_liveness`	書き込み	顔のライブネスキャプチャを完了します。
`create_session`	書き込み	新しい本人確認セッションを作成します。
`get_session`	読み取り	開いているセッションに関する情報を表示します。
`get_session_preflight`	読み取り	セッションの次の確認ステップを取得します。
`give_session_consent`	書き込み	申請者の同意決定を記録します。
`send_session_sms`	書き込み	申請者に電話で続行するためのリンクを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`）のインストール、認証、使用手順を返します。

インタラクティブウィジェット

2つのツールファミリーは、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 はキーをOSキーチェーンに保存します）。または 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ライセンス。