Endpoint e transporte

Esta página é voltada a desenvolvedores que estão criando ou depurando um cliente MCP. Se você só quer conectar um cliente existente, consulte Conectar um cliente.

O endpoint

Todas as operações usam um único endpoint:

https://namebeta.com/api/mcp

Propriedade	Valor
Transporte	Streamable HTTP, sem estado. Envie solicitações JSON-RPC 2.0 com POST
Outros métodos	GET e DELETE retornam 405 Method Not Allowed; não há fluxo SSE
Autenticação	Obrigatória. OAuth 2.1 com a conta do NameBeta do usuário; consulte Autorização
Registro de clientes	Consulte Registro de clientes

Solicitações

Envie uma solicitação JSON-RPC por POST, com o token de acesso obtido em Autorização:

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 deve incluir tanto application/json quanto text/event-stream, como exige o transporte Streamable HTTP.
• Uma solicitação por POST. O corpo deve ser um único objeto JSON-RPC, não um array.
• Sem sessões. Não há Mcp-Session-Id, e cada solicitação é independente. O servidor aceita initialize, mas ele não estabelece nenhum estado do qual as solicitações posteriores dependam.

Solicitações que violam alguma dessas regras são rejeitadas antes da execução de qualquer ferramenta; Solicitações malformadas lista os códigos de status.

Respostas

O servidor responde a todas as solicitações com um corpo JSON simples (Content-Type: application/json), nunca com um fluxo SSE: não há transmissão em streaming, notificações nem mensagens de progresso. Erros descreve os formatos que as falhas podem ter.