Anthropic 커넥터 디렉토리 FAQ

MCP는 Anthropic이 만든 개방형 표준인 Model Context Protocol의 약자로, AI 애플리케이션이 도구 및 데이터 소스에 연결할 수 있게 해줍니다. MCP에 대한 포괄적인 정보와 시작 방법에 대해서는 원격 MCP 가이드를 참조하세요: 원격 MCP를 사용한 사용자 정의 커넥터 시작하기.

커넥터 디렉토리는 Claude의 모든 플랫폼(Claude 웹, Claude Desktop, Claude 모바일 앱, Claude Code 및 API)에서 작동하는 Model Context Protocol 서버를 선보이는 것을 목표로 합니다. 커넥터 디렉토리는 사용자가 Anthropic이 검토한 MCP 서버를 발견할 수 있는 단일 허브 역할을 합니다.

커넥터 디렉토리 서버 검토 양식을 작성하면, 현재 귀사의 MCP가 디렉토리에 적합한 경우 다음 단계에 대해 연락드리겠습니다.

예, 서버는 MCP 디렉토리 정책에 명시된 보안, 안전 및 호환성 표준을 준수해야 합니다. 이러한 표준 준수가 디렉토리 포함을 보장하지는 않습니다.

모든 제출물을 최대한 빨리 검토하기 위해 노력하고 있지만, 엄청난 관심으로 인해 귀사의 제출물을 수락하거나 개별적으로 응답할 수 있음을 보장할 수 없습니다.

OAuth 2.0은 MCP 서버에 인증이 필요한 경우에만 필수입니다. 인증이 필요하지 않은 서버는 OAuth가 필요하지 않습니다.

아니요. 순수 클라이언트 자격 증명 흐름(client_id/client_secret만 있고 사용자 상호 작용이 없는 기계 간 OAuth)은 지원되지 않습니다. Claude에 대해 정적 client_id/client_secret을 프로비저닝할 수 있지만, 사용자는 여전히 OAuth 동의 흐름을 완료하여 개별 계정을 인증해야 합니다. 이는 claude.ai 및 Claude Desktop에서 작동하지만 Claude Code에서는 작동하지 않습니다. Claude Code는 사용자의 컴퓨터에서 MCP 서버로의 연결을 직접 설정하기 때문입니다(따라서 정적 자격 증명에 액세스할 수 없음).

아니요. OAuth는 사용자를 고유하게 식별하는 유일한 방법입니다. 최종 사용자의 IP 주소, 사용자 ID 또는 기타 메타데이터를 MCP 서버로 전달하지 않습니다.

제품 표면에 따라 다릅니다. 통신은 Anthropic 서버(claude.ai, Claude Desktop), 브라우저 또는 로컬 클라이언트(Claude Code)를 통해 발생합니다. 현재 모든 표면에 걸쳐 중앙 집중식 연결 방법은 없습니다.

원격 MCP 서버(사용자 정의 > 커넥터를 통해 추가된 커넥터)의 경우, 모든 통신은 Anthropic의 클라우드 인프라에서 시작됩니다. 이는 사용 중인 클라이언트 표면(claude.ai, Claude Desktop, Cowork 또는 Claude 모바일 앱)에 관계없이 적용됩니다. MCP 서버는 Anthropic의 IP 범위에서 공개 인터넷을 통해 도달 가능해야 합니다.

Claude Desktop의 claude_desktop_config.json을 통해 구성된 로컬 MCP 서버 또는 Claude Code를 통해 구성된 로컬 MCP 서버는 로컬 네트워킹을 사용하여 컴퓨터에서 직접 통신합니다.

예. 사용자는 서버별로 MCP 서버로 인증합니다. 회사 계정으로 claude.ai에 로그인한 경우에도 MCP 서버에 대해 개인 인증 자격 증명을 사용할 수 있습니다.

아니요. OAuth는 도구 수준이 아닌 클라이언트가 MCP 서버에 연결할 때 발생합니다. 서버 연결이 설정된 후 사용자 인증을 기반으로 도구 수준 권한을 적용할 수 있습니다.

