Aller au contenu
← Retour au blog

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.

OOMOL

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.

ÉtapeSDK OOMOLClient MCP
DécouverteInspecter connector.catalog.action("github.get_current_user").Découvrir les outils et schémas, puis chercher l’opération avec OOMOL.
EntréesFournir l’ID et {} ; choisir le compte séparément.Suivre le schéma de l’outil, compte compris si nécessaire.
AutorisationClé personnelle, équipe et connexion GitHub.Clé MCP, équipe et même connexion. OAuth ne remplace pas la clé OOMOL.
ExécutionAttendre connector.execute(...).Appeler l’outil ; l’hôte décide des validations et de l’orchestration.
Résultatexecute 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.