> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Didit MCPツールセットと読み取り専用モード

> Diditのツールセットで必要なMCPツールだけを読み込み、読み取り専用モードで接続できます。ツール検索で他のツールも必要に応じて呼び出せます。

ツールセットを使うと、Didit MCP接続で全カタログではなく少数のツールの一覧だけを読み込めます。読み取り専用モードを使うと、データを決して変更できない接続になります。
どちらもサーバーURLに指定するパラメーターです：

```text theme={null}
https://mcp.didit.me/mcp?toolsets=core
https://mcp.didit.me/mcp?read_only=true
```

パラメーターを指定しない場合、サーバーはご利用の役割で使用できるすべてのツールを一覧表示します。そのため、すでに利用している接続には変更がありません。

## ツールを絞り込む理由

クライアントは、最初の質問の前に、一覧に含まれるすべてのツールの定義をモデルに送信します。
Didit のカタログ全体では、これだけでリクエストごとに数万トークンになり、モデルのトークナイザーによって約50,000～115,000トークンです。
クライアントによっては、受け付けるツールの数に上限を設けているものもあります。

| 接続で読み込まれるもの | 一覧に含まれるツール | それらのトークンの割合 |
| - | - | - |
| すべて（パラメーターなし） | 役割で使用できるすべてのツール | すべて |
| 短いリスト `core` | 約30 | 約10分の1 |
| 短いリスト、読み取り専用 | 約20 | 10分の1未満 |

