Endpunkt und Transport

Diese Seite richtet sich an Entwickler, die einen MCP-Client erstellen oder Fehler darin untersuchen. Wenn Sie nur einen bestehenden Client verbinden möchten, siehe Client verbinden.

Der Endpunkt

Es gibt einen einzigen Endpunkt für alle Anfragen:

https://namebeta.com/api/mcp

Eigenschaft	Wert
Transport	Streamable HTTP, zustandslos. Senden Sie JSON-RPC-2.0-Anfragen mit POST
Andere Methoden	GET und DELETE geben 405 Method Not Allowed zurück; es gibt keinen SSE-Stream
Authentifizierung	Erforderlich. OAuth 2.1 mit dem NameBeta-Konto des Nutzers – siehe Autorisierung
Client-Registrierung	Siehe Client-Registrierung

Anfragen

Senden Sie eine JSON-RPC-Anfrage pro POST und verwenden Sie dabei das unter Autorisierung beschriebene Zugriffstoken:

POST /api/mcp HTTP/1.1
Host: namebeta.com
Authorization: Bearer eyJhbGciOi...
Content-Type: application/json
Accept: application/json, text/event-stream

{"jsonrpc":"2.0","id":1,"method":"tools/list"}

• Accept enthält sowohl application/json als auch text/event-stream, wie vom Transport Streamable HTTP vorgeschrieben.
• Eine Anfrage pro POST. Der Body enthält ein einzelnes JSON-RPC-Objekt, kein Array.
• Keine Sitzungen. Es gibt keine Mcp-Session-Id, und jede Anfrage ist eigenständig. initialize wird akzeptiert, richtet aber keinen Zustand ein, von dem spätere Anfragen abhängen.

Eine Anfrage, die eine dieser Regeln verletzt, wird abgelehnt, bevor ein Tool ausgeführt wird. Unter Fehlerhafte Anfragen finden Sie die Statuscodes.

Antworten

Der Server beantwortet jede Anfrage mit einem einfachen JSON-Body (Content-Type: application/json), niemals mit einem SSE-Stream. Es werden keine Daten gestreamt, und es gibt weder Benachrichtigungen noch Fortschrittsmeldungen. Fehler beschreibt die möglichen Fehlerantworten.