メインコンテンツまでスキップ

エンドポイントとトランスポート

このページは、MCP クライアントを開発またはデバッグする開発者向けです。既存のクライアントを接続したいだけの場合は、クライアントを接続を参照してください。

エンドポイント​

エンドポイントは 1 つだけです。

https://namebeta.com/api/mcp
項目値
トランスポートStreamable HTTP（ステートレス）。JSON-RPC 2.0 のリクエストを POST で送信
その他のメソッドGET と DELETE には 405 Method Not Allowed を返します。SSE ストリームはありません
認証必須。ユーザーの NameBeta アカウントによる OAuth 2.1。認可を参照
クライアント登録クライアント登録を参照

リクエスト​

認可で取得したアクセストークンを付けて、POST ごとに 1 つの JSON-RPC リクエストを送信します。

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 には、Streamable HTTP トランスポートの要件どおり application/json と text/event-stream の両方を指定します。
  • POST ごとに 1 リクエスト。 本文は配列ではなく、単一の JSON-RPC オブジェクトです。
  • セッションなし。 Mcp-Session-Id はなく、各リクエストは独立しています。initialize は受け付けますが、後続のリクエストが依存する状態は何も作りません。

これらのルールに反するリクエストは、ツールが実行される前に拒否されます。ステータスコードは不正なリクエストにまとめています。

レスポンス​

サーバーはすべてのリクエストに、SSE ストリームではなくプレーンな JSON 本文（Content-Type: application/json）で応答します。ストリーミングは行わず、通知や進捗メッセージもありません。失敗時のレスポンスの形式はエラーで説明しています。

に最終更新