MCP vs API : différences, exemples et choix
Comparez MCP et les appels API avec une même lecture de compte : découverte des outils, identifiants, exécution et erreurs.
Choisissez une API directe quand votre code doit fixer l’opération et les paramètres. MCP fournit une interface commune à un client IA pour découvrir et appeler des outils. Un serveur MCP peut appeler une API en interne : les deux approches se combinent.
Ce qui change
Avec une API ou un SDK, le code sélectionne l’opération et traite la réponse. Avec MCP, le client découvre les outils du serveur puis les invoque via le protocole. Les droits du service restent nécessaires. Consultez l’architecture officielle.
Garder la même tâche
Identifiez le compte GitHub connecté à OOMOL par les deux voies. Connectez d’abord le compte voulu.
Appeler depuis un backend
Installez @oomol-lab/connector, créez une clé API personnelle et stockez-la comme secret backend OOMOL_API_KEY. Exécutez uniquement dans un environnement serveur fiable :
import { Connector } from "@oomol-lab/connector";
const connector = new Connector({
apiKey: process.env.OOMOL_API_KEY!,
team: "<team-name>",
});
const result = await connector.execute("github.get_current_user", {});
console.log(result);
Remplacez <team-name> par l’équipe OOMOL contenant la connexion GitHub, puis choisissez cette même équipe dans la configuration MCP ci-dessous.
Comparez l’identité retournée au compte connecté. Le guide Connector explique la sélection parmi plusieurs connexions. Les clés personnelles, de projet et MCP ne sont pas interchangeables.
Appeler via MCP
Ouvrez la configuration MCP, sélectionnez le bon périmètre personnel ou d’équipe et ajoutez-la à un client compatible.
Utilise OOMOL MCP pour lire l’utilisateur GitHub connecté. Si plusieurs connexions existent, demande-moi de choisir. Retourne les champs d’identité réels sans rien modifier.
Vérifiez le même compte. OOMOL expose des outils de découverte et d’exécution ; chaque opération GitHub n’apparaît pas forcément séparément. Voir le guide MCP.
Suivre la même opération
Le SDK appelle l’API hébergée d’OOMOL, pas directement GitHub. Une intégration directe doit gérer ses propres identifiants GitHub et réponses.
| Étape | SDK OOMOL | Client MCP |
|---|---|---|
| Découverte | Inspecter connector.catalog.action("github.get_current_user"). | Découvrir les outils et schémas, puis chercher l’opération avec OOMOL. |
| Entrées | Fournir l’ID et {} ; choisir le compte séparément. | Suivre le schéma de l’outil, compte compris si nécessaire. |
| Autorisation | Clé personnelle, équipe et connexion GitHub. | Clé MCP, équipe et même connexion. OAuth ne remplace pas la clé OOMOL. |
| Exécution | Attendre connector.execute(...). | Appeler l’outil ; l’hôte décide des validations et de l’orchestration. |
| Résultat | execute renvoie les données ; executeRaw ajoute les métadonnées. | Vérifier le résultat de l’outil avant le résumé du modèle. |
MCP uniformise découverte et appels sans imposer qu’un modèle choisisse chaque opération. Une API peut aussi devenir un outil du modèle. Les deux voies exigent de maintenir la compatibilité et de suivre les changements de l’API sous-jacente.
Distinguer les erreurs
Séparez échec d’authentification, mauvaise équipe, connexion absente et résultat vide valide. Conservez les erreurs sans identifiants secrets. Pour comparer davantage, alignez filtres, pagination et champs.
Avec le SDK, interceptez ConnectorError et examinez code, status et les identifiants disponibles ; les reprises sont documentées dans la référence SDK. Corrigez les identifiants ou le compte avant de répéter un échec d’autorisation. En MCP, séparez erreurs de connexion et d’outil. Si la découverte fonctionne mais pas la requête, vérifiez l’équipe et la connexion GitHub. Conservez une erreur expurgée et l’identité de l’opération.
Choisir pour son workflow
Une API/SDK convient quand le code contrôle horaires, paramètres et reprises ; MCP convient à un client IA qui découvre les outils. Une API simple peut suffire sans plateforme supplémentaire. La référence SDK distingue comptes personnels/d’équipe et comptes clients. Essayez OOMOL Chat, puis une tâche GitHub ou Search Console.