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
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
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.
Der Transport ist Streamable HTTP. Jede Anfrage ist ein POST mit JSON-RPC 2.0, und jede Antwort kommt über denselben POST zurück. ecentic öffnet keinen serverinitiierten Stream, daher antwortet ein GET mit Accept: text/event-stream mit 405, statt Ihren Client an einen Stream zu hängen, der nie Daten senden wird.
Es gibt keine Sitzung. ecentic vergibt keine Mcp-Session-Id, und DELETE — das Verb zum Beenden einer Sitzung — antwortet aus demselben Grund mit 405. Es muss nichts beendet werden.
Handshake
Zuerst initialisieren, dann die initialized-Benachrichtigung senden.
Handshake erkunden
- 01
Initialisieren
- Client sendet
- initialize
- Server gibt zurück
- 200
Ausgehandeltes Protokoll + Serverfunktionen
initializegibt die ausgehandelte Protokollversion, die Serveridentität, ihre Fähigkeiten und eineninstructions-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. - 02
Benachrichtigen
- Client sendet
- notifications/initialized
- Server gibt zurück
- 202
Mit leerem Antwortkörper akzeptiert
Die folgende Nachricht
notifications/initializedist eine JSON-RPC-Benachrichtigung — sie hat keineidund erzeugt keine Antwort. ecentic beantwortet sie transportkonform mit202 Acceptedund 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.
Tools
Welche Funktionen der Server bereitstellt und welche Aufrufe einen Schlüssel benötigen.
Authentifizierung
Read-only-Tools sind offen; alles, was auf ein Konto zugreift, benötigt einen Bearer-Schlüssel.
Bearer-Key senden
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.
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.