MCP 서버 추가

Android 스튜디오 에이전트의 Gemini는 모델 컨텍스트 프로토콜 (MCP)을 사용하여 외부 도구와 상호작용할 수 있습니다. 이 기능은 에이전트 모드가 도구를 사용하고 외부 환경으로 지식과 기능을 확장하는 표준화된 방법을 제공합니다.

Android 스튜디오에서 MCP 호스트에 연결할 수 있는 도구는 다양합니다. 예를 들어 GitHub MCP 서버와 통합하여 Android 스튜디오에서 직접 풀 요청을 만들거나 Figma 원격 MCP 서버와 통합하여 데스크톱 앱을 다운로드하지 않고도 디자인 정보를 제공할 수 있습니다. 자세한 내용은 MCP 예시 서버를 참고하세요.

MCP 서버를 추가하려면 다음 단계를 따르세요.

  1. 파일 (macOS의 경우 Android 스튜디오) > 설정 > 도구 > Gemini > MCP 서버를 클릭하여 MCP 서버 설정으로 이동합니다.
  2. MCP 서버 사용 설정을 선택합니다.
  3. 제공된 필드에 MCP 구성을 추가합니다. 구성 파일은 Android 스튜디오의 구성 디렉터리에 있는 mcp.json 파일에 저장됩니다.

다음은 mcp.json 파일의 예입니다.

{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-memory"
      ]
    },
    "sequential-thinking": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-sequential-thinking"
      ]
    },
    "github": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GITHUB_PERSONAL_ACCESS_TOKEN",
        "ghcr.io/github/github-mcp-server"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
      }
    }
    "figmaRemoteMcp": {
      "httpUrl": "https://mcp.figma.com/mcp"
    }
  }
}

이 파일에 나열해야 하는 정확한 구성 값은 통합하려는 MCP 서버의 문서를 참고하세요. MCP 서버의 소프트웨어 요구사항에 따라 Node.js 또는 Docker와 같은 도구를 설치해야 할 수도 있습니다.

구성

다음은 전체 MCP 서버 구성 옵션입니다.

로컬 MCP 서버

다음 표에는 MCP 서버를 로컬 백그라운드 프로세스로 실행하기 위한 구성 옵션이 나와 있습니다.

이름 유형 설명
command 문자열 필수 항목입니다. 실행할 실행 파일 또는 명령어 (예: npx, ./my-server)
args List<String> 선택사항입니다. 실행 파일에 전달할 명령줄 인수 목록입니다. 기본값은 [] (빈 목록)입니다.
env Map<String, String> 선택사항입니다. 프로세스에 설정할 환경 변수의 맵입니다. 기본값은 {}(빈 지도)입니다.
enabled 부울 선택사항입니다. 이 서버 구성이 활성 상태인지 여부입니다. 기본값은 true입니다.

원격 MCP 서버

다음 표에는 스트림 가능 HTTP 전송을 통해 MCP 서버에 연결하기 위한 구성 옵션이 나와 있습니다.

이름 유형 설명
httpUrl 문자열 필수 항목입니다. 스트리밍 가능한 HTTP 엔드포인트의 전체 URL입니다 (예: https://server.com/mcp).
headers Map<String, String> 연결 요청에 포함할 맞춤 HTTP 헤더의 맵입니다. 기본값은 {} (빈 지도)입니다.
timeout Long 연결 제한 시간(밀리초)입니다. -1은 제한 시간이 없음을 나타냅니다. 기본값은 -1입니다.
enabled 부울 이 서버 구성이 활성 상태인지 여부입니다. 기본값은 true입니다.

제한사항

다음 기능은 아직 Android 스튜디오의 MCP 통합에서 지원되지 않습니다.

  • MCP 리소스
  • 프롬프트 템플릿
  • 상담사가 get_screenshot와 같은 도구를 사용하여 이미지를 가져올 때 채팅 창에 이미지가 렌더링됩니다.