3行でいうと

  • Qwen Code は、接続先として QwenCloud、Alibaba ModelStudio、第三者の提供元、自分で立てたローカルのサーバー（Custom Provider）を選べます。選ぶ画面は /auth、設定ファイルは settings.json です。
  • 外部のMCPサーバーには、qwen mcp add か settings.json でつなげます。接続方式は http、sse、stdio の3つで、公式のページは http を recommended と表記しています。
  • MCP の trust: true は確認を省く設定です。信頼するフォルダの中だけで効きます。OAuth のトークンは、既定では暗号化されずにローカルのファイルに入る、と公式にあります。
  • VS Code の拡張と JetBrains（ACP）は、CLI の設定を共有する形です。VS Code の必要バージョンは、公式ページ同士で書き方が違います。
  • 外し方（接続の解除）は、ページに明記がないものが多いです。この記事は、記載があるものだけを「公式の記載」と書き、ないものは「記載が見つからない」と書きます。

この記事は、公式の資料を2026年10月25日に読んでまとめたものです。この記事は、実際に使って確かめた記録ではありません。運営者はQwenを入れていますが、使い心地はこの記事には書いていません。設定例は、「公式の例の写し」か、「公式の記載に合わせて、この記事で組んだ例（動作は確かめていません）」のどちらかを、そのつど書き分けています。公式の例は、取得が要約を通した形なので、記号や改行が崩れている可能性があります。システムへの登録や権限に関わる操作は、公式ページの原文を見て写してください。画面の表記は変わります。手元の画面と照らして読んでください。

先に結論

前提：用語をそろえる

見取り図（Qwen Code の部分）

組み合わせ 呼ぶ側 → 呼ばれる側 渡るデータ（公式の記載の範囲） 公式のページ
Qwen Code × QwenCloud ほか Qwen Code → 選んだ接続先 プロンプト、コード、応答が、選んだ提供元へ。Qwen Code 自体は、それを学習に使わない、と公式の文書にある Qwen Code の認証・QwenCloud の接続ページ
Qwen Code × 外部のMCPサーバー Qwen Code → MCPサーバー ツールの呼び出しの内容が、サーバーへ。OAuth のトークンはローカルのファイルへ Qwen Code の MCP のページ
ローカルのQwen × Qwen Code Qwen Code → 手元のサーバー 手元の環境の中。サーバーの設定による Qwen3.8 の README、モデルカード
Qwen Code × エディタ VS Code・JetBrains ⇔ Qwen Code CLI の設定を共有 QwenCloud と Qwen Code のページ

接続先のURLとキーの組み合わせは、その2（08）の表にまとめています。Qwen Code で QwenCloud につなぐときも、キーの種類（従量課金か Token Plan か）とURLを合わせます。

1. Qwen Code の接続先を選ぶ

Qwen Code 自身は、接続先を選ぶ側です。05の手順3で /auth を実行すると、QwenCloud、Alibaba ModelStudio、Third-party Providers、Custom Provider の4つが出ます。

設定する場所

書く内容

接続先は、modelProviders の下に、プロトコルごとに書きます。公式の Authentication のページに、次の表があります。

プロトコル modelProviders のキー 環境変数
OpenAI互換 openai OPENAI_API_KEY、OPENAI_BASE_URL、OPENAI_MODEL（別名 QWEN_MODEL）
Anthropic anthropic ANTHROPIC_API_KEY、ANTHROPIC_BASE_URL、ANTHROPIC_MODEL
Google GenAI gemini GEMINI_API_KEY、GEMINI_MODEL
Vertex AI vertex-ai GOOGLE_API_KEY と GOOGLE_MODEL、または GOOGLE_CLOUD_PROJECT と GOOGLE_MODEL（キーなしの ADC）

各項目には、id（必須）、wireApi（chat-completions か responses）、name、envKey、baseUrl、generationConfig が書けます。公式の注意として、QWENCLOUD_API_KEY のような提供元別の環境変数は、settings.json の提供元の項目が envKey として宣言して初めて使えます。OpenAI互換の認証を環境変数だけで済ませるなら、OPENAI_API_KEY を export します。

QwenCloud の従量課金の例は05に写しました。Token Plan と第三者の提供元（DeepSeek、Kimi、OpenRouter など）は、/auth の画面から選べます。

ローカルのサーバーにつなぐ（この記事の案）

README は、Qwen Code が Ollama や vLLM 経由のローカルのモデルに対応する、と書き、/auth の Custom Provider が「ローカルのサーバー」を挙げています。ただし、ローカルのサーバー用の settings.json の例は、読んだページに見つかりませんでした。次は、上の公式の項目名に合わせて、この記事で組んだ案です（動作は確かめていません）。05の手順1で立てた vLLM（http://localhost:8000/v1）を想定しています。

{
  "modelProviders": {
    "openai": [
      {
        "id": "Qwen/Qwen3.8-27B",
        "name": "[local] Qwen3.8-27B",
        "baseUrl": "http://localhost:8000/v1",
        "envKey": "LOCAL_LLM_API_KEY"
      }
    ]
  },
  "env": {
    "LOCAL_LLM_API_KEY": "dummy"
  },
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  },
  "model": {
    "name": "Qwen/Qwen3.8-27B"
  }
}

渡るデータ

外し方

うまくいかないとき

症状 確認すること（公式の記載）
認証の失敗（終了コード41） /auth をやり直す。/doctor で確かめる
設定の誤り（終了コード52） settings.json の書き方
画面が出ない security.auth.selectedType を消して再起動
モデルが選べない model.name が modelProviders のどれかの id と一致しているか。モデルを足したら再起動

2. Qwen Code から外部のMCPサーバーを呼ぶ

設定する場所

書く内容（公式の例）

接続の方法は3種類あります。

方式 使う場面 JSON の項目
http 遠隔のサービス（公式が recommended と表記） httpUrl、headers（任意）
sse SSEだけに対応する古いサーバー（公式は legacy/deprecated と表記） url、headers（任意）
stdio 自分のマシンで動くプロセス command、args、cwd、env（任意）

HTTP の例（公式の例の写し）：

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

コマンドで足す例（公式の例の写し）：

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

渡るデータと権限

外し方

うまくいかないとき

症状 確認すること（公式の記載）
qwen mcp list で「Disconnected」 URLかコマンドを確かめ、timeout を増やす
stdio のサーバーが起動しない command を絶対パスにする。cwd と env を確かめる
環境変数が展開されない Qwen Code を動かす環境で、その変数が設定されているか

3. Qwen Code とエディタ（VS Code、JetBrains）

VS Code

JetBrains

{
  "agent_servers": {
    "qwen": {
      "command": "/path/to/qwen",
      "args": ["--acp"],
      "env": {}
    }
  }
}

気をつけること

出典