ツールを絞り込む理由
クライアントは、最初の質問の前に、一覧に含まれるすべてのツールの定義をモデルに送信します。 Didit のカタログ全体では、これだけでリクエストごとに数万トークンになり、モデルのトークナイザーによって約50,000~115,000トークンです。 クライアントによっては、受け付けるツールの数に上限を設けているものもあります。
トレードオフとして、ステップが1つ増えます。
一覧にないツールは失われるわけではありませんが、モデルはそれを実行する前にツール検索で見つける必要があります。すべてのツールを見ているモデルは、検索しなければならないモデルよりも適切なツールを少し高い頻度で選びます。
会話が多くの領域にまたがり、コンテキストのコストが問題にならない場合は、すべてを読み込んでください。
コンテキストのコストが問題になる場合は、
core と、最もよく使うツールセットを読み込んでください。
ツールセットを選ぶ
サーバーURLに、カンマ区切りのリストとしてtoolsetsを追加します:
coreは、ほとんどの作業の出発点になる短いリストです。
組織とアプリケーション、検証セッション(作成、検索、判定、説明、サンドボックスでのシミュレーション、Webhook配信の読み取り)、ワークフローの検索、分析と残高、アプリケーションのAPIキーとWebhook、ケース、ユーザー、企業、取引の検索、そしてドキュメント検索を扱います。
core: 上記の短いリストです。account: 組織、アプリケーション、APIキー、メンバーと役割。billing: プラン、クレジット残高、支払い方法、領収書、請求情報。sessions: 検証セッション(作成、検索、判定、レビュー、共有、インポート、PDF、Webhookの配信)。workflows: 検証ワークフローとアンケート(作成、編集、検証、公開)。lists: カスタムリスト、ブロックリスト、許可リスト。vendors: 検証対象の個人と企業(ベンダーユーザーとベンダー企業)。transactions: トランザクションモニタリング(取引、ウォレットスクリーニング、バックテスト付きのルール)。cases: ケース管理(ケースの作成、割り当て、エスカレーション、解決)。investigator: Investigator(レビューキュー、レポート、判定、ポリシーに関する質問、パフォーマンス)。webhooks: Webhookの送信先とアラート。reports: 分析、エクスポート、監査ログ。branding: 検証フローのホワイトラベルブランディング。verification: 単独で使える検証API(本人確認書類、顔、AML、住所証明、電話番号、メールアドレス、データベース検証、法人確認)。travel_rule: トラベルルール(設定、VASPディレクトリ、ネットワーク、アドレス、送金、メッセージ)。marketplace: プロバイダーマーケットプレイス(カタログ、あなたの連携、連携リクエスト)。networks: 不正ネットワーク(同じデバイス、書類、連絡先を共有するリンク済みのセッション、ユーザー、企業)。compliance: コンプライアンスアシスタント(規制プロファイル、その要件、そこから生成されたワークフロー)。docs: Diditドキュメントの検索。all: あなたのロールが使えるすべてのツール。これがデフォルトです。
- ツールセットはオプトインです。
toolsetsのないURLでは、すべてのツールが一覧に表示されます。 - ツールセットを名指しすると、そのツールだけが一覧に表示されます。
?toolsets=casesでは、ケースのツールに加えて、すべての接続に含まれるdidit_context_getが一覧に表示されます。短いリストも残したい場合はcoreを追加してください。 - ツールセットが決めるのは一覧に表示されるものであり、実行できるものではありません。 選択外のツールも、モデルが名前で呼び出せば実行されます。その際の権限は従来どおりあなたのロールに従います。
- サーバーが知らない名前は無視されます。 接続は引き続き機能し、サーバーは無視された名前と有効な名前をモデルに伝えます。
- ロールは引き続き適用されます。 ツールセットが権限を与えることはありません。詳しくは役割と権限を参照してください。
読み取り専用モードで接続する
サーバーURLにread_only=trueを追加します:
read_onlyを付けずに接続します。
読み込まれていないツールへのアクセス
接続で読み込まれるのがカタログの一部だけの場合、サーバーは次の4つのツールを追加し、どのツールにもアクセスできるようにします。didit_tool_search(読み取り): 「セッションをCSVにエクスポート」のように、やりたいことからツールを検索します。または、1つのツールセットの一覧を表示します。各一致結果には、ツールの機能、パラメーター、データを読み取るか、書き込むか、破壊的な操作かが示されます。didit_tool_describe(読み取り): 最大5つのツールについて、完全な説明と入力スキーマを返します。didit_tool_call_read(読み取り): 一覧にない読み取り専用ツールを実行します。データを変更するツールは拒否されます。didit_tool_call_write(破壊的): データを作成、変更、削除する一覧にないツールを実行します。読み取り専用の接続では提供されません。
didit_tool_call_readまたはdidit_tool_call_writeを経由した呼び出しも、直接の呼び出しと同じように確認されます。役割の権限、読み取り専用モード、そしてすべてのconfirm: trueの要件が引き続き適用されます。
2つのツールを分けているのは、データを変更する前にお使いのクライアントが確認を求め、参照だけは通せるようにするためです。
coreが読み込まれている場合、「新しいチームメンバーを組織に招待する」というリクエストは次のように処理されます。
- モデルが
invite a teammateを指定してdidit_tool_searchを呼び出し、データの書き込みとしてマークされたdidit_org_invite_memberを取得します。 - モデルが
didit_org_invite_memberをnameとして渡し、そのツール自体の引数を添えてdidit_tool_call_writeを呼び出します。 - データを変更するツールと同様に、お使いのクライアントが呼び出しの承認を求めます。
クライアントでの設定
インストールガイドと同じ手順で進めますが、パラメーターをURLに追加します。- Claude Code
- Codex
- Cursor
- VS Code
- Claude(Web・デスクトップ)
- ローカルサーバー
? と & を自分で解釈してしまいます。X-MCP-Toolsets: core,workflows と X-MCP-Readonly: true を送信してください。
ツールセットについては、URLの値がヘッダーより優先されます。読み取り専用モードは、どちらか一方でも要求していれば有効になります。
ChatGPTプラグインは、
https://mcp.didit.me/mcp/chatgpt にある独自の固定された限定カタログを使用します。
ツールセットと読み取り専用モードは、このプラグインには適用されません。
ChatGPTを接続するを参照してください。プロンプト、インストラクション、ドキュメント検索
サーバーは、モデルが適切な位置から作業を始められるよう支援します。- インストラクション。 接続時、サーバーはモデルに対して、
didit_context_getから始めること、organization_idとapplication_idの解決方法、サンドボックスアプリケーションで構築すること、およびこの接続で読み込まれたツールセットを伝えます。 - プロンプト。 MCPプロンプトに対応するクライアントでは、5つの開始点が表示されます:
integrate_didit、review_queue、explain_session、build_workflow、verification_report。Claude Codeでは、これらがスラッシュコマンドとして表示されます。 - ドキュメント検索。
didit_docs_searchは、このドキュメントを検索し、一致したセクションをリンク付きで返します。そのため、Diditの仕組みに関する質問には、最新のページの内容に基づいて回答されます。
接続で読み込まれたツールの確認
クライアントに次のように尋ねます:featuresの下にtoolsetsとread_onlyが表示されます。
次のステップ
インストール
Claude、ChatGPT、Cursor、VS Code、Codex、または任意のMCPクライアントに接続します。
ツールリファレンス
すべてのツールについて、その種類と必要な役割の権限を説明します。
認証
Diditへのログイン、スコープ、役割の権限について説明します。
プロンプトの例
導入初日から使えるプロンプトです。