goose MCP 서버: Sume 호스팅 MCP를 확장으로 추가

goose에 MCP 서버를 추가하려면 확장(extension)으로 설치하세요. Command-line Extension은 로컬 명령을 실행하고, Remote Extension (Streamable HTTP)은 URL에 연결합니다. Sume 호스팅 MCP라면 Extensions 사이드바, goose configure, 딥링크, ~/.config/goose/config.yaml 중 하나로 URL이 https://mcp.sume.com/mcp인 Remote Extension을 추가하세요. goose는 보통 OAuth 클라이언트 ID를 스스로 받아 오며, 여러분은 Sume 동의 페이지에서 접근을 승인합니다.

goose 쪽 내용은 확장 사용하기, goose 권한 모드, 도구 권한 관리 페이지에서, Sume 쪽 내용은 MCP 빠른 시작, OAuth와 API 키, MCP 도구와 게이트, Job과 결과 (영문)에서 가져왔으며, 모두 2026-09-27에 확인했습니다. 따로 밝힌 부분은 현재 서버 코드에서 가져왔습니다. Sume에는 goose 전용 커넥터가 없으며, 이 방식은 일반적인 원격 MCP 연결입니다. Sume 기초 페이지는 호스팅 MCP가 여전히 동작하지만 현재 주 연동 경로는 아니라고 설명합니다.

Sume를 goose 확장으로 어떻게 추가하나요?

• goose Desktop: 사이드바를 열고 Extensions, Add custom extension을 차례로 클릭한 뒤 모달을 채웁니다. 모달의 Timeout 필드는 이 확장의 도구 호출이 끝날 때까지 goose가 기다리는 시간을 정합니다.
• goose CLI: goose configure를 실행하고 Add Extension, Remote Extension (Streamable HTTP)을 차례로 고른 뒤 안내를 따릅니다.
• 딥링크: goose://extension?url=https%3A%2F%2Fmcp.sume.com%2Fmcp&type=streamable_http&timeout=300&id=sume&name=Sume&description=Sume%20tools. 모든 파라미터는 URL 인코딩합니다.
• 세션 하나에서만 쓰기: goose session --with-streamable-http-extension "https://mcp.sume.com/mcp"를 실행하면 설치하지 않고 켤 수 있습니다.

extensions:
  sume:
    name: Sume
    type: streamable_http
    uri: https://mcp.sume.com/mcp
    enabled: true
    timeout: 300

goose는 Sume에 어떻게 로그인하나요?

OAuth로 로그인합니다. goose 문서에 따르면 OAuth가 필요한 원격 확장은 보통 Client ID Metadata Documents나 Dynamic Client Registration을 통해 클라이언트 ID를 자동으로 받습니다. 현재 코드에서 Sume 서버는 등록 엔드포인트를 알리므로 항목에서 client_id는 빼 두세요. goose는 client_id를 두 방식 모두 지원하지 않는 서버용으로 설명합니다. goose는 127.0.0.1의 임시 포트에서 OAuth 콜백을 받고, 현재 Sume 코드는 localhost와 127.0.0.1로 가는 http 리다이렉트를 허용합니다. goose 페이지는 원격 확장에 대해 커스텀 헤더가 아니라 OAuth를 설명하므로, 이 설정은 API 키 대신 OAuth를 씁니다.

Sume 동의 페이지에서 Read는 켜진 채 고정되고 Write는 기본적으로 꺼져 있습니다. scopes를 지정하지 않으면 goose는 Sume가 알리는 스코프를 요청하지만, Sume는 여러분이 Write를 켰을 때만 mcp:write를 부여합니다. Write가 꺼져 있으면 generate_image 같은 유료 도구는 숨겨지고, 호출하면 insufficient_scope를 반환합니다. 현재 코드에서 Sume 토큰은 한 시간 동안 유효하고 Sume는 리프레시 토큰을 발급하지 않으므로, 그 뒤에는 다시 로그인해야 한다고 생각하세요.

goose가 Sume 유료 도구를 알아서 실행하지 않게 하려면 어떻게 하나요?

모드를 바꾸세요. goose는 기본적으로 Autonomous 모드를 적용하는데, 이 모드는 승인 없이 확장을 사용하므로 Write가 켜져 있으면 묻지 않고 Sume 유료 Job을 시작할 수 있습니다. CLI에서는 /mode approve로 Manual Approval로, /mode smart_approve로 Smart Approval로 바꿉니다. goose Desktop에서는 하단 메뉴의 모드 버튼이나 Settings > Chat > Mode를 쓰세요. 유료 호출 전에 제출하지 않고 접수 여부와 비용을 미리 보여 주는 dry_run=true로 먼저 실행해 달라고 goose에게 요청할 수도 있습니다.

Manual이나 Smart 모드에서는 도구마다 Always Allow, Ask Before, Never Allow 중 하나로 설정할 수도 있습니다. goose 페이지는 이 모드에서 goose가 쓰기 도구로 판단한 도구에 대해서만 묻는다고 덧붙이는데, 이 판단은 LLM 제공자가 해석하는 최선의 추정(best-effort) 분류이므로 Sume 유료 도구는 명시적으로 Ask Before로 설정하세요. goose의 도구 권한 페이지는 모든 확장을 합쳐 켜 둔 도구가 25개 미만일 때 goose가 가장 잘 동작한다고 하며, 작업에 필요 없는 도구는 끄라고 권합니다.

Sume 확장의 타임아웃은 얼마로 해야 하나요?

55초보다 길게 하세요. goose의 timeout은 확장 응답을 기다리는 최대 시간(초)이며, goose 예시는 300을 씁니다. Sume의 jobs_wait는 호출 한 번을 최대 55초, 기본 50초 동안 열어 둡니다. wait_slice_expired를 받으면 goose는 같은 id로 다시 호출해야 하며, 유료 create는 절대 다시 제출하면 안 됩니다.

연결을 확인하려면 goose에게 엔드포인트, 인증 출처, 안전 설정을 확인해 주는 mcp_health를 호출한 다음, 세션에 보이는 모든 도구를 나열하는 tools_list를 호출해 달라고 하세요.