Endpoint y transporte

Esta página está dirigida a desarrolladores que crean o depuran un cliente MCP. Si solo quieres conectar un cliente existente, consulta Conectar un cliente.

El endpoint

Todas las operaciones usan un único endpoint:

https://namebeta.com/api/mcp

Propiedad	Valor
Transporte	Streamable HTTP, sin estado. Envía solicitudes JSON-RPC 2.0 mediante POST
Otros métodos	GET y DELETE devuelven 405 Method Not Allowed; no hay flujo SSE
Autenticación	Obligatoria. OAuth 2.1 con la cuenta de NameBeta del usuario; consulta Autorización
Registro de clientes	Consulta Registro de clientes

Solicitudes

Envía una solicitud JSON-RPC por POST, con el token de acceso obtenido mediante Autorización:

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 debe incluir tanto application/json como text/event-stream, tal como exige el transporte Streamable HTTP.
• Una solicitud por POST. El cuerpo debe ser un único objeto JSON-RPC, no un array.
• Sin sesiones. No hay Mcp-Session-Id y cada solicitud es independiente. Se acepta initialize, pero no establece ningún estado del que dependan las solicitudes posteriores.

Las solicitudes que incumplen alguna de estas reglas se rechazan antes de ejecutar cualquier herramienta; Solicitudes mal formadas enumera los códigos de estado.

Respuestas

El servidor responde a todas las solicitudes con un cuerpo JSON normal (Content-Type: application/json), nunca con un flujo SSE: no transmite datos en streaming ni envía notificaciones o mensajes de progreso. Errores describe los formatos que pueden tener los fallos.