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

# MCP サーバー

Qoder CLI は Model Context Protocol（MCP）サーバーに接続し、外部ツールやデータソースを利用できます。サーバーを追加すると、そのツールはインタラクティブセッションと非インタラクティブセッションで Agent から利用できるようになります。

## クイックスタート

`qodercli mcp add` で stdio MCP サーバーを追加します。`--` の後ろのコマンドは、Qoder CLI が起動するサーバープロセスです。

```shell theme={null}
qodercli mcp add playwright -- npx -y @playwright/mcp@latest
```

Stdio サーバーは CLI とともに自動起動します。Qoder CLI がすでに実行中の場合は `/mcp reload` を使って MCP サーバーとツールを再検出します。新しいセッションでは起動時に自動で検出されます。

## サーバータイプ

`-t` で MCP の transport type を選択します。

| Type    | Use when                                    |
| :------ | :------------------------------------------ |
| `stdio` | MCP サーバーをローカルコマンドとして実行する                    |
| `sse`   | MCP サーバーを Server-Sent Events エンドポイントとして公開する |
| `http`  | MCP サーバーを HTTP エンドポイントとして公開する               |
| `ws`    | MCP サーバーを WebSocket エンドポイントとして公開する          |

タイプを指定しない場合、ローカルコマンドサーバーは既定の stdio 動作を使います。

## スコープ

`-s` で MCP サーバー設定の保存先を選択します。

| Scope     | Use when                                |
| :-------- | :-------------------------------------- |
| `user`    | ローカルアカウントの全プロジェクトでサーバーを利用したい            |
| `local`   | 現在のプロジェクトだけで、かつ自分のマシン上でのみ利用したい。既定スコープです |
| `project` | サーバー設定をプロジェクトで共有したい                     |

MCP サーバー設定は以下のファイルに保存されます。

```md theme={null}
# ユーザーレベル設定。
~/.qoder/settings.json

# ローカルのプロジェクト固有設定。通常はコミットしません。
${project}/.qoder/settings.local.json

# プロジェクトレベル設定。通常はプロジェクトにコミットします。
${project}/.mcp.json
```

## サーバーの管理

設定済みサーバーを一覧表示：

```shell theme={null}
qodercli mcp list
```

サーバーを削除：

```shell theme={null}
qodercli mcp remove playwright
```

## 推奨サーバー

よく使われる MCP サーバー：

```shell theme={null}
qodercli mcp add context7 -- npx -y @upstash/context7-mcp@latest
qodercli mcp add deepwiki -- npx -y mcp-deepwiki@latest
qodercli mcp add chrome-devtools -- npx chrome-devtools-mcp@latest
```

## 権限

MCP ツールも Qoder CLI の権限システムを通ります。既定モードでは、MCP ツールの呼び出しは通常確認を求めます。特定のツール、1 つの MCP サーバー内の全ツール、または settings のルールで許可できます。

MCP ツール名は通常、次の形式です。

```text theme={null}
mcp__<server>__<tool>
```

例：

```json theme={null}
{
  "permissions": {
    "allow": [
      "mcp__context7__*"
    ],
    "deny": []
  }
}
```

## トラブルシューティング

MCP ツールが利用できない場合：

* `qodercli mcp list` を実行し、サーバーが設定されていることを確認します。
* Qoder CLI がすでに実行中の場合は、サーバー追加または変更後に `/mcp reload` を実行します。
* `--` の後ろのコマンドがターミナルで動作することを確認します。
* `npx` ベースのサーバーでは、Node.js とネットワークアクセスが利用可能であることを確認します。
* サーバーは接続されているのにツール呼び出しがブロックされる場合は、権限プロンプトを確認します。