Amazon Q MCP 서버: IDE에 Sume 호스팅 MCP 추가

IDE의 Amazon Q Developer에 MCP 서버를 추가하려면 Q Developer 채팅 패널에서 도구 아이콘을 선택하고 더하기(+) 기호를 고른 뒤 트랜스포트를 정하세요. 로컬 서버라면 명령과 함께 stdio를, 원격 서버라면 URL과 함께 http를 씁니다. Sume 호스팅 서버라면 http를 선택하고 https://mcp.sume.com/mcp를 입력한 다음, Sume API 키를 담은 x-api-key 헤더를 추가하거나 헤더를 비워 두세요. 헤더가 비어 있으면 Amazon Q가 브라우저 페이지를 열어 여러분이 직접 인가하게 합니다.

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

Amazon Q MCP 구성에 Sume를 어떻게 추가하나요?

• IDE(VS Code, JetBrains 등)에서 Q Developer 패널을 열고 Chat 패널을 연 다음 도구 아이콘을 선택합니다.
• 더하기(+) 기호를 선택하고 전역 또는 로컬 중 스코프를 고릅니다.
• Name에 sume 같은 이름을 입력하고, 트랜스포트 프로토콜로 http를 선택한 뒤, URL 필드에 https://mcp.sume.com/mcp를 입력합니다.
• Headers - optional 아래에 API 키 세션용 키-값 쌍을 추가하거나, 브라우저에서 인가하려면 비워 둡니다.
• Timeout 값을 입력하고 Save를 선택합니다. 그러면 양식 대신 도구 권한 패널이 나타납니다.
• Amazon Q가 연결하지 못하면 패널에 알림이 나타나며, Fix Configuration을 누르면 양식으로 돌아갑니다.

Amazon Q는 서버를 어디에 저장하나요?

전역 스코프는 모든 프로젝트에서 쓸 수 있는 ~/.aws/amazonq/default.json에 기록합니다. 로컬 스코프는 현재 프로젝트 안의 .amazonq/default.json에 기록하며, 워크스페이스 수준 구성이 우선합니다. Amazon Q는 기본적으로 같은 두 폴더의 레거시 mcp.json 파일도 읽습니다. API 키 헤더는 전역 스코프에 넣으세요. 로컬 파일은 프로젝트 안에 있고, Sume 문서는 키를 절대 커밋하지 말라고 합니다.

OAuth와 API 키 중 무엇을 써야 하나요?

헤더가 없으면 Amazon Q는 엔드포인트가 인가를 요구할 때 브라우저 페이지를 여는데, Sume 엔드포인트는 인가를 요구합니다. 인증되지 않은 클라이언트에는 OAuth 챌린지로 응답하고, 로그인은 mcp.sume.com의 동의 페이지로 이어집니다. 동의 페이지에서 Read는 켜진 채 고정되고 Write는 기본적으로 꺼져 있으므로, Write를 켜기 전까지 generate_image 같은 유료 도구는 숨겨져 있고 호출하면 insufficient_scope를 반환합니다. 현재 코드에서 Sume OAuth 토큰은 한 시간 동안 유효하며, Sume는 리프레시 토큰을 발급하지 않습니다. Amazon 페이지는 브라우저 페이지 이후의 로그인 과정을 설명하지 않으므로, 로그인이 끝나지 않으면 API 키 헤더를 쓰세요.

API 키를 쓰려면 x-api-key 헤더에 키를 값으로 넣거나, Authorization 헤더에 Bearer <SUME_API_KEY>를 넣으세요. API 키 세션에는 쓰기·유료 도구를 포함한 전체 호스팅 도구 세트가 보이므로, 아래 도구 권한이 더 중요해집니다.

Sume 유료 도구가 실행되기 전에 Amazon Q가 묻게 하려면 어떻게 하나요?

MCP Servers 패널을 열고 Sume 서버를 선택한 뒤 도구마다 수준을 정하세요. Ask는 도구를 쓸 때마다 묻고, Always allow는 묻지 않고 실행하며, Deny는 도구를 쓰지 못하게 합니다. Sume도 자체 게이트를 더합니다. 모든 유료 호출에는 idempotency_key가 필요하고, dry_run=true는 제출하지 않고 접수 여부와 비용을 미리 보여 주며, max_spend_usd는 값을 넘긴 경우에만 호출의 상한이 됩니다.

타임아웃에는 어떤 값을 입력해야 하나요?

Amazon의 HTTP 절차에는 기본값이 없고, STDIO 예시는 권장값인 60초를 그대로 둡니다. Sume jobs_wait 호출 한 번보다 긴 값을 입력하세요. 이 호출은 최대 55초, 기본 50초 동안 열려 있습니다. wait_slice_expired를 받으면 에이전트는 같은 id로 jobs_wait를 다시 호출해야 하며, 유료 create는 절대 다시 제출하면 안 됩니다. 이 패턴은 긴 영상 Job의 MCP 도구 호출 타임아웃에서 다룹니다.

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