Connecter Qwen Code aux outils via MCP

Qwen Code peut se connecter à des outils externes et des sources de données via le Model Context Protocol (MCP) . Les serveurs MCP donnent à Qwen Code l’accès à vos outils, bases de données et API.

Ce que vous pouvez faire avec MCP

Avec les serveurs MCP connectés, vous pouvez demander à Qwen Code de :

• Travailler avec des fichiers et des dépôts (lire/rechercher/écrire, selon les outils activés)
• Interroger des bases de données (inspection du schéma, requêtes, rapports)
• Intégrer des services internes (encapsuler vos API en tant qu’outils MCP)
• Automatiser des workflows (tâches reproductibles exposées sous forme d’outils/prompts)

Démarrage rapide

Qwen Code charge les serveurs MCP depuis mcpServers dans votre fichier settings.json. Vous pouvez configurer les serveurs soit :

• En modifiant directement le fichier settings.json
• En utilisant les commandes qwen mcp (voir Référence CLI)

Ajouter votre premier serveur

1. Ajoutez un serveur (exemple : serveur MCP HTTP distant) :

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

2. Vérifiez qu’il apparaît :

qwen mcp list

3. Redémarrez Qwen Code dans le même projet (ou démarrez-le s’il ne tournait pas encore), puis demandez au modèle d’utiliser des outils provenant de ce serveur.

Emplacement de stockage de la configuration (portées)

La plupart des utilisateurs n’ont besoin que de ces deux portées :

• Portée projet (par défaut) : .qwen/settings.json à la racine de votre projet
• Portée utilisateur : ~/.qwen/settings.json pour tous les projets sur votre machine

Écrire dans la portée utilisateur :

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

Configurer les serveurs

Choisir un transport

Configuration via settings.json ou qwen mcp add

Les deux approches produisent les mêmes entrées mcpServers dans votre fichier settings.json — utilisez celle que vous préférez.

Serveur Stdio (processus local)

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 (écrit dans la portée du projet par défaut) :

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

Serveur HTTP (flux HTTP distant)

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

Serveur SSE (Server-Sent Events distant)

JSON :

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

CLI :

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

Sécurité et contrôle

Confiance (ignorer les confirmations)

• Confiance du serveur (trust: true) : contourne les invites de confirmation pour ce serveur (à utiliser avec parcimonie).

Filtrage des outils (autoriser/refuser des outils par serveur)

Utilisez includeTools / excludeTools pour restreindre les outils exposés par un serveur (du point de vue de Qwen Code).

Exemple : inclure uniquement quelques outils :

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

Listes globales d’autorisation/refus

L’objet mcp dans votre settings.json définit des règles globales pour tous les serveurs MCP :

• mcp.allowed : liste d’autorisation des noms de serveurs MCP (clés dans mcpServers)
• mcp.excluded : liste de refus des noms de serveurs MCP

Exemple :

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

Dépannage

• Le serveur affiche « Disconnected » dans qwen mcp list : vérifiez que l’URL/la commande est correcte, puis augmentez le timeout.
• Le serveur stdio ne démarre pas : utilisez un chemin absolu pour command, et vérifiez soigneusement cwd/env.
• Les variables d’environnement dans le JSON ne se résolvent pas : assurez-vous qu’elles existent dans l’environnement où Qwen Code s’exécute (les environnements shell et application graphique peuvent différer).

Référence

Structure de settings.json

Configuration spécifique au serveur (mcpServers)

Ajoutez un objet mcpServers à votre fichier settings.json :

// ... le fichier contient d'autres objets de configuration
{
  "mcpServers": {
    "serverName": {
      "command": "chemin/vers/le/serveur",
      "args": ["--arg1", "valeur1"],
      "env": {
        "API_KEY": "$MY_API_TOKEN"
      },
      "cwd": "./répertoire-du-serveur",
      "timeout": 30000,
      "trust": false
    }
  }
}

Propriétés de configuration :

Requis (l’une des propriétés suivantes) :

Optionnel :

Gérer les serveurs MCP avec qwen mcp

Vous pouvez toujours configurer les serveurs MCP en modifiant manuellement settings.json, mais l’interface en ligne de commande est généralement plus rapide.

Ajout d’un serveur (qwen mcp add)

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

Liste des serveurs (qwen mcp list)

qwen mcp list

Suppression d’un serveur (qwen mcp remove)

qwen mcp remove <name>