토큰은 Anthropic의 시스템에서 제거되지만 귀사의 시스템에서는 제거되지 않습니다. ID 공급자의 액세스 및 새로 고침 토큰은 만료될 때까지 유효하게 유지되며, 세션 쿠키는 지워지지 않습니다(Claude의 제어 범위 밖인 브라우저 수준이므로).

401 Unauthorized 응답을 반환합니다. DCR 클라이언트 자격 증명의 전체 재생성을 트리거하려면 RFC 6749 섹션 5.2에 따라 invalid_client 오류를 반환합니다.

아니요. 사용자 인증을 사용하는 표준 OAuth 흐름에는 클라이언트 자격 증명이 필요하지 않습니다.

사용자별 속도 제한에는 OAuth가 필요합니다. OAuth 없이 옵션은 다음과 같습니다:

OAuth를 사용하고 IP 허용 목록을 사용하지 않을 것을 강력히 권장합니다. 그러나 https://docs.claude.com/en/api/ip-addresses에서 사용 가능한 정적 IP 주소를 사용하여 이를 수행할 수 있습니다.

중요한 제한 사항:

아니요. MCP 서버 소유자는 자신의 속도 제한 및 악용 방지 조치를 구현해야 합니다.

25,000개 토큰입니다. 필요한 경우 페이지 매김, 필터링 또는 제한 매개변수를 사용하여 응답 크기를 줄입니다.

구성 요소별 타임아웃:

모든 사용자가 커넥터에 액세스할 수 있습니다. 단, 사용자 정의 커넥터는 유료 플랜(Pro, Max, Team, Enterprise)에서만 사용 가능합니다.

아니요. 모든 조직이 플랜 유형에 관계없이 디렉토리에 제출할 수 있습니다.

서버에 인증 또는 계정이 필요한 경우, 초기 QA 목적으로 테스트 계정을 제공해야 합니다. 계정에 더미 데이터를 포함하면 기능을 확인하는 데 도움이 됩니다.

최소 또는 최대 요구사항이 없습니다. 유용한 도구 세트로 시작한 후 시간이 지남에 따라 기능을 확장하는 것을 권장합니다.

현재 특정 SLA 요구사항이 없습니다. 그러나 성능 또는 안정성 문제가 있는 커넥터는 디렉토리에서 제거될 수 있습니다.

주요 문제: 도구 주석 누락(거부의 30%)

요구사항: 모든 도구는 반드시 readOnlyHint 또는 destructiveHint를 포함해야 함

영향: 즉시 거부, 코드 변경 필요

선택사항 아님: MCP 디렉토리 정책에 따른 준수 요구사항

예:

텔레메트리에는 도구 호출에 전달된 모든 매개변수 및 데이터와 MCP 서버의 응답이 포함됩니다.

사용자가 명시적으로 동의한 경우에만 소비자 데이터로 학습합니다. 자세한 내용은 https://www.anthropic.com/news/updates-to-our-consumer-terms를 참조하세요. Team/Enterprise 플랜에서는 학습하지 않습니다.

아니요. MCP 서버는 사용 중인 Claude SKU를 확인할 수 없습니다.

MCP 서비스에 적용되는 회사의 데이터 처리 약관에 대한 URL을 제공하세요. MCP 특화 약관일 필요는 없으며, 표준 DPA로 충분합니다.

커넥터는 Claude 사용자에게 전 세계적으로 제공됩니다. 지역 제한은 지원되지 않습니다. MCP 설명 또는 도구 설명에서 지역 제한 사항을 사용자 및 Claude에 안내할 수 있습니다(예: '미국 조직만 사용 가능').

주요 리소스:

MCP 서버는 Claude와 독립적으로 준수를 처리해야 합니다. 사용자가 서비스에 대한 법적 데이터 보호 권리를 행사하는 경우, 귀사에서 이를 처리해야 합니다.

.mcpb에는 두 가지 필수 위치가 있습니다:

1. README.md - URL 또는 전체 텍스트가 포함된 "개인정보 보호 정책" 섹션을 추가하세요.

2. manifest.json - HTTPS URL이 포함된 privacy_policies 배열을 추가하세요(manifest_version 0.2+ 필요)

예:

