Aller au contenu

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

01

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
POST https://ecentic.ai/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.

02

Handshake

Initialisez, puis envoyez la notification nommée initialized.

Explorer la négociation initiale

  1. 01

    Initialiser

    Le client envoie
    initialize
    Le serveur renvoie
    200

    Protocole négocié + capacités du serveur

    initialize renvoie la version du protocole négociée, l’identité du serveur, ses capacités et une chaîne instructions dé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.

  2. 02

    Notifier

    Le client envoie
    notifications/initialized
    Le serveur renvoie
    202

    Accepté avec un corps vide

    Le message notifications/initialized qui suit est une notification JSON-RPC — il n’a pas d’id et n’appelle aucune réponse. ecentic y répond avec 202 Accepted et 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.

Exemple complet de négociation initiale
Versions du protocole acceptées par initialize
03

Outils

Ce que le serveur expose et quels appels nécessitent une clé.

04

Authentification

Les outils en lecture seule sont ouverts ; tout ce qui touche à un compte nécessite une clé bearer.

Envoyer une clé Bearer

Exemple de code

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.

05

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.