メインコンテンツへスキップ

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.

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

​
クイックスタート

qodercli mcp add で stdio MCP サーバーを追加します。-- の後ろのコマンドは、Qoder CLI が起動するサーバープロセスです。 
qodercli mcp add playwright -- npx -y @playwright/mcp@latest
Stdio サーバーは CLI とともに自動起動します。Qoder CLI がすでに実行中の場合は /mcp reload を使って MCP サーバーとツールを再検出します。新しいセッションでは起動時に自動で検出されます。

​
サーバータイプ

-t で MCP の transport type を選択します。
TypeUse when
stdioMCP サーバーをローカルコマンドとして実行する
sseMCP サーバーを Server-Sent Events エンドポイントとして公開する
httpMCP サーバーを HTTP エンドポイントとして公開する
wsMCP サーバーを WebSocket エンドポイントとして公開する
タイプを指定しない場合、ローカルコマンドサーバーは既定の stdio 動作を使います。

​
スコープ

-s で MCP サーバー設定の保存先を選択します。
ScopeUse when
userローカルアカウントの全プロジェクトでサーバーを利用したい
local現在のプロジェクトだけで、かつ自分のマシン上でのみ利用したい。既定スコープです
projectサーバー設定をプロジェクトで共有したい
MCP サーバー設定は以下のファイルに保存されます。 
# ユーザーレベル設定。
~/.qoder/settings.json

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

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

​
サーバーの管理

設定済みサーバーを一覧表示： 
qodercli mcp list
サーバーを削除： 
qodercli mcp remove playwright

​
推奨サーバー

よく使われる MCP サーバー： 
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 ツール名は通常、次の形式です。 
mcp__<server>__<tool>
例： 
{
  "permissions": {
    "allow": [
      "mcp__context7__*"
    ],
    "deny": []
  }
}

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

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