Claude API MCP 커넥터와 Sume: 지금 쓸 수 있는 방법

현재 Claude API의 MCP 커넥터를 Sume 호스팅 MCP 서버에 인증하는 방법은 문서화되어 있지 않습니다. 커넥터의 유일한 자격 증명 필드인 authorization_token에는 애플리케이션이 직접 얻은 OAuth 토큰이 들어가는데, Sume 문서는 Sume OAuth 토큰을 서드파티 프로바이더로 전달하지 말고, 우회 목적으로 호스팅 OAuth 클라이언트용 API 키를 발급하지도 말라고 합니다. 코드에서 Claude가 Sume 도구를 쓰게 하려면 직접 정한 헤더를 보내는 클라이언트를 쓰세요. Claude Agent SDK MCP 서버: API 키로 Sume 연결에서 다루는 Claude Agent SDK가 그런 예입니다.

커넥터 관련 사실은 Claude MCP 커넥터 페이지와 Create a Message (Beta) 레퍼런스에서, Sume 쪽 내용은 OAuth와 API 키, MCP 빠른 시작, MCP 도구와 게이트에서 가져왔으며, 모두 2026-09-27에 확인했습니다. Sume는 Claude API용 패키지나 커넥터를 배포하지 않으며, Sume 기초 페이지는 호스팅 MCP가 여전히 동작하지만 현재 주 경로는 아니라고 설명합니다.

MCP 커넥터는 서버에 무엇을 요구하나요?

커넥터는 anthropic-beta: mcp-client-2025-11-20 헤더로 켜는 베타 기능이며, 두 부분으로 이뤄집니다. 하나는 mcp_servers의 서버 정의이고, 다른 하나는 서버의 도구를 전부 또는 허용 목록에 있는 것만 켜는 tools의 MCPToolset입니다. 트랜스포트 면에서는 Sume 엔드포인트가 조건에 맞습니다. https://mcp.sume.com/mcp는 https://로 시작하고, Sume 빠른 시작 문서는 streamable HTTP 클라이언트에 이 주소를 지정하라고 안내하는데, streamable HTTP는 커넥터가 지원하는 두 트랜스포트 중 하나입니다. 맞지 않는 것은 자격 증명입니다.

authorization_token에는 왜 Sume 자격 증명을 담을 수 없나요?

Claude 페이지는 API 사용자가 OAuth 플로를 직접 처리하고, 호출 전에 액세스 토큰을 받아 두고, 필요할 때 토큰을 갱신해야 한다고 설명합니다. 베타 레퍼런스에는 커스텀 헤더를 넣을 필드가 없습니다. 서버 정의의 필드는 type, name, url, authorization_token, 그리고 지원 중단된 tool_configuration입니다. Sume 호스팅 MCP는 OAuth 액세스 토큰이나 Sume API 키를 받는데, 두 자격 증명은 서로 바꿔 쓸 수 없고, 키는 Authorization: Bearer <SUME_API_KEY>나 x-api-key로 전달됩니다. 어느 자격 증명도 커넥터 안에 넣을 자리가 문서화되어 있지 않습니다.

• Sume OAuth 토큰은 Sume가 MCP 클라이언트를 위해 운영하는 동의 플로에서 발급되며, Sume 자격 증명 안전 수칙은 OAuth 토큰을 서드파티 프로바이더로 전달하지 말라고 합니다. 이 토큰을 authorization_token에 넣어 보내면 Anthropic API로 토큰을 넘기게 됩니다.
• 두 페이지 어디에도 Sume API 키를 authorization_token에 넣으라는 설명은 없으며, Sume 수칙은 우회 목적으로 호스팅 OAuth 클라이언트용 API 키를 발급하지 말라고 합니다.
• 자격 증명 없이 연결하면 Sume는 OAuth 챌린지와 protected-resource 메타데이터로 응답합니다.

대신 무엇을 쓸 수 있나요?

문서화된 설정으로 Sume 자격 증명 중 하나를 실어 보낼 수 있는 클라이언트를 쓰세요. 어떤 클라이언트를 고르든 Sume 게이트는 같습니다. generate_video 같은 유료 도구에는 idempotency_key가 필요하고, dry_run=true는 Job을 제출하지 않고 접수 여부와 비용을 미리 보여 주며, jobs_wait는 호출 한 번을 최대 55초 동안 붙잡아 둡니다. Sume MCP 도구 목록은 도구를 읽기, 쓰기, 유료로 나눠 정리합니다.

• Claude Agent SDK: HTTP 서버 설정이 인증 헤더를 직접 받으므로 Sume API 키 헤더를 보낼 수 있습니다. 설정 방법은 Claude Agent SDK MCP 서버에 있습니다.
• 자체 MCP 클라이언트: Claude 페이지는 연결을 더 세밀하게 제어해야 할 때 SDK의 클라이언트 쪽 MCP 헬퍼를 쓰라고 안내하며, Sume는 OAuth를 쓰지 않는 자동화를 위해 API 키 원격 MCP를 유지합니다.
• Claude 앱: Claude 자체의 커넥터 화면은 Claude 커스텀 커넥터로 Sume 추가하기에서 다룹니다.
• MCP 없이: Sume 기초 페이지는 HTTP로 호출하는 Format API를 대부분의 파트너가 연동해야 할 표면으로 꼽습니다. 선택지 비교는 AI 에이전트용 MCP vs CLI vs API에 있습니다.

커넥터에는 또 어떤 제한이 있나요?

Claude 페이지는 Sume만이 아니라 모든 서버에 해당하는 제한으로 다음을 꼽습니다.

• Claude API, Claude Platform on AWS, Microsoft Foundry에서는 베타이고, Amazon Bedrock과 Google Cloud에서는 제공되지 않습니다.
• MCP 기능 가운데 도구 호출만 지원합니다.
• 서버는 Streamable HTTP나 SSE로 HTTP를 통해 공개되어 있어야 하며, 로컬 STDIO 서버는 직접 연결할 수 없습니다.
• 커넥터에는 ZDR(zero data retention) 약정이 적용되지 않습니다. MCP 서버와 주고받은 도구 정의와 결과는 Anthropic의 표준 데이터 보존 정책을 따릅니다.
• mcp-client-2026-09-15 베타 헤더는 서버마다 도구 목록을 기록해 두고 그 목록을 고정할 수 있게 해 줍니다. 이전 mcp-client-2025-04-04 헤더는 지원 중단되었습니다.