MCP vs API REST : quelle architecture choisir pour des agents IA ?
MCP ou API REST pour un agent IA ? Choisissez selon qui décide de l’opération : le code, le modèle, ou les deux dans une architecture hybride.
10 min de lecture
Avant la liste : trois règles
Moins de serveurs, une meilleure cadence. Chaque serveur ajoute des outils au contexte du modèle et des décisions à son plan. Dix outils bien choisis valent mieux que soixante. Commence avec deux serveurs, ajoutes-en un quand un workflow en a clairement besoin.
Lecture d’abord, écriture derrière une approbation. L’essentiel de la valeur de MCP pour un assistant de code, c’est le contexte : le ticket, le test qui échoue, l’erreur en production, la décision qui explique la contrainte bizarre. Les lectures ne coûtent rien à autoriser. Autorise une écriture à la fois, réversible, derrière une demande d’approbation, et regarde les journaux avant d’autoriser la suivante.
Une identité par serveur. Claude Code agit en ton nom. Donne-lui un jeton limité à ce que tu ferais toi-même dans ce système, et révocable aussi facilement. Un serveur qui n’accepte qu’un jeton admin large n’est pas prêt pour un agent.
Les serveurs, dans l’ordre pour les ajouter
1. Ton hébergeur de dépôt
Le premier serveur de tout agent de code : tickets, pull requests, revues, état de la CI. GitHub publie un serveur MCP officiel ; GitLab et les autres ont des équivalents communautaires ou officiels. Autorise : lire les tickets et les PR, lire les résultats de CI, commenter. Garde pour plus tard : fusionner, forcer un push, supprimer.
2. La documentation, versionnée
Un serveur de documentation permet au modèle de lire la doc actuelle des bibliothèques que tu utilises, au lieu de s’appuyer sur des données d’entraînement qui peuvent avoir une version majeure de retard. Context7 est le choix courant ; certaines équipes pointent un serveur de fichiers vers leur propre dossier de docs. Autorise tout — c’est de la lecture par nature.
3. Le système de fichiers, délimité
Le serveur de fichiers de référence donne au modèle une vue bornée d’un répertoire : utile quand ton travail s’étend sur plusieurs dépôts ou un dossier de docs hors du dépôt courant. Limite-le aux chemins que tu ouvrirais toi-même, jamais à ton répertoire personnel.
4. Un navigateur
Un serveur de navigateur (Playwright est la référence) transforme « le bouton ne marche pas » en quelque chose que l’agent peut reproduire : ouvrir la page, cliquer, lire la console, prendre une capture. Autorise la navigation et la lecture ; méfie-toi de tout ce qui soumet des formulaires sur de vrais sites.
5. Ta base de données, en lecture seule
Un serveur Postgres ou SQLite avec un rôle en lecture seule répond aux questions qui coûtent sinon un aller-retour vers un collègue : que contient vraiment cette table, quelles lignes déclenchent cette contrainte, combien d’utilisateurs sont dans cet état. Utilise un rôle qui ne peut pas écrire. Jamais.
6. Le suivi d’erreurs
Un serveur de type Sentry laisse l’agent lire la trace, le fil d’ariane et la fréquence de l’erreur qu’il corrige, et relier le correctif au ticket. La lecture seule suffit largement.
7. Ton outil projet
C’est là que l’agent apprend pourquoi il fait le travail : la carte, les critères d’acceptation, les documents liés, la décision qui exclut l’approche évidente. C’est aussi là que le résultat doit atterrir — un commentaire, un changement de statut, une question au relecteur — au lieu de rester dans une fenêtre de chat.
Le serveur de Stellary expose projets, cartes, documents, missions et validations via MCP, avec une identité par agent, une liste d’outils autorisés et une règle d’autonomie (direct, supervisé, proposition). Le guide Claude Code montre la configuration en trois étapes. Linear, Notion et Jira ont aussi des serveurs MCP ; les critères sont les mêmes — l’agent peut-il lire la carte et son contexte, et ses écritures peuvent-elles passer par une approbation.
8. Les fichiers de design
Un serveur Figma laisse l’agent lire la frame qu’il implémente : dimensions, tokens, textes. Lecture seule, et rentable pour le travail front.
9. Ton outil de chat
Slack ou équivalent, pour lire le fil où le besoin a réellement été discuté. Lecture seule ; ne laisse jamais un agent poster dans un canal sans une personne dans la boucle.
10. Un serveur de recherche
La recherche web comble l’écart entre la documentation et le message d’erreur que personne n’a documenté. Garde-le pour la fin : c’est le serveur qui envoie le plus souvent le modèle dans un terrier.
À quoi ressemble une bonne première journée
Connecte l’hébergeur de dépôt et l’outil projet, tous deux en lecture seule. Demande à Claude Code de préparer un changement : lire la carte, lire le ticket lié, lire le test qui échoue, proposer un plan. Valide le plan, laisse-le implémenter, lance les tests. Puis autorise une écriture : un commentaire sur la carte avec le résultat et les preuves. Quand ça a marché dix fois, envisage d’autoriser un changement de statut derrière une approbation. C’est le plan de déploiement décrit dans ce que MCP change pour les outils de code IA, et c’est la différence entre un assistant qui aide et un agent en qui tu as confiance.
Les questions de sécurité à poser à tout serveur
- Sous quelle identité agit-il, et puis-je le limiter à un projet ou à un dépôt ?
- Quels outils écrivent, et chaque écriture peut-elle passer par une approbation ?
- Y a-t-il une trace d’audit que je peux lire après coup ?
- Que se passe-t-il sur un timeout, un jeton expiré, une ressource absente — une erreur, ou un succès partiel silencieux ?
- Le serveur suit-il les recommandations d’autorisation de MCP, ou veut-il un jeton admin de longue durée ?
FAQ
Quels serveurs MCP connecter à Claude Code en premier ?
Ton hébergeur de dépôt et ton outil projet, tous deux en lecture seule. Ils donnent à l’agent le ticket, les critères d’acceptation et le contexte qui explique les contraintes. Ajoute ensuite un serveur de documentation, puis un navigateur ou une base de données en lecture seule quand un workflow en a besoin.
Combien de serveurs MCP, c’est trop ?
Quand le modèle commence à choisir le mauvais outil ou à ignorer le bon. Chaque serveur ajoute des outils à son contexte et des décisions à son plan. Deux ou trois serveurs bien délimités valent en général mieux que dix ; ajoutes-en un quand un workflow en a clairement besoin et retire ceux que personne n’utilise.
Claude Code peut-il mettre à jour mon outil de gestion de projet via MCP ?
Oui, si le serveur expose des outils d’écriture et que tu les autorises. Commence par un commentaire sur la carte (le résultat et les preuves), derrière une demande d’approbation. Le serveur de Stellary place chaque action hors lecture derrière une règle par agent : direct, supervisé ou sur proposition.
