> ## 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インストール: Claude, Cursor, VS Code, Windsurf

> ホスト型のDidit MCPサーバーをClaude、Cursor、VS Code、Windsurf、Zedなど任意のMCPクライアントに設定できます。オープンソース版のセルフホストも可能です。APIキーは不要です。

使用するクライアントを以下から選択してください。**ホスト型**サーバー(`https://mcp.didit.me/mcp`)ではAPIキーは不要です。初回接続時にクライアントがブラウザを開くので、**[Didit でログイン](https://docs.didit.me/ja/integration/mcp/authentication.md)**して権限を承認します。

> [!TIP]
>
> **Claudeをお使いですか。** [Claudeを接続](https://docs.didit.me/ja/integration/mcp/claude.md)ページには、名前とURLが入力済みの**Add custom connector**ダイアログを開くワンクリックのコネクターリンクがあります。確認してサインインするだけで完了します。

> [!NOTE]
>
> リモート/HTTP MCPにまだ対応していないクライアント(Windsurf、Zed)は、`mcp-remote`ブリッジを介して接続します。このブリッジはstdioをホスト型URLに転送し、OAuthハンドシェイクを代わりに処理します。

***

## ホスト型サーバー (推奨)

> [tab] Claude Code
>
> CLIでサーバーを追加し、サインインを開始します。
>
> ```bash theme={null}
> claude mcp add --transport http didit https://mcp.didit.me/mcp
> ```
>
> Claude Codeを起動して`/mcp`を実行すると、ブラウザで**Didit でログイン**画面が開きます。承認すると、`didit`ツールが利用可能になります。

> [tab] Claude Web版とDesktop版
>
> Web版: [**Add Didit to Claude →**](https://claude.ai/customize/connectors?modal=add-custom-connector\&connectorName=Didit\&connectorUrl=https://mcp.didit.me/mcp)をクリックし、入力済みのダイアログを確認します。
>
> Desktop版: **Settings → Connectors → Add custom connector**を開き、名前を`Didit`にして、URLを次のように設定します。
>
> ```text theme={null}
> https://mcp.didit.me/mcp
> ```
>
> **Connect**をクリックし、ブラウザで**Didit でログイン**を完了します。その後、チャットのツールメニューにDiditのツールが表示されます。

> [tab] Cursor
>
> `~/.cursor/mcp.json`(グローバル)または`.cursor/mcp.json`(プロジェクト単位)に追加します。
>
> ```json theme={null}
> {
>   "mcpServers": {
>     "didit": {
>       "url": "https://mcp.didit.me/mcp"
>     }
>   }
> }
> ```
>
> または、**Settings → Tools & Integrations → New MCP Server**を使用します。CursorはDynamic Client RegistrationによってDiditに自身を登録し、初回使用時にサインイン用のブラウザを開きます。

> [tab] VS Code
>
> GitHub Copilotのエージェントモードでは、`.vscode/mcp.json`を追加します。
>
> ```json theme={null}
> {
>   "servers": {
>     "didit": {
>       "type": "http",
>       "url": "https://mcp.didit.me/mcp"
>     }
>   }
> }
> ```
>
> または、コマンドパレットから**MCP: Add Server**を実行し、**HTTP**を選択します。求められたらサインインします。VS Codeには完全な`/mcp`URLを指定してください。サーバーはそのパスに対してOAuthリソースメタデータを公開しています。

> [tab] Windsurf
>
> Windsurfは`mcp-remote`ブリッジを介して接続します。`~/.codeium/windsurf/mcp_config.json`に追加します。
>
> ```json theme={null}
> {
>   "mcpServers": {
>     "didit": {
>       "command": "npx",
>       "args": ["-y", "mcp-remote@latest", "https://mcp.didit.me/mcp"]
>     }
>   }
> }
> ```
>
> **Settings → Cascade → MCP Servers → Manage**を開いて読み込まれたことを確認し、ブラウザでサインインします。

> [tab] Zed
>
> Zedの`settings.json`にコンテキストサーバーを追加します。
>
> ```json theme={null}
> {
>   "context_servers": {
>     "didit": {
>       "source": "custom",
>       "command": "npx",
>       "args": ["-y", "mcp-remote@latest", "https://mcp.didit.me/mcp"]
>     }
>   }
> }
> ```
>
> Zedがブリッジを起動し、ブラウザで**Didit でログイン**画面を開きます。

> [tab] その他のクライアント
>
> **OAuth 2.1**を使用した**Streamable HTTP**経由のMCPを実装しているクライアントであれば、`https://mcp.didit.me/mcp`に直接接続できます。クライアントは`https://mcp.didit.me/.well-known/oauth-protected-resource/mcp`から認可サーバーを検出し、Dynamic Client Registrationで自身を登録して、PKCEフローを実行します。サーバーは`/mcp`に対して`POST`のみを受け付けます。`GET`と`DELETE`には`405`を返します。これはサーバーがステートレスで、サーバー起点のストリームを保持しないためです。
>
> stdioにしか対応していないクライアントは、WindsurfやZedと同じ`mcp-remote`ブリッジを使用できます。
>
> ```bash theme={null}
> npx -y mcp-remote@latest https://mcp.didit.me/mcp
> ```
>
> クライアントなしでサーバーを試すには、[MCP Inspector](https://modelcontextprotocol.io/docs/tools/inspector)で同じURLに接続すると、サインインの手順を案内してくれます。

> [!NOTE]
>
> **設定にAPIキーは含めません。** ホスト型サーバーはブラウザであなたを認証し、**あなた**として動作します。つまり、あなたが所属するすべての組織に、あなたの役割の権限でアクセスします。[認証](https://docs.didit.me/ja/integration/mcp/authentication.md)を参照してください。

ホスト型サーバーは`GET https://mcp.didit.me/healthz`に対してバージョンを返します。

***

## 接続を確認する

サインイン後、クライアントに次のように尋ねます。

```text theme={null}
Use the Didit MCP server to call didit_context_get and list my organizations and applications.
```

エージェントは`didit_context_get`を呼び出し、あなたの組織とそのアプリケーションを表示するはずです。
Diditのツールがないと応答した場合は、サーバーに接続されていないか、サインインが完了していません。[トラブルシューティング](https://docs.didit.me/ja/integration/mcp/advanced.md#トラブルシューティング)を参照してください。

## セルフホスティング

ホスト型サーバーは、オープンソースのリポジトリ[github.com/didit-protocol/mcp](https://github.com/didit-protocol/mcp)(MIT)からビルドされています。各リリースはnpmにも[`@didit-protocol/mcp-server`](https://www.npmjs.com/package/@didit-protocol/mcp-server)として公開されているため、stdioサーバーをnpmから直接実行することも、クローンからどちらのエントリーポイントもビルドすることもできます。1つのコードベースから2つのエントリーポイントが提供されます。

| エントリーポイント | モード | トランスポート | 認証 |
| - | - | - | - |
| `dist/http.js` | ホスト型 | `MCP_PORT`(デフォルトは3000)上のStreamable HTTP、`POST /mcp`、`GET /healthz` | OAuth 2.1 Bearer、トークンイントロスペクションで検証 |
| `dist/index.js` | stdio(ヘッドレス) | MCP stdio | `DIDIT_ACCESS_TOKEN`に設定したユーザーアクセストークン |

どちらのモードもDiditの**ユーザー**として動作します。アプリケーションのAPIキーで動作するモードはありません。

**1. クローンしてビルドする**

```bash theme={null}
git clone https://github.com/didit-protocol/mcp.git && cd mcp
npm install && npm run build
```

または、コンテナをビルドします: `docker build -t didit-mcp .`。このイメージは`dist/http.js`を非rootユーザーとして実行し、ポート3000を公開し、`/healthz`でヘルスチェックを行います。

**2. HTTPサーバーを実行する(OAuth)**

`.env.example`を`.env`にコピーしてホスト型モードの値を入力し、次を実行します。

```bash theme={null}
node dist/http.js
# or
docker run -p 3000:3000 --env-file .env didit-mcp
```

このサーバーはOAuthリソースサーバーとしてのみ動作します。`MCP_RESOURCE_URI`には、オリジンだけではなくトランスポートの完全な公開URL(例: `https://mcp.example.com/mcp`)を設定する必要があります。また、Didit認可サーバーに対してトークンをイントロスペクトするための認証情報(`MCP_OAUTH_CLIENT_ID`、`MCP_OAUTH_CLIENT_SECRET`)も必要です。変数の一覧は[詳細設定 → セルフホスティング](https://docs.didit.me/ja/integration/mcp/advanced.md#セルフホスティング)を参照してください。

**3. またはstdioで実行する(ヘッドレス)**

OAuthフローを実行できないローカルエージェントの場合は、公開パッケージを実行し(クローンは不要です)、環境変数でユーザーアクセストークンを渡します。

```bash theme={null}
DIDIT_ACCESS_TOKEN=<user-access-token> npx -y @didit-protocol/mcp-server
```

クローンからは、`DIDIT_ACCESS_TOKEN=<user-access-token> node dist/index.js`で同じことができます。トークンがない場合、エージェントは`didit_account_login`でサインインでき、アカウントで二要素認証が有効な場合は続けて`didit_account_verify_2fa`を実行します。

任意の`MCP_DEFAULT_ORG`と`MCP_DEFAULT_APP`を使うと、シングルテナント構成でスコープを固定できます。Claude Codeには次のコマンドで登録します。

```bash theme={null}
claude mcp add didit-local -e DIDIT_ACCESS_TOKEN=<user-access-token> -- npx -y @didit-protocol/mcp-server
```

Cursorの場合は`mcp.json`に登録します。

```json theme={null}
{
  "mcpServers": {
    "didit-local": {
      "command": "npx",
      "args": ["-y", "@didit-protocol/mcp-server"],
      "env": { "DIDIT_ACCESS_TOKEN": "<user-access-token>" }
    }
  }
}
```

オープンソースのstdioサーバーには、ホスト型サーバーが提供するトラベルルール、マーケットプレイス、不正ネットワーク、取引SDKトークンの各ツールと、ワークフロー構築以外のコンプライアンスツールは含まれていません。
その代わりに、`didit_org_top_up`、`didit_org_reveal_application_api_key`と、5つのアカウント設定ツール(`didit_account_register`、`didit_account_verify_email`、`didit_account_resend_otp`、`didit_account_login`、`didit_account_verify_2fa`)が追加されています。これらは認証情報を引数として受け取るため、リモートコネクターでは提供されることはありません。また、stdioではサーバーがお使いのファイルシステムを共有するため、ファイルを受け取るツールは`*_path`引数も受け付けます。

***

## 次のステップ

> [card] [認証](https://docs.didit.me/ja/integration/mcp/authentication.md)
>
> サインイン、スコープ、役割。

> [card] [ツールリファレンス](https://docs.didit.me/ja/integration/mcp/tools.md)
>
> エージェントが呼び出せるすべてのツール。


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