Antigravity MCP 서버: mcp_config.json에 Sume 추가

Google Antigravity는 Antigravity 2.0, Antigravity CLI, Antigravity IDE에서 MCP를 지원합니다. Sume 같은 커스텀 서버를 추가하려면 "serverUrl": "https://mcp.sume.com/mcp"를 담아 mcp_config.json의 mcpServers 아래에 넣으세요. 파일은 전역으로 쓸 때 ~/.gemini/config/mcp_config.json, 워크스페이스에서 쓸 때 .agents/mcp_config.json입니다. 원격 서버는 반드시 serverUrl을 써야 하며, Antigravity는 url이나 httpUrl을 지원하지 않습니다. 헤더를 넣지 않으면 Antigravity가 Sume 서버가 현재 제공하는 동적 클라이언트 등록을 통해 OAuth를 직접 처리합니다. 아니면 headers로 Sume API 키를 보내세요.

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

mcp_config.json에 Sume를 어떻게 추가하나요?

Antigravity IDE에서는 에이전트 사이드 패널 위쪽의 …를 클릭하고 MCP Servers를 선택한 뒤, Manage MCP Servers와 View raw config로 들어가세요. Antigravity CLI에서는 파일을 직접 편집하세요. /mcp를 입력하면 MCP Manager가 열리며, 서버마다 상태를 보여 주고 설정을 다시 불러옵니다. Antigravity 2.0은 Settings, Customizations, Installed MCP Servers 아래에 서버를 나열합니다. 세 가지 모두 같은 mcpServers 형식을 씁니다.

{
  "mcpServers": {
    "sume": {
      "serverUrl": "https://mcp.sume.com/mcp"
    }
  }
}

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

Antigravity는 동적 클라이언트 등록을 지원하는 서버의 OAuth를 직접 처리하고, Sume 서버는 현재 이를 알리고 있으므로 항목에 oauth 블록이 필요 없습니다.

• Agent Settings를 여세요(Mac에서는 Cmd+, 키, Windows나 Linux에서는 Ctrl+, 키). Customizations 탭으로 가서 서버 옆의 Authenticate를 클릭하세요.
• Sume 동의 페이지에서 로그인하세요. Read는 켜진 채 고정되고 Write는 기본적으로 꺼져 있습니다. 에이전트가 유료 도구를 실행해야 할 때만 Write를 켜세요. 읽기 전용 세션은 유료 도구를 insufficient_scope로 거부합니다.
• 브라우저에서 인가 코드를 복사해 설정 패널에 붙여 넣고 Submit을 클릭하세요. 서버가 다시 연결됩니다.
• Antigravity는 토큰을 ~/.gemini/antigravity/mcp_oauth_tokens.json에 저장하며, 만료된 토큰은 자동으로 갱신된다고 설명합니다. 현재 코드에서 Sume는 리프레시 토큰을 발급하지 않고 토큰은 한 시간 동안 유효하므로, 다시 인증할 일이 생긴다고 생각하세요.

대신 API 키를 쓰려면 어떻게 하나요?

headers 객체를 추가하세요. Sume는 Authorization: Bearer나 x-api-key를 받으며, API 키 세션에는 쓰기·유료 도구를 포함한 전체 호스팅 도구 세트가 보입니다. Antigravity MCP 페이지는 헤더 값을 파일에 직접 적는 방식을 보여 주므로, 이 항목은 워크스페이스의 .agents/mcp_config.json이 아니라 전역 파일에 넣고 버전 관리에서 빼 두세요. Sume 문서는 키를 신뢰할 수 있는 서버, CI 시크릿 저장소, 로컬 개발 머신에 두라고 합니다.

{
  "mcpServers": {
    "sume": {
      "serverUrl": "https://mcp.sume.com/mcp",
      "headers": { "Authorization": "Bearer <SUME_API_KEY>" }
    }
  }
}

Sume 유료 도구를 어떻게 승인 뒤에 두나요?

Antigravity는 따로 설정하지 않은 MCP 도구를 Ask 모드로 실행하며, 이 모드에서는 도구가 실행되기 전에 여러분의 승인이 필요합니다. 허용 규칙은 mcp(server/tool), mcp(server/*), mcp(*) 형식으로 도구를 지정합니다. mcp(sume/tools_list) 같은 읽기 도구를 허용하는 것은 괜찮지만, mcp(sume/*)나 mcp(*)를 허용하면 유료 도구가 묻지 않고 실행됩니다. Sume 자체 게이트도 그대로 적용됩니다. 유료 호출에는 idempotency_key가 필요하고, dry_run=true는 제출하지 않고 접수 여부와 비용을 미리 보여 주며, max_spend_usd는 값을 넘긴 경우에만 호출의 상한이 됩니다.

Gemini CLI 설정을 그대로 쓸 수 있나요?

그대로는 쓸 수 없습니다. Gemini CLI는 settings.json에서 MCP 서버를 읽고 스트리밍 HTTP 엔드포인트에 httpUrl을 쓰는데, Antigravity는 원격 서버에 이 키를 지원하지 않으므로 대신 URL을 mcp_config.json의 serverUrl에 옮겨 적으세요. 그 클라이언트는 Gemini CLI MCP 서버: Sume 호스팅 MCP 추가하기에서 다룹니다. 연결되면 에이전트에게 mcp_health를 호출한 다음, 세션에 보이는 모든 도구를 나열하는 tools_list를 호출해 달라고 하세요. Sume MCP 도구 목록은 도구를 읽기, 쓰기, 유료로 나눠 정리합니다.