엔드포인트와 전송 방식

이 페이지는 MCP 클라이언트를 개발하거나 디버깅하는 개발자를 위한 문서입니다. 기존 클라이언트를 연결하기만 하려면 클라이언트 연결을 참조하세요.

엔드포인트

모든 요청은 하나의 엔드포인트로 보냅니다.

https://namebeta.com/api/mcp

항목	값
전송 방식	상태 비저장(stateless) Streamable HTTP. JSON-RPC 2.0 요청을 `POST`로 보냅니다
기타 메서드	`GET`과 `DELETE`는 `405 Method Not Allowed`를 반환합니다. SSE 스트림은 없습니다
인증	필수. NameBeta 계정을 사용하는 OAuth 2.1입니다. 권한 부여를 참조하세요
클라이언트 등록	클라이언트 등록을 참조하세요

요청

권한 부여에서 받은 액세스 토큰을 붙여 POST당 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당 요청 하나. 본문은 배열이 아닌 단일 JSON-RPC 객체입니다.
세션 없음. Mcp-Session-Id는 없으며 요청은 각각 독립적으로 처리됩니다. initialize는 받아들이지만, 이후 요청이 의존하는 상태를 만들지는 않습니다.

이 규칙 중 하나라도 어긴 요청은 도구가 실행되기 전에 거부됩니다. 상태 코드는 잘못된 형식의 요청에 정리되어 있습니다.

응답

서버는 모든 요청에 일반 JSON 본문(Content-Type: application/json)으로 응답하며, SSE 스트림은 사용하지 않습니다. 스트리밍되는 내용은 없고 알림이나 진행 상황 메시지도 없습니다. 실패 시의 응답 형태는 오류에서 설명합니다.

엔드포인트​

요청​

응답​

엔드포인트

요청

응답