Update Date : 2026.06.12

⚠️ MCP 서버가 아래 조건을 충족하지 않을 경우 심사 단계에서 반려될 수 있습니다.

1. PlayMCP 서버 생성 조건

MCP 서버 생성 시 아래 사항을 준수해야 합니다.

1. MCP 서버는 최소 지원버전: 2025-03-26, 최대 지원버전: 2025-11-25 을 만족해야 합니다. MCP 스펙 문서
   • Streamable HTTP 방식만 지원합니다. MCP 전송스펙 문서
   • Remote MCP 서버만 지원합니다. MCP 서버는 공개된 URL로 접근 가능한 도메인이어야 합니다.
   • Stateless MCP 서버를 권장합니다. (no session)
   • 사용자 인증이 필요한 경우, OAuth 인증 혹은 커스텀 헤더 방식을 지원해야 합니다. MCP 인증스펙 문서
2. MCP Inspector로 MCP 표준 스펙을 준수하고 있는지 사전 점검해야 합니다. MCP Inspector 설치
3. MCP 서버 생성 시에는 활발하게 운영되는 SDK를 사용하거나 참조해야 합니다. SDK 목록 보기
4. MCP Server Name 또는 Tool Name에 "kakao"를 prefix 또는 suffix 로 사용할 수 없습니다.
   • 대소문자 구분 없이 prefix, suffix, 중간에 포함 모두 불가합니다.

2. PlayMCP Tool 구성

Tools 구성시 아래 필수/권장 규칙을 준수해야 합니다.

1. 툴 이름

   툴 이름은 아래 조건을 만족해야 합니다.

   • 최소 1 글자, 최대 128 글자
   • 영어 대소문자(A-Z,a-z), 숫자(0-9), _(underscore), -(hyphen)만 허용
   • 중복된 툴 이름이 존재해서는 안 됩니다.
   • 대소문자가 구분됩니다.(Case-sensitive)
     • ex. getInfo 는 GetInfo와 구분됩니다.

2. 툴 개수

   • MCP 서버당 툴의 개수가 가능한 20개를 초과 금지하며, 3개~10개를 권장합니다.
     • 툴의 개수가 과도하게 많아질 경우 LLM의 툴콜 발생 확률을 낮춥니다.

3. 반드시 포함시켜야 할 property 목록

   • name, description, inputSchema, annotations
   • annotations는 title, readOnlyHint, destructiveHint, openWorldHint, idempotentHint 모두 값 지정해야 합니다.

4. description 작성시 유의사항

   • description은 가능한 영문 작성을 권장합니다.

   • description에 MCP 명(서비스 이름)을 포함해야 합니다.

   • 서비스 이름은 고유명사로서 영문, 국문을 병기하여 표기합니다.

     예시 : Retrieves a list of the current most popular or trending songs from Melon(멜론)

   • description은 1,024자 이내로 작성합니다.

     • 너무 긴 description은 툴 호출에 오히려 불리할 뿐더러 다른 툴 호출에도 영향을 줍니다.

5. 권장 규칙

   • Kakao Tools에 툴이 반영될 때 카카오는 tool name에 PlayMCP에서 지정한 prefix가 name에 자동으로 포함되도록 처리합니다.
     • 따라서 tool name에 MCP명을 포함시킬 필요가 없습니다.