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

Bynn対応のMCP互換AIクライアントを接続: 本人確認（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)

Tool	Access	Description
`get_age_verification_status`	Read	サーバー側で以前の年齢確認結果を再チェックします。
`verify_age_with_email`	Write	メールアドレスから人物の最低年齢を推定します。
`verify_age_with_selfie`	Write	単一の自撮り画像から人物の年齢を推定します。

確認セッション (16)

Tool	Access	Description
`cancel_session`	Destructive	セッションをキャンセル/中止します。
`check_email_verification`	Read	コードを使用してメール確認を完了します。
`check_phone_verification`	Read	SMSコードを使用して電話確認を完了します。
`complete_liveness`	Write	顔のライブネスキャプチャを完了します。
`create_session`	Write	新しい本人確認セッションを作成します。
`get_session`	Read	開いているセッションの情報を表示します。
`get_session_preflight`	Read	セッションの次の確認ステップを取得します。
`give_session_consent`	Write	申請者の同意決定を記録します。
`send_session_sms`	Write	申請者に電話で続行するためのリンクをSMS送信します。
`start_email_verification`	Write	コードをメール送信してメール確認を開始します。
`start_liveness`	Write	顔のライブネスキャプチャを開始します。
`start_phone_verification`	Write	コードをテキスト送信して電話確認を開始します。
`submit_address_verification`	Write	住所証明書類をアップロードします。
`submit_funds_verification`	Write	資金証明書類をアップロードします。
`update_session`	Write	開いているセッションの申請者詳細を更新します。
`upload_session_media`	Write	キャプチャしたメディアをセッションにアップロードします。

APIキー (3)

Tool	Access	Description
`get_api_key`	Read	既存のAPIキーの完全な（マスクされていない）値を取得します。
`list_api_keys`	Read	認証済み組織のすべてのAPIキーを一覧表示します。
`rotate_api_key`	Destructive	認証済み組織のAPIキーをローテーション（再生成）します。

list_api_keys はマスクされた値を返します。完全なシークレットを明かすのは get_api_key のみであるため、共有コンテキストでは確認をオンにしておいてください。rotate_api_key はデフォルトで旧キーを12時間の猶予期間有効に保ちます。即時失効させるには immediate: true を渡します。

NFC (1)

Tool	Access	Description
`submit_nfc_data`	Write	NFCスキャンした身分証明書データを確認セッションに送信します。

サーバーと自己発見 (2)

Tool	Access	Description
`describe_api`	Read	Bynn REST APIのOpenAPI 3.0仕様を返します（/openapi.jsonから）。
`describe_cli`	Read	Bynn CLI（`bynn`）のインストール、認証、使用手順を返します。

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

MCPアプリ（ChatGPTやClaude）をサポートするホストでは、2つのツールファミリーが生の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ライセンス。