Zum Inhalt springen

ecentic MCP: Server.

Claude, ChatGPT und jeder Model Context Protocol-Client können ecentic nativ über JSON-RPC 2.0 aufrufen. Diese Seite ist die Verbindungsreferenz: der Endpoint, der Transport, der Handshake und jedes bereitgestellte Tool.

Streamable HTTP · JSON-RPC 2.0 · 7 Tools

01

Verbinden

Ein Endpoint, zwei Pfade, keine zu verwaltende Sitzung.

Verbindungsreferenz

Primärer Endpunkt
POST https://ecentic.ai/mcp
Gleicher Handler
POST https://ecentic.ai/api/mcp
POST https://ecentic.ai/mcp

Der Server ist unter /mcp und unter /api/mcp erreichbar. Beide verwenden denselben Handler; der einfache Pfad existiert, weil die meisten Clients und Scanner ihn zuerst prüfen.

02

Handshake

Zuerst initialisieren, dann die initialized-Benachrichtigung senden.

Handshake erkunden

  1. 01

    Initialisieren

    Client sendet
    initialize
    Server gibt zurück
    200

    Ausgehandeltes Protokoll + Serverfunktionen

    initialize gibt die ausgehandelte Protokollversion, die Serveridentität, ihre Fähigkeiten und einen instructions-String zurück, der beschreibt, wofür ecentic gedacht ist. Wenn Sie eine von ecentic unterstützte Version anfragen, erhalten Sie genau diese Version zurück; alles andere fällt auf die beworbene Version zurück.

  2. 02

    Benachrichtigen

    Client sendet
    notifications/initialized
    Server gibt zurück
    202

    Mit leerem Antwortkörper akzeptiert

    Die folgende Nachricht notifications/initialized ist eine JSON-RPC-Benachrichtigung — sie hat keine id und erzeugt keine Antwort. ecentic beantwortet sie transportkonform mit 202 Accepted und einem leeren Body. Ein Server, der auf eine Benachrichtigung mit einem JSON-RPC-Fehler antwortet, unterbricht den Handshake. Deshalb lohnt es sich, genau diesen Austausch zuerst zu prüfen, wenn ein Client keine Verbindung herstellen kann.

Vollständiges Handshake-Beispiel
Beim Initialisieren akzeptierte Protokollversionen
03

Tools

Welche Funktionen der Server bereitstellt und welche Aufrufe einen Schlüssel benötigen.

04

Authentifizierung

Read-only-Tools sind offen; alles, was auf ein Konto zugreift, benötigt einen Bearer-Schlüssel.

Bearer-Key senden

Codebeispiel

Senden Sie Authorization: Bearer ecentic_sk_… bei Tool-Aufrufen, die den Kontostatus verändern. Ein Aufruf, der Zugangsdaten benötigt und keine enthält, gibt HTTP 401 mit einem WWW-Authenticate-Header zurück, der auf das Protected Resource Metadata-Dokument verweist, damit ein Client die Discovery direkt aus dem Fehler erneut starten kann.

Zugangsdaten erstellen

Schlüssel sind Self-Service: Erstellen Sie ein Konto und erzeugen Sie dann einen Schlüssel im Dashboard oder über den Aufruf von create_api_key in einer authentifizierten Sitzung. Zu keinem Zeitpunkt ist ein Kontakt mit dem Vertrieb erforderlich.

05

Fehler

Zwei Fehlerebenen und woran Sie erkennen, welche vorliegt.

JSON-RPC-Fehler

error.code

Ein JSON-RPC-Fehler — eine unbekannte Methode, ungültige Parameter oder ein abgelehntes Tool — kommt als HTTP 200 mit einem error-Element zurück, genau wie von JSON-RPC spezifiziert. Verzweigen Sie nach error.code.

Transportfehler

application/problem+json

Ein Transportfehler — eine Methode, die der Endpoint nicht anbietet — kommt als RFC 9457-Problem-Dokument mit Content-Type: application/problem+json und einem maschinenlesbaren code zurück. Dasselbe Fehlermodell verwendet auch die REST-Oberfläche.

Authentifizierungsfehler

WWW-Authenticate

Die einzige Ausnahme ist 401: Hier wird der JSON-RPC-Umschlag mitgeliefert, damit ein Client, der bereits JSON-RPC verarbeitet, keinen zweiten Parser benötigt, zusätzlich zum WWW-Authenticate-Header für die Discovery.

Jede Aussage auf dieser Seite lässt sich überprüfen: Das Manifest, die Serverkarte und das OpenAPI-Dokument beschreiben alle denselben Endpoint.