Serveurs MCP

Les serveurs MCP étendent la Vibe Code CLI avec des outils externes via le Model Context Protocol. Ajoutez-les avec la commande vibe mcp add, la commande slash /mcp add, ou directement dans config.toml sous mcp_servers. Leurs outils deviennent alors disponibles pour Vibe comme tout outil natif.

Les serveurs MCP sont configurés par l'utilisateur. Pour les intégrations gérées par Mistral, consultez plutôt Connectors.

vibe mcp add écrit le serveur dans votre config.toml utilisateur sans démarrer de session. Pour un serveur distant qui utilise OAuth, indiquez son nom et son URL. Vibe ouvre votre navigateur pour vous connecter :

vibe mcp add linear --url https://mcp.linear.app/mcp

vibe mcp add linear --url https://mcp.linear.app/mcp

Passez --no-login pour enregistrer le serveur sans vous connecter, et --scope (répétable) pour demander des scopes OAuth spécifiques.

Pour un serveur distant qui utilise une clé API ou des en-têtes statiques, passez --api-key-env ou --header :

vibe mcp add mistralai \
  --url https://api.mistral.ai/mcp \
  --api-key-env MISTRAL_API_KEY

vibe mcp add mistralai \
  --url https://api.mistral.ai/mcp \
  --api-key-env MISTRAL_API_KEY

Pour un serveur local, utilisez le transport stdio. Répétez --arg pour chaque argument et --env pour chaque variable d'environnement :

vibe mcp add fetch_server --transport stdio --command uvx --arg mcp-server-fetch

vibe mcp add fetch_server --transport stdio --command uvx --arg mcp-server-fetch

Supprimez un serveur avec vibe mcp remove <name>. La suppression d'un serveur OAuth efface également ses tokens stockés. Exécutez vibe mcp add --help pour voir toutes les options.

Vous pouvez également ajouter un serveur OAuth depuis une session avec /mcp add <url>. La commande accepte les mêmes options --name, --scope, --transport et --no-login :

/mcp add https://mcp.linear.app/mcp

/mcp add https://mcp.linear.app/mcp

Ajoutez une table [[mcp_servers]] dans config.toml. Les champs obligatoires dépendent du transport.

[[mcp_servers]]
name = "my_http_server"
transport = "http"
url = "http://localhost:8000"

[mcp_servers.auth]
type = "static"
headers = { "X-Client" = "vibe" }
api_key_env = "MY_API_KEY_ENV_VAR"
api_key_header = "Authorization"
api_key_format = "Bearer {token}"

[[mcp_servers]]
name = "my_http_server"
transport = "http"
url = "http://localhost:8000"

[mcp_servers.auth]
type = "static"
headers = { "X-Client" = "vibe" }
api_key_env = "MY_API_KEY_ENV_VAR"
api_key_header = "Authorization"
api_key_format = "Bearer {token}"

Vibe accepte toujours headers, api_key_env, api_key_header et api_key_format directement dans [[mcp_servers]], et les traite comme une authentification statique. Ne les combinez pas avec un tableau [mcp_servers.auth]. Consultez la référence de configuration pour tous les champs.

Les outils MCP sont exposés selon le format {server_name}_{tool_name}. Configurez les autorisations par outil comme pour les outils natifs :

[tools.fetch_server_get]
permission = "always"

[tools.my_http_server_query]
permission = "ask"

[tools.fetch_server_get]
permission = "always"

[tools.my_http_server_query]
permission = "ask"

Vous pouvez aussi restreindre les outils MCP actifs via enabled_tools et disabled_tools :

# Only enable serena's tools
enabled_tools = ["serena_*"]

# Disable every tool from the fetch_server server
disabled_tools = ["fetch_server_*"]

# Only enable serena's tools
enabled_tools = ["serena_*"]

# Disable every tool from the fetch_server server
disabled_tools = ["fetch_server_*"]

Les filtres prennent en charge les noms exacts, les motifs globaux et les regex avec le préfixe re:.

Depuis une session CLI :

/mcp

/mcp

Indiquez un nom de serveur pour répertorier ses outils :

/mcp fetch_server

/mcp fetch_server

/mcp accepte également ces sous-commandes :