MCP ecentic : serveur.
Claude, ChatGPT et tout client Model Context Protocol peuvent appeler ecentic nativement via JSON-RPC 2.0. Cette page est la référence de connexion : point d’accès, transport, handshake et tous les outils exposés.
HTTP streamable · JSON-RPC 2.0 · 7 outils
Connecter
Un point d’accès, deux chemins, aucune session à gérer.
Référence de connexion
- Point de terminaison principal
- POST https://ecentic.ai/mcp
- Même gestionnaire
- POST https://ecentic.ai/api/mcp
Le serveur est accessible via /mcp et /api/mcp. Les deux utilisent le même gestionnaire ; le chemin nu existe parce que la plupart des clients et scanners le sondent en premier.
Le transport est Streamable HTTP. Chaque requête est un POST contenant du JSON-RPC 2.0, et chaque réponse revient sur ce même POST. ecentic n’ouvre aucun flux initié par le serveur ; un GET avec Accept: text/event-stream renvoie donc 405 au lieu de laisser votre client attendre un flux qui n’émettra jamais.
Il n’y a pas de session. ecentic n’émet aucun Mcp-Session-Id, et DELETE — le verbe de terminaison de session — renvoie 405 pour la même raison. Rien n’a besoin d’être fermé.
Handshake
Initialisez, puis envoyez la notification nommée initialized.
Explorer la négociation initiale
- 01
Initialiser
- Le client envoie
- initialize
- Le serveur renvoie
- 200
Protocole négocié + capacités du serveur
initializerenvoie la version du protocole négociée, l’identité du serveur, ses capacités et une chaîneinstructionsdécrivant le rôle d’ecentic. Si vous demandez une version prise en charge par ecentic, cette version est renvoyée ; toute autre version revient à celle annoncée. - 02
Notifier
- Le client envoie
- notifications/initialized
- Le serveur renvoie
- 202
Accepté avec un corps vide
Le message
notifications/initializedqui suit est une notification JSON-RPC — il n’a pas d’idet n’appelle aucune réponse. ecentic y répond avec202 Acceptedet un corps vide, conformément au transport. Un serveur qui répond à une notification avec une erreur JSON-RPC casse le handshake ; c’est donc le premier échange à vérifier lorsqu’un client ne parvient pas à se connecter.
Outils
Ce que le serveur expose et quels appels nécessitent une clé.
Authentification
Les outils en lecture seule sont ouverts ; tout ce qui touche à un compte nécessite une clé bearer.
Envoyer une clé Bearer
Envoyez Authorization: Bearer ecentic_sk_… sur les appels d’outils qui modifient l’état du compte. Un appel nécessitant un identifiant et n’en recevant pas renvoie HTTP 401 avec un en-tête WWW-Authenticate indiquant le document Protected Resource Metadata, afin qu’un client puisse relancer la découverte à partir de l’échec lui-même.
Créer votre clé d’authentification
Les clés sont en libre-service : créez un compte, puis générez-en une depuis le tableau de bord ou en appelant create_api_key via une session authentifiée. Aucun contact commercial n’intervient à aucun moment.
Erreurs
Deux surfaces d’erreur et comment les distinguer.
Erreur JSON-RPC
error.code
Une erreur JSON-RPC — méthode inconnue, paramètres invalides, outil ayant refusé l’appel — arrive sous forme de HTTP 200 avec un membre error, exactement comme le spécifie JSON-RPC. Appuyez-vous sur error.code.
Erreur de transport
application/problem+json
Une erreur de transport — une méthode que le point d’accès ne propose pas — arrive sous forme de document de problème RFC 9457 avec Content-Type: application/problem+json et un code lisible par machine. C’est le même modèle d’erreur que celui utilisé par la surface REST.
Exception d’authentification
WWW-Authenticate
La seule exception est le 401 : il conserve l’enveloppe JSON-RPC pour qu’un client analysant déjà JSON-RPC n’ait pas besoin d’un second parseur, avec en plus l’en-tête WWW-Authenticate pour la découverte.
Chaque affirmation de cette page est vérifiable : le manifeste, la fiche serveur et le document OpenAPI décrivent tous le même point d’accès.