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. 正しく追加されたことを確認します：

qwen mcp list

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 と qwen mcp add による設定

どちらの方法でも、settings.json 内の mcpServers エントリは同じになります。お好みの方法をお使いください。

Stdio サーバー（ローカルプロセス）

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 でサーバーが「Disconnected」を表示する場合: 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 [options] <name> <commandOrUrl> [args...]

サーバーの一覧表示 (qwen mcp list)

qwen mcp list

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

qwen mcp remove <name>