MCP

Le serveur MCP de Mistral connecte un agent IA à votre espace de travail Studio via le Model Context Protocol. Il expose votre espace de travail sous forme d’outils MCP et authentifie chaque requête avec votre clé API Mistral.

Utilisez-le depuis l’environnement où votre agent s’exécute : une CLI de développement, un IDE, un assistant de bureau ou votre propre application.


Endpoint	`https://api.mistral.ai/mcp`
Transport	Streamable HTTP
Authentification	`Authorization: Bearer <MISTRAL_API_KEY>`

Avant de commencer

Une clé API Mistral. Les clés sont propres à un espace de travail : l’agent dispose donc de l’accès déjà associé à cette clé.
Un client MCP qui prend en charge le transport HTTP streamable et les en-têtes de requête statiques.

Exportez la clé dans l’environnement qui lance votre client :

export MISTRAL_API_KEY="your_api_key"

export MISTRAL_API_KEY="your_api_key"

Connecter un client

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

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

Cette commande écrit l’entrée dans ~/.vibe/config.toml:

[[mcp_servers]]
name = "mistralai"
transport = "streamable-http"
url = "https://api.mistral.ai/mcp"

[mcp_servers.auth]
type = "static"
api_key_env = "MISTRAL_API_KEY"

[[mcp_servers]]
name = "mistralai"
transport = "streamable-http"
url = "https://api.mistral.ai/mcp"

[mcp_servers.auth]
type = "static"
api_key_env = "MISTRAL_API_KEY"

La configuration stocke le nom de la variable, et l’environnement contient la clé. Exécutez /mcp mistralai dans une session pour lister les outils. Consultez Serveurs MCP pour les autorisations et le filtrage des outils.

Ce que le serveur expose

Skills, les ensembles d’instructions réutilisables que vous gérez dans Studio›Skills ↗. Un agent parcourt le catalogue de l’espace de travail, lit un Skill et les fichiers associés, crée une nouvelle version de Skill, modifie son partage ou le supprime. Un Skill écrit depuis votre éditeur apparaît dans Studio, et un Skill écrit dans Studio est disponible pour l’agent.

Skills est la première fonctionnalité disponible. D’autres suivront. Le serveur liste les outils disponibles pour votre clé : demandez à votre client sa liste d’outils, ou appelez tools/list. Chaque outil décrit ses propres arguments.

Accès et autorisations

Chaque appel utilise les autorisations de votre clé API.

Certains outils écrivent des données : ils ajoutent des versions de Skill, modifient le partage et suppriment des Skills. Configurez l’approbation par outil dans votre client pour vérifier ces appels avant leur exécution.

Résolution des problèmes

Problème	Cause	Solution
`401 {"detail":"Invalid API Key"}`	La clé est absente, mal saisie ou révoquée.	Exportez la variable dans l’environnement qui lance votre client, puis vérifiez que la clé est active dans la console.
Un appel d’outil renvoie une erreur d’autorisation.	L’opération nécessite un accès supplémentaire à l’espace de travail.	Demandez l’accès correspondant à un Admin de l’espace de travail, puis réessayez.

Et après

Créer un Skill dans Studio pour donner à l’agent un élément sur lequel travailler.
Serveurs MCP dans la CLI Vibe Code pour les autorisations par outil et le filtrage.
Clés API pour créer et renouveler la clé utilisée pour la connexion.