MCP 빠른 시작

이 문서는 영문 원고를 AI로 번역한 내용이라 표현이 어색할 수 있습니다.

원격 MCP 클라이언트를 Sume 프로덕션 엔드포인트에 연결하고, OAuth를 완료하거나(또는 API 키를 사용해) 읽기 전용 탐색 도구를 호출해 보세요.

1. 프로덕션 URL 사용하기

채팅에 API 키를 붙여 넣지 마세요. 인터랙티브 클라이언트에서는 OAuth 커넥터 플로를 사용하는 편이 좋습니다.

Claude Code의 MCP 상태 UI에서 서버가 연결됐는지 확인한 다음, Claude에게 tools.list나 mcp.health를 호출해 달라고 하세요.

원격 MCP 서버 항목을 추가하세요(Cursor Settings → MCP, 또는 MCP 설정 파일).

Cursor가 물어보면 OAuth 로그인을 완료하세요. 연결한 뒤 tools.list를 한 번 호출해 세션을 확인합니다.

스트리밍 가능한 HTTP MCP 서버를 다음 주소로 지정하세요.

해당 클라이언트에서 설정한 서버 이름으로 OAuth 로그인을 실행합니다. 클라이언트는 MCP 엔드포인트에서 Sume protected-resource 메타데이터를 찾아 app.sume.com의 Sume 로그인으로 보냅니다.

에이전트에게 이렇게 요청하세요.

처음 호출해 보면 좋은 도구입니다.

도구	이유
`mcp.health`	엔드포인트, 인증 출처, 안전 설정을 확인합니다.
`tools.list`	이 세션에서 보이는 모든 도구를 나열합니다.
`tools.schema`	`name`으로 도구 하나의 계약을 반환합니다.
`account.me`	워크스페이스 계정 컨텍스트를 확인합니다.
`catalog.list`	공개 API 기능을 나열합니다(MCP 도구보다 범위가 넓습니다).

호스팅 OAuth Phase 1은 읽기 전용 접근(mcp:read)만 허용합니다.

OAuth를 쓰면 다음과 같습니다.

오늘 쓰기나 유료 MCP 도구를 실행하려면 API 키 원격 MCP 세션이나 Developer API / CLI를 사용하세요. OAuth와 API 키, 도구와 게이트에서 살펴보세요.

에이전트가 로컬 머신에서 셸 명령어를 실행할 수 있다면, 오늘은 CLI 명령어를 직접 쓰는 편이 좋습니다(sume login, sume tools list --json, Avatar 제출 + sume jobs …). CLI 개요에서 살펴보세요.

로컬 sume mcp는 현재 CLI 릴리스에서 출시되지 않았습니다(coming_soon). mcp.sume.com의 호스팅 커넥터와는 별개의 표면입니다. 클라이언트가 원격 HTTP MCP를 지원한다면 호스팅 MCP를 사용하세요.

Studio Agent는 앱 안의 Sume 에이전트 제품입니다. 이 문서들이 다루는 공개 호스팅 MCP 커넥터가 아닙니다. Studio Agent 내부 주소를 고객 MCP 서버 URL로 설정하지 마세요.