Ce qu'est une API REST
Une API REST est un contrat HTTP entre deux services logiciels. Elle définit des endpoints (GET /companies/{siren}), des méthodes (GET, POST, PUT, DELETE), et des formats de réponse (JSON, XML). Elle est stateless, documentée en OpenAPI/Swagger, et consommée par n'importe quel client HTTP.
Le consommateur d'une API REST est un développeur qui écrit du code. La logique de quand et comment appeler l'API est dans le code applicatif, pas dans l'API elle-même.
Ce qu'est le protocole MCP
Le Model Context Protocol, développé par Anthropic et open-sourcé fin 2024, est un protocole qui permet à un LLM d'appeler des outils de manière standardisée. MCP définit comment un modèle de langage découvre, sélectionne et invoque des outils externes.
La différence fondamentale : le consommateur d'un serveur MCP est le LLM lui-même, pas un humain qui code. C'est le modèle qui décide dynamiquement quel outil appeler, avec quels paramètres, dans quel ordre.
Comparatif technique
| Critère | API REST | MCP |
|---|---|---|
| Consommateur | Code applicatif (humain) | LLM (IA) |
| Protocole | HTTP/HTTPS | stdio ou Streamable HTTP |
| Découverte | Documentation OpenAPI | list_tools automatique |
| Orchestration | Dans le code | Dans le modèle |
| Typage | JSON Schema (optionnel) | Zod / JSON Schema (requis) |
| Stateful | Non | Oui (session) |
Comment OneMCP expose les deux
OneMCP propose les deux interfaces simultanément :
Via MCP (pour Claude, Cursor, Cline…)
{
"tool": "company_get",
"params": { "identifier": "552032534" }
}Le LLM appelle directement le tool via le protocole MCP. Aucun code intermédiaire nécessaire.
Via REST (pour Make.com, n8n, scripts…)
POST https://api.onemcp.fr/api/company_get
Authorization: Bearer mk_live_xxx
Content-Type: application/json
{ "identifier": "552032534" }La même logique, exposée en HTTP standard pour les intégrations no-code et les scripts.
Quand utiliser MCP plutôt que REST ?
Utilisez MCP quand :
- Vous travaillez avec un agent IA (Claude, GPT avec custom actions, Cursor)
- L'orchestration des appels doit être dynamique (l'IA décide)
- Vous voulez éviter d'écrire de la logique de routage
Utilisez REST quand :
- Vous intégrez dans un outil no-code (Make.com, Zapier, n8n)
- La séquence d'appels est fixe et déterministe
- Vous consommez depuis un backend non-LLM
MCP est-il stable ?
Le protocole MCP a été standardisé et est désormais supporté par Claude, Cursor, Cline, Continue, Windsurf et plusieurs frameworks open-source (LangChain, AutoGen). La spec 1.0 est stable depuis début 2025. OneMCP suit la spec officielle via le SDK @modelcontextprotocol/sdk.