Connect Qwen Code to tools via MCP

Qwen Code kann über das Model Context Protocol (MCP)  mit externen Tools und Datenquellen verbunden werden. MCP-Server gewähren Qwen Code Zugriff auf deine Tools, Datenbanken und APIs.

What you can do with MCP

Mit verbundenen MCP-Servern kannst du Qwen Code bitten:

• Mit Dateien und Repos zu arbeiten (lesen/suchen/schreiben, abhängig von den aktivierten Tools)
• Datenbanken abzufragen (Schema-Inspektion, Queries, Reporting)
• Interne Dienste zu integrieren (deine APIs als MCP-Tools kapseln)
• Workflows zu automatisieren (wiederkehrende Aufgaben als Tools/Prompts bereitstellen)

Quick start

Qwen Code lädt MCP-Server aus mcpServers in deiner settings.json. Du kannst Server auf zwei Arten konfigurieren:

• Durch direktes Bearbeiten von settings.json
• Durch Verwendung von qwen mcp-Befehlen (siehe CLI-Referenz)

Add your first server

1. Füge einen Server hinzu (Beispiel: entfernter HTTP-MCP-Server):

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

2. Öffne den MCP-Verwaltungsdialog, um Server anzuzeigen und zu verwalten:

qwen mcp

3. Starte Qwen Code im selben Projekt neu (oder starte es, falls es noch nicht läuft) und fordere das Modell dann auf, Tools von diesem Server zu verwenden.

Where configuration is stored (scopes)

Die meisten Nutzer benötigen nur diese beiden Scopes:

• Projekt-Scope (Standard): .qwen/settings.json im Projektstammverzeichnis
• User-Scope: ~/.qwen/settings.json für alle Projekte auf deinem Rechner

In den User-Scope schreiben:

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

Configure servers

Choose a transport

Configure via settings.json vs qwen mcp add

Beide Ansätze erzeugen dieselben mcpServers-Einträge in deiner settings.json – verwende die Methode, die dir besser gefällt.

Stdio server (local process)

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 (schreibt standardmäßig in den Projekt-Scope):

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 server (remote streamable 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 (remote 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

Safety and control

Trust (skip confirmations)

• Server-Vertrauen (trust: true): Umgeht Bestätigungsabfragen für diesen Server (sparsam verwenden).

Tool filtering (allow/deny tools per server)

Verwende includeTools / excludeTools, um die von einem Server bereitgestellten Tools einzuschränken (aus Sicht von Qwen Code).

Beispiel: Nur wenige Tools einbeziehen:

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

Global allow/deny lists

Das mcp-Objekt in deiner settings.json definiert globale Regeln für alle MCP-Server:

• mcp.allowed: Allow-Liste von MCP-Servernamen (Schlüssel in mcpServers)
• mcp.excluded: Deny-Liste von MCP-Servernamen

Beispiel:

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

Troubleshooting

• Server zeigt „Disconnected“ in qwen mcp list an: Überprüfe, ob die URL/der Befehl korrekt ist, und erhöhe dann timeout.
• Stdio-Server startet nicht: Verwende einen absoluten command-Pfad und überprüfe cwd/env erneut.
• Umgebungsvariablen in JSON werden nicht aufgelöst: Stelle sicher, dass sie in der Umgebung existieren, in der Qwen Code ausgeführt wird (Shell- und GUI-App-Umgebungen können sich unterscheiden).

Reference

settings.json structure

Server-specific configuration (mcpServers)

Füge deiner settings.json-Datei ein mcpServers-Objekt hinzu:

// ... file contains other config objects
{
  "mcpServers": {
    "serverName": {
      "command": "path/to/server",
      "args": ["--arg1", "value1"],
      "env": {
        "API_KEY": "$MY_API_TOKEN"
      },
      "cwd": "./server-directory",
      "timeout": 30000,
      "trust": false
    }
  }
}

Konfigurationseigenschaften:

Erforderlich (eine der folgenden):

Optional:

Manage MCP servers with qwen mcp

Du kannst MCP-Server immer durch manuelles Bearbeiten von settings.json konfigurieren, aber die CLI ist in der Regel schneller.

Adding a server (qwen mcp add)

qwen mcp add [options] <name> <commandOrUrl> [args...]

Removing a server (qwen mcp remove)

qwen mcp remove <name>