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

Le serveur regroupe ses outils par fonctionnalité de Studio.

Fonctionnalité	Ce qu’un agent peut faire
Apps	Lister vos apps, lire les modules, les environnements et les versions en cours d’une app, lire les déploiements et les logs d’un module ou de la passerelle, redéployer un module ou le ramener à une version déjà déployée, et publier ou retirer une app du catalogue. Les valeurs des variables d’environnement ne sont jamais renvoyées, seulement leurs noms.
Connecteurs	Lister vos connecteurs, lire leurs détails et les outils que chacun expose, et lister leurs identifiants. Les valeurs secrètes ne sont jamais renvoyées.
Documentation	Rechercher sur docs.mistral.ai et lire ses pages au format Markdown.
Évaluations	Gérer les projets d’évaluation et les évaluations, lire les exécutions et les enregistrements, et suivre les optimisations.
Bibliothèques	Lister, créer et supprimer des bibliothèques de documents, ajouter ou retirer des documents, et gérer qui peut accéder à une bibliothèque. Le contenu des documents n’est jamais renvoyé.
Observabilité	Rechercher des traces, des spans et des logs de vos applications, et ouvrir une trace ou un span spécifique.
Organisation	Rechercher les membres de l’espace de travail et résoudre un nom en identifiant utilisateur.
Compétences	Parcourez le même catalogue de Skill que dans Studio, lisez un Skill et ses fichiers, écrivez une nouvelle version, modifiez le partage ou supprimez un Skill.
Workflows	Lister les workflows, déployer des workflows gérés, démarrer et signaler des exécutions, lire les événements et les logs, et gérer les planifications.

Les outils d’Observabilité, d’Évaluations et d’Apps n’apparaissent que pour les espaces de travail où ces fonctionnalités sont activées. Le serveur liste les outils disponibles pour votre clé ; demandez donc à 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 effectuent des écritures ou des suppressions. Configurez l’approbation par outil dans votre client pour pouvoir relire 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.
Les outils d’Observabilité, d’Évaluations ou d’Apps sont absents de la liste d’outils.	La fonctionnalité est désactivée pour votre espace de travail.	Vérifiez que la fonctionnalité est disponible dans Studio, puis reconnectez le client.

Et après

Créer un Skill dans Studio pour donner à l’agent un élément sur lequel travailler.
Construire un workflow que l’agent peut déployer et exécuter.
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.