CPN 한국어 자습서 · 외부 문서 한국어 미러
MCP 문서 · Registry
Publishing Remote Servers · 원문: modelcontextprotocol.io/registry/remote-servers
아래는 원문을 한국어로 옮긴 미러입니다. 코드·명령은 원문 그대로이며, 가장 최신 정보는 하단 원문 링크에서 확인하세요.
참고: MCP 레지스트리는 현재 프리뷰 단계입니다. 일반 공개 전까지 주요 변경 사항이나 데이터 초기화가 발생할 수 있습니다. 문제가 발생하면 GitHub에 보고해 주세요.
MCP 레지스트리는 server.json의 remotes 속성을 통해 원격 MCP 서버를 지원합니다:
{
"$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
"name": "com.example/acme-analytics",
"title": "ACME Analytics",
"description": "Real-time business intelligence and reporting platform",
"version": "2.0.0",
"remotes": [
{
"type": "streamable-http",
"url": "https://analytics.example.com/mcp"
}
]
}
원격 서버는 지정된 URL에서 공개적으로 접근 가능해야 합니다(MUST).
원격 서버는 Streamable HTTP 전송(권장) 또는 SSE 전송을 사용할 수 있습니다. 또한 원격 서버는 서로 다른 URL을 통해 두 전송을 동시에 지원할 수도 있습니다.
remotes 항목의 type 속성을 "streamable-http" 또는 "sse"로 설정하여 전송 방식을 지정합니다:
{
"$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
"name": "com.example/acme-analytics",
"title": "ACME Analytics",
"description": "Real-time business intelligence and reporting platform",
"version": "2.0.0",
"remotes": [
{
"type": "streamable-http",
"url": "https://analytics.example.com/mcp"
},
{
"type": "sse",
"url": "https://analytics.example.com/sse"
}
]
}
원격 서버는 {중괄호} 표기법을 사용하여 URL 템플릿 변수를 정의할 수 있습니다. 이를 통해 단일 서버 정의로 구성 가능한 값을 가진 여러 엔드포인트를 지원하는 멀티테넌트 배포가 가능합니다:
{
"$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
"name": "com.example/acme-analytics",
"title": "ACME Analytics",
"description": "Real-time business intelligence and reporting platform",
"version": "2.0.0",
"remotes": [
{
"type": "streamable-http",
"url": "https://{tenant_id}.analytics.example.com/mcp",
"variables": {
"tenant_id": {
"description": "Your tenant identifier (e.g., 'us-cell1', 'emea-cell1')",
"isRequired": true
}
}
}
]
}
이 서버를 구성할 때 사용자는 tenant_id 값을 제공하고, URL 템플릿은 적절한 엔드포인트(예: https://us-cell1.analytics.example.com/mcp)로 해석됩니다.
변수는 default, choices, isSecret 등의 추가 속성을 지원합니다:
{
"$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
"name": "com.example/multi-region-mcp",
"title": "Multi-Region MCP",
"description": "MCP server with regional endpoints",
"version": "1.0.0",
"remotes": [
{
"type": "streamable-http",
"url": "https://api.example.com/{region}/mcp",
"variables": {
"region": {
"description": "Deployment region",
"isRequired": true,
"choices": [
"us-east-1",
"eu-west-1",
"ap-southeast-1"
],
"default": "us-east-1"
}
}
}
]
}
remotes 항목에 headers 속성을 추가하여 MCP 클라이언트가 특정 HTTP 헤더를 전송하도록 지시할 수 있습니다:
{
"$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
"name": "com.example/acme-analytics",
"title": "ACME Analytics",
"description": "Real-time business intelligence and reporting platform",
"version": "2.0.0",
"remotes": [
{
"type": "streamable-http",
"url": "https://analytics.example.com/mcp",
"headers": [
{
"name": "X-API-Key",
"description": "API key for authentication",
"isRequired": true,
"isSecret": true
}
]
}
]
}
remotes 속성은 server.json의 packages 속성과 공존할 수 있어, MCP 호스트 애플리케이션이 선호하는 설치 방법을 선택할 수 있습니다.
{
"$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
"name": "io.github.username/email-integration-mcp",
"title": "Email Integration",
"description": "Send emails and manage email accounts",
"version": "1.0.0",
"remotes": [
{
"type": "streamable-http",
"url": "https://email.example.com/mcp"
}
],
"packages": [
{
"registryType": "npm",
"identifier": "@example/email-integration-mcp",
"version": "1.0.0",
"transport": {
"type": "stdio"
}
}
]
}
원문(영어): https://modelcontextprotocol.io/registry/remote-servers · 본 문서는 학습용 한국어 번역이며 원본의 권리는 원저작자(Model Context Protocol)에게 있습니다.
원문(영어): https://modelcontextprotocol.io/registry/remote-servers