トレードオフとして、ステップが1つ増えます。
一覧にないツールは失われるわけではありませんが、モデルはそれを実行する前に[ツール検索](#読み込まれていないツールへのアクセス)で見つける必要があります。すべてのツールを見ているモデルは、検索しなければならないモデルよりも適切なツールを少し高い頻度で選びます。
会話が多くの領域にまたがり、コンテキストのコストが問題にならない場合は、すべてを読み込んでください。
コンテキストのコストが問題になる場合は、`core` と、最もよく使うツールセットを読み込んでください。

## ツールセットを選ぶ

サーバーURLに、カンマ区切りのリストとして`toolsets`を追加します:

```text theme={null}
https://mcp.didit.me/mcp?toolsets=core
https://mcp.didit.me/mcp?toolsets=core,workflows
https://mcp.didit.me/mcp?toolsets=core,transactions,cases
```

`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`: あなたのロールが使えるすべてのツール。これがデフォルトです。

[ツールリファレンス](https://docs.didit.me/ja/integration/mcp/tools.md)には、すべてのツールが種類と必要なロール権限とともに載っています。

選択の動作は次のとおりです:

* **ツールセットはオプトインです。** `toolsets`のないURLでは、すべてのツールが一覧に表示されます。
* **ツールセットを名指しすると、そのツールだけが一覧に表示されます。** `?toolsets=cases`では、ケースのツールに加えて、すべての接続に含まれる`didit_context_get`が一覧に表示されます。短いリストも残したい場合は`core`を追加してください。
* **ツールセットが決めるのは一覧に表示されるものであり、実行できるものではありません。** 選択外のツールも、モデルが名前で呼び出せば実行されます。その際の権限は従来どおりあなたのロールに従います。
* **サーバーが知らない名前は無視されます。** 接続は引き続き機能し、サーバーは無視された名前と有効な名前をモデルに伝えます。
* **ロールは引き続き適用されます。** ツールセットが権限を与えることはありません。詳しくは[役割と権限](https://docs.didit.me/ja/integration/mcp/authentication.md#役割と権限)を参照してください。

## 読み取り専用モードで接続する

サーバーURLに`read_only=true`を追加します：

```text theme={null}
https://mcp.didit.me/mcp?read_only=true
https://mcp.didit.me/mcp?toolsets=core,reports&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つのツールは一覧に表示されません。

## クライアントでの設定

[インストールガイド](https://docs.didit.me/ja/integration/mcp/installation.md)と同じ手順で進めますが、パラメーターをURLに追加します。

> [tab] Claude Code
>
> ```bash theme={null}
> claude mcp add --transport http didit "https://mcp.didit.me/mcp?toolsets=core"
> ```
>
> 引用符は必ず付けてください。付けないと、シェルが `?` と `&` を自分で解釈してしまいます。

> [tab] Codex
>
> ```bash theme={null}
> codex mcp add didit --url "https://mcp.didit.me/mcp?toolsets=core"
> ```

> [tab] Cursor
>
> `~/.cursor/mcp.json` に次を記述します：
>
> ```json theme={null}
> {
>   "mcpServers": {
>     "didit": {
>       "url": "https://mcp.didit.me/mcp?toolsets=core"
>     }
>   }
> }
> ```

> [tab] VS Code
>
> `.vscode/mcp.json` に次を記述します：
>
> ```json theme={null}
> {
>   "servers": {
>     "didit": {
>       "type": "http",
>       "url": "https://mcp.didit.me/mcp?toolsets=core"
>     }
>   }
> }
> ```

> [tab] Claude（Web・デスクトップ）
>
> **Settings**を開き、**Connectors**、**Add custom connector**の順に選択して、パラメーター付きのURLを貼り付けます：
>
> ```text theme={null}
> https://mcp.didit.me/mcp?toolsets=core
> ```

> [tab] ローカルサーバー
>
> ローカルサーバーは、フラグまたは環境変数を受け付けます：
>
> ```bash theme={null}
> npx -y @didit-protocol/mcp-server --toolsets=core,workflows --read-only
> ```
>
> ```bash theme={null}
> DIDIT_TOOLSETS=core,workflows DIDIT_READ_ONLY=true npx -y @didit-protocol/mcp-server
> ```

クライアントでヘッダーは設定できるがURLは編集できない場合は、代わりに `X-MCP-Toolsets: core,workflows` と `X-MCP-Readonly: true` を送信してください。
ツールセットについては、URLの値がヘッダーより優先されます。読み取り専用モードは、どちらか一方でも要求していれば有効になります。

> [!NOTE]
>
> ChatGPTプラグインは、`https://mcp.didit.me/mcp/chatgpt` にある独自の固定された限定カタログを使用します。
> ツールセットと読み取り専用モードは、このプラグインには適用されません。
> [ChatGPTを接続する](https://docs.didit.me/ja/integration/mcp/chatgpt.md)を参照してください。

## プロンプト、インストラクション、ドキュメント検索

サーバーは、モデルが適切な位置から作業を始められるよう支援します。

* **インストラクション。** 接続時、サーバーはモデルに対して、`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の仕組みに関する質問には、最新のページの内容に基づいて回答されます。

## 接続で読み込まれたツールの確認

クライアントに次のように尋ねます：

```text theme={null}
Which Didit toolsets does this connection load, and is it read-only?
```

モデルは、サーバーのインストラクションに基づいて回答します。
ツールセットに対応しているかどうかを利用前に確認するには、サーバーのヘルスエンドポイントを読み取ってください：

```bash theme={null}
curl https://mcp.didit.me/healthz
```

レスポンスには、`features`の下に`toolsets`と`read_only`が表示されます。

## 次のステップ

> [card] [インストール](https://docs.didit.me/ja/integration/mcp/installation.md)
>
> Claude、ChatGPT、Cursor、VS Code、Codex、または任意のMCPクライアントに接続します。

> [card] [ツールリファレンス](https://docs.didit.me/ja/integration/mcp/tools.md)
>
> すべてのツールについて、その種類と必要な役割の権限を説明します。

> [card] [認証](https://docs.didit.me/ja/integration/mcp/authentication.md)
>
> Diditへのログイン、スコープ、役割の権限について説明します。

> [card] [プロンプトの例](https://docs.didit.me/ja/integration/mcp/examples.md)
>
> 導入初日から使えるプロンプトです。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.