Point de terminaison et transport

Cette page s’adresse aux développeurs qui créent ou déboguent un client MCP. Si vous souhaitez simplement connecter un client existant, consultez Connecter un client.

Le point de terminaison

Un seul point de terminaison sert à tout :

https://namebeta.com/api/mcp

Propriété	Valeur
Transport	Streamable HTTP, sans état. Envoyez les requêtes JSON-RPC 2.0 avec POST
Autres méthodes	GET et DELETE renvoient 405 Method Not Allowed ; il n’y a pas de flux SSE
Authentification	Obligatoire. OAuth 2.1 avec le compte NameBeta de l’utilisateur — consultez Autorisation
Enregistrement du client	Consultez Enregistrement du client

Requêtes

Envoyez une requête JSON-RPC par POST, avec le jeton d’accès obtenu comme décrit dans Autorisation :

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 liste à la fois application/json et text/event-stream, comme l’exige le transport Streamable HTTP.
• Une requête par POST. Le corps est un objet JSON-RPC unique, et non un tableau.
• Pas de session. Il n’y a pas de Mcp-Session-Id, et chaque requête est indépendante. initialize est accepté, mais ne met en place rien dont dépendraient les requêtes suivantes.

Une requête qui enfreint l’une de ces règles est refusée avant l’exécution de tout outil ; la section Requêtes mal formées liste les codes de statut.

Réponses

Le serveur répond à chaque requête avec un corps JSON simple (Content-Type: application/json), jamais avec un flux SSE : rien n’est diffusé en continu, et il n’y a ni notifications ni messages de progression. La page Erreurs décrit les différentes formes que peut prendre un échec.