Android Studio MCP 서버: Gemini 에이전트에 Sume 추가

Android Studio에 MCP 서버를 추가하려면 File(macOS에서는 Android Studio) > Settings > Tools > AI > MCP Servers로 가서 Enable MCP Servers를 선택하고, 설정 필드의 mcpServers 아래에 서버를 추가한 뒤 OK를 클릭하세요. 그러면 Gemini 에이전트가 그 서버의 도구를 쓸 수 있습니다. Android Studio는 HTTP로만 연결합니다. Streamable HTTP에는 httpUrl, SSE에는 url을 쓰며, stdio 서버는 쓸 수 없습니다. Sume 호스팅 MCP 서버라면 httpUrl은 https://mcp.sume.com/mcp이고, Sume API 키를 담은 Authorization: Bearer 헤더를 함께 넣습니다.

Android Studio 쪽 내용은 Google의 MCP 서버 추가와 에이전트 권한 관리 페이지에서, Sume 쪽 내용은 MCP OAuth와 API 키, MCP 빠른 시작, MCP 도구와 게이트, Job과 결과 (영문)에서 가져왔으며, 모두 2026-09-28에 확인했습니다. Sume에는 Android Studio 전용 연동이 없습니다. IDE는 다른 원격 MCP 서버와 똑같이 Sume 원격 MCP 서버에 연결하며, Sume 기초 페이지는 호스팅 MCP가 여전히 동작하지만 현재 주 경로는 아니라고 설명합니다. Gemini CLI는 Gemini CLI MCP 서버를 참고하세요.

Android Studio의 mcp.json에는 무엇을 넣나요?

Google 예시와 같은 형태의 sume 항목 하나입니다. Android Studio는 이 필드를 설정 디렉터리의 mcp.json 파일에 저장하고 헤더 값도 그 파일에 들어가므로, 공유하거나 동기화하는 설정에 이 파일을 넣지 말고 키가 유출되면 교체하세요. Sume는 키를 Authorization: Bearer나 x-api-key로 받습니다.

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

키 대신 OAuth로 Sume에 로그인할 수 있나요?

시도해 볼 수는 있습니다. OK를 클릭하면 Android Studio는 Successfully connected to MCP server...나 오류를 표시합니다. 인증이 필요한 서버는 인가에 실패하면 Error connecting to transport: Authorization Exception을 반환하며, Start Login을 누르면 브라우저에서 서버의 로그인 페이지가 열리고 그다음 연결을 다시 시도합니다. 헤더가 없으면 Sume는 OAuth 챌린지와 protected-resource 메타데이터로 응답하고, 동의는 Sume MCP 호스트에서 이뤄지며, Read는 켜진 채 고정되고 Write는 기본적으로 꺼져 있습니다. 읽기 전용 세션은 generate_image 같은 유료 도구를 실행할 수 없으며, 이런 도구는 insufficient_scope를 반환합니다.

두 가지 주의점 때문에 키 헤더가 더 안정적인 방법입니다. Google은 GitHub 같은 일부 MCP 서버의 OAuth 로그인을 Android Studio가 지원하지 않는 기능으로 꼽습니다. 또한 현재 Sume 코드에서 OAuth 액세스 토큰은 리프레시 토큰 없이 한 시간 동안 유효하므로, 로그인에 성공하더라도 대략 한 시간마다 다시 해야 합니다.

Gemini는 Sume 도구를 호출하기 전에 물어보나요?

네, 전에 승인한 적이 없다면 물어봅니다. 에이전트 권한에는 MCP 서버와의 상호작용이 포함됩니다. 에이전트는 아직 부여하지 않은 권한이 필요할 때 물어보며, 한 번만 할 작업이면 Allow로, 신뢰할 수 있는 반복 워크플로라면 Always allow로 답합니다. Google은 상위 권한을 부여하면 관련 하위 도구도 자동으로 승인된다고 덧붙이지만, 이것이 MCP 도구를 어떻게 묶는지는 페이지에 나와 있지 않습니다. 부여한 권한은 File(macOS에서는 Android Studio) > Settings > Tools > AI > Agent Permissions에서 점검할 수 있습니다.

Sume 유료 도구에는 Always allow가 아니라 Allow로 답하세요. API 키 세션에는 Sume의 전체 호스팅 도구 세트가 보이고, 지출은 키가 속한 워크스페이스에 잡힙니다. 유료 호출마다 idempotency_key가 필요하고, dry_run=true는 Job을 제출하지 않고 접수 여부와 비용을 미리 보여 주며, max_spend_usd는 값을 보낸 경우에만 호출의 상한이 됩니다. 채팅에 /mcp를 입력해 Gemini가 쓸 수 있는 도구 목록을 본 다음, 엔드포인트, 인증 출처, 안전 설정을 확인해 주는 mcp_health를 호출해 달라고 하세요.

이 설정에는 어떤 한계가 있나요?

• Android Studio에서는 stdio 서버, MCP 리소스, 프롬프트 템플릿을 쓸 수 없습니다. 현재 코드에서 Sume 서버는 tools capability만 선언하므로, Sume 쪽에서 잃는 기능은 없습니다.
• 로컬 파일은 쓸 수 없습니다. 호스팅 MCP는 노트북의 파일을 읽을 수 없고, Sume 생성 요청은 미디어를 공개 HTTPS URL로 받으므로, 에이전트가 프로젝트 폴더의 이미지를 Sume에 넘길 수 없습니다.
• 도구 호출 타임아웃: Google 페이지는 연결 timeout만 설명합니다. Sume의 jobs_wait는 호출 한 번을 최대 55초 동안 붙잡아 두며, wait_slice_expired를 받으면 에이전트는 같은 id로 다시 호출해야 하고, 유료 create는 절대 다시 제출하면 안 됩니다.
• Android Studio에서도 실행할 수 있는 GitHub Copilot 플러그인은 MCP 설정 방식이 다릅니다. IntelliJ GitHub Copilot MCP 설정을 참고하세요.