MCP サーバー

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

クイックスタート

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

qoder 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 動作を使います。 Shell コマンドプレフィックスが有効な場合、Qoder CLI は stdio サーバーを設定済みの実行可能な wrapper 経由で起動します。wrapper は、元のサーバー実行ファイルと引数を shell 向けにクォートした 1 つの引数として受け取り、stdio と終了ステータスを維持して実行する必要があります。設定値には単一の実行可能ファイルパスを指定してください。この設定は sse、http、ws サーバーには影響しません。

スコープ

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

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

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

# ユーザーレベル設定。
~/.qoder/settings.json

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

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

サーバーの管理

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

qoder mcp list

サーバーを削除：

qoder mcp remove playwright

推奨サーバー

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

qoder mcp add context7 -- npx -y @upstash/context7-mcp@latest
qoder mcp add deepwiki -- npx -y mcp-deepwiki@latest
qoder mcp add chrome-devtools -- npx chrome-devtools-mcp@latest

権限

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

mcp__<server>__<tool>

例：

{
  "permissions": {
    "allow": [
      "mcp__context7__*"
    ],
    "deny": []
  }
}

トラブルシューティング

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

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

​クイックスタート

​サーバータイプ

​スコープ

​サーバーの管理

​推奨サーバー

​権限