MCP を介して Qwen Code をツールに接続する

Qwen Code は、Model Context Protocol (MCP)  を通じて外部ツールおよびデータソースに接続できます。MCP サーバーを設定することで、Qwen Code はユーザーのツール、データベース、API にアクセスできるようになります。

MCP を使ってできること

MCP サーバーを接続すると、Qwen Code に対して以下のようなタスクを指示できます：

• ファイルおよびリポジトリの操作（読み取り／検索／書き込み — 有効化したツールによって機能が異なります）
• データベースへのクエリ実行（スキーマの確認、クエリ実行、レポート生成）
• 内部サービスとの統合（自社 API を MCP ツールとしてラップ）
• ワークフローの自動化（ツールまたはプロンプトとして公開された反復可能なタスク）

クイックスタート

Qwen Code は settings.json の mcpServers 設定から MCP サーバーを読み込みます。サーバーの設定は以下のいずれかの方法で行えます：

• settings.json を直接編集
• qwen mcp コマンドを使用（CLI リファレンス を参照）

最初のサーバーを追加する

1. サーバーを追加します（例：リモート HTTP MCP サーバー）：

qwen mcp add --transport http my-server http://localhost:3000/mcp

2. MCP 管理ダイアログを開き、サーバーを表示および管理します：

qwen mcp

3. 同じプロジェクトで Qwen Code を再起動します（または、まだ実行されていない場合は起動します）。その後、モデルにそのサーバーからツールを使用するよう指示します。

設定の保存場所（スコープ）

ほとんどのユーザーは以下の 2 つのスコープのみを必要とします：

• プロジェクトスコープ（デフォルト）: プロジェクトのルートディレクトリにある .qwen/settings.json
• ユーザースコープ: マシン上のすべてのプロジェクトにわたって有効な ~/.qwen/settings.json

ユーザースコープに書き込むには：

qwen mcp add --scope user --transport http my-server http://localhost:3000/mcp

サーバーの設定

トランスポートの選択

settings.json による設定 vs qwen mcp add コマンドによる設定

どちらの方法でも、最終的に settings.json 内に同じ mcpServers エントリが生成されます。お好みの方をお使いください。

標準入出力サーバー（ローカルプロセス）

JSON（.qwen/settings.json）:

{
  "mcpServers": {
    "pythonTools": {
      "command": "python",
      "args": ["-m", "my_mcp_server", "--port", "8080"],
      "cwd": "./mcp-servers/python",
      "env": {
        "DATABASE_URL": "$DB_CONNECTION_STRING",
        "API_KEY": "${EXTERNAL_API_KEY}"
      },
      "timeout": 15000
    }
  }
}

CLI（デフォルトではプロジェクトスコープに書き込みます）:

qwen mcp add pythonTools -e DATABASE_URL=$DB_CONNECTION_STRING -e API_KEY=$EXTERNAL_API_KEY \
  --timeout 15000 python -m my_mcp_server --port 8080

HTTP サーバー（リモートでストリーミング可能な HTTP）

JSON:

{
  "mcpServers": {
    "httpServerWithAuth": {
      "httpUrl": "http://localhost:3000/mcp",
      "headers": {
        "Authorization": "Bearer your-api-token"
      },
      "timeout": 5000
    }
  }
}

CLI:

qwen mcp add --transport http httpServerWithAuth http://localhost:3000/mcp \
  --header "Authorization: Bearer your-api-token" --timeout 5000

SSE サーバー（リモートの Server-Sent Events）

JSON:

{
  "mcpServers": {
    "sseServer": {
      "url": "http://localhost:8080/sse",
      "timeout": 30000
    }
  }
}

CLI:

qwen mcp add --transport sse sseServer http://localhost:8080/sse --timeout 30000

セキュリティと制御

信頼（確認プロンプトをスキップ）

• サーバーの信頼 (trust: true)：そのサーバーに対する確認プロンプトをバイパスします（慎重に使用してください）。

ツールのフィルタリング（サーバーごとのツールの許可／拒否）

includeTools／excludeTools を使用して、サーバーが公開するツールを制限します（Qwen Code の視点から）。

例：特定の少数のツールのみを許可する場合：

{
  "mcpServers": {
    "filteredServer": {
      "command": "python",
      "args": ["-m", "my_mcp_server"],
      "includeTools": ["safe_tool", "file_reader", "data_processor"],
      "timeout": 30000
    }
  }
}

グローバルな許可／拒否リスト

settings.json 内の mcp オブジェクトは、すべての MCP サーバーに適用されるグローバルなルールを定義します。

• mcp.allowed: 許可する MCP サーバー名のリスト（mcpServers 内のキー）
• mcp.excluded: 拒否する MCP サーバー名のリスト

例：

{
  "mcp": {
    "allowed": ["my-trusted-server"],
    "excluded": ["experimental-server"]
  }
}

トラブルシューティング

• qwen mcp list でサーバーが「切断済み」と表示される: URL/コマンドが正しいか確認し、その後 timeout を増加させます。
• Stdio サーバーが起動しない: command には絶対パスを使用し、cwd および env を再確認します。
• JSON 内の環境変数が解決されない: 環境変数が Qwen Code が実行される環境（シェルと GUI アプリケーションの環境では異なる場合があります）に存在することを確認します。

参照

settings.json の構造

サーバー固有の設定（mcpServers）

settings.json ファイルに mcpServers オブジェクトを追加します：

// ... 他の設定オブジェクトを含むファイル
{
  "mcpServers": {
    "serverName": {
      "command": "path/to/server",
      "args": ["--arg1", "value1"],
      "env": {
        "API_KEY": "$MY_API_TOKEN"
      },
      "cwd": "./server-directory",
      "timeout": 30000,
      "trust": false
    }
  }
}

設定プロパティ：

必須（以下のいずれか 1 つ）：

任意：

qwen mcp を使用して MCP サーバーを管理する

MCP サーバーは常に settings.json を手動で編集することで設定できますが、CLI を使用する方が通常は速いです。

サーバーの追加 (qwen mcp add)

qwen mcp add [オプション] <名前> <コマンドまたはURL> [引数...]

サーバーの削除 (qwen mcp remove)

qwen mcp remove <name>