メインコンテンツへスキップ
ツールセットを使うと、Didit MCP接続で全カタログではなく少数のツールの一覧だけを読み込めます。読み取り専用モードを使うと、データを決して変更できない接続になります。 どちらもサーバーURLに指定するパラメーターです:
パラメーターを指定しない場合、サーバーはご利用の役割で使用できるすべてのツールを一覧表示します。そのため、すでに利用している接続には変更がありません。

ツールを絞り込む理由

クライアントは、最初の質問の前に、一覧に含まれるすべてのツールの定義をモデルに送信します。 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が読み込まれている場合、「新しいチームメンバーを組織に招待する」というリクエストは次のように処理されます。
  1. モデルがinvite a teammateを指定してdidit_tool_searchを呼び出し、データの書き込みとしてマークされたdidit_org_invite_memberを取得します。
  2. モデルがdidit_org_invite_memberをnameとして渡し、そのツール自体の引数を添えてdidit_tool_call_writeを呼び出します。
  3. データを変更するツールと同様に、お使いのクライアントが呼び出しの承認を求めます。
すべてのツールが読み込まれている場合、検出すべきものは残っていないため、これら4つのツールは一覧に表示されません。

クライアントでの設定

インストールガイドと同じ手順で進めますが、パラメーターをURLに追加します。
引用符は必ず付けてください。付けないと、シェルが ? と & を自分で解釈してしまいます。
クライアントでヘッダーは設定できるがURLは編集できない場合は、代わりに 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へのログイン、スコープ、役割の権限について説明します。

プロンプトの例

導入初日から使えるプロンプトです。
最終更新日 2026年11月12日