포함해야 할 사항: 수집되는 데이터, 사용/저장 방식, 제3자 공유, 보관 기간 및 연락처 정보. ⚠️ 개인정보 보호 정책이 없으면 즉시 거부됩니다.

Google에서 제공하는 파비콘을 사용하므로, 커넥터 URL의 파비콘을 업데이트하여 커넥터의 아이콘 URL을 사용자 정의할 수 있습니다. https://www.google.com/s2/favicons?domain=<YOUR_CONNECTOR_URL>&sz=64에서 사용할 아이콘을 확인할 수 있습니다.

URL의 &sz= 부분을 업데이트하여 각 파비콘 크기(16, 32, 48, 64, 96, 128)를 테스트하세요.

원격 커넥터:

또는 사용하고 싶은 파비콘이 있는 URL을 제공해주세요.

로컬 커넥터(데스크톱 확장): 번들에서 `icon.png`를 교체하고 업데이트된 `.mcpb` 패키지를 사용자에게 재배포하세요.

네. 커넥터 설명에서 마크다운 형식이 지원됩니다.

네. 계정 요구 사항 언어(예: '무료 등록 계정 필수')와 가입 페이지로의 하이퍼링크를 커넥터 세부 정보에 포함하세요.

OAuth 화면을 구현하세요. 이것이 약관 표시를 보장하는 유일한 방법입니다. OAuth 없이는 사용자가 claude_desktop_config.json을 직접 편집하여 Claude Desktop에 커넥터를 추가할 수 있습니다.

커넥터 설명에 언어를 포함하세요. 하지만 특별한 동의 흐름이나 팝업은 없습니다. OAuth 화면을 사용하여 사용자가 약관을 보고 동의하도록 하세요.

Streamable HTTP를 사용해야 합니다.

현재는 도구 수준 설명만 지원됩니다. 서버 수준 설명은 없습니다. 이를 위해서는 개별 도구 설명에 걸쳐 안내 지침을 반복해야 합니다. 이것이 불편하다는 것을 인식하고 있으며 개선 방안을 모색 중입니다.

플러그인 마켓플레이스를 사용하세요. Claude Desktop의 기본 제공 런타임과의 호환성이 더 좋기 때문에 Python이나 다른 언어보다 Node.js를 로컬 MCP에 권장합니다.

로컬 MCP는 ~/Library/Logs/Claude/mcp*.log에만 로그할 수 있습니다. 사용자는 문제 해결을 위해 로그 파일을 수동으로 공유해야 합니다. 보안 제약으로 인해 로컬 MCP 서버에서 직접 로그 전송은 지원되지 않습니다.

IP 허용 목록을 임시로 제거하여 다른 구성이 올바른지 확인하세요. 허용 목록 없이 연결이 작동하면 문제는 IP 필터링 구성에 있습니다.

필수 테스트는 제출 지연의 80%를 방지합니다. 원격 및 로컬 커넥터 제출 가이드에서 모범 사례 및 제출 전 체크리스트를 참조하세요.

이는 일반적으로 MCP 서버가 Anthropic의 클라우드 인프라에서 도달할 수 없다는 의미입니다.

claude.ai, Claude Desktop, Cowork를 포함한 모든 Claude 클라이언트에서 사용자 정의 > 커넥터를 통해 사용자 정의 커넥터를 추가하면 MCP 서버로의 연결은 로컬 머신이 아닌 Anthropic의 서버에서 시작됩니다. Cowork와 Claude Desktop이 컴퓨터에서 실행되더라도 원격 커넥터는 서버 측에서 중개됩니다.

일반적인 원인:

이를 해결하려면:

보안 요구 사항 및 제약에 따라 선택하세요:

옵션 1: 인증 없음 + 전역 속도 제한

최적: 남용 위험이 낮은 공개 데이터

옵션 2: 전체 OAuth 및 사용자 등록

최적: 엔터프라이즈 보안, 민감한 데이터, 사용자별 속도 제한

옵션 3: IP 허용 목록

옵션 3보다 옵션 2를 강력히 권장하지만, OAuth 구현이 정말 불가능한 경우 Claude 사용자만 제한된 액세스를 받을 수 있습니다

중요한 링크: