Android Studio 에이전트의 Gemini는 모델 컨텍스트 프로토콜 (MCP)을 사용하여 외부 도구와 상호작용할 수 있습니다. 이 기능은 에이전트 모드가 도구를 사용하고 외부 환경으로 지식과 기능을 확장하는 표준화된 방법을 제공합니다.
Android 스튜디오에서 MCP 호스트에 연결할 수 있는 도구는 다양합니다. 예를 들어 GitHub MCP 서버와 통합하여 Android Studio에서 직접 pull 요청을 만들거나 Figma 원격 MCP 서버와 통합하여 데스크톱 앱을 다운로드하지 않고도 디자인 정보를 제공할 수 있습니다. 자세한 내용은 MCP 예시 서버를 참고하세요.
MCP 서버를 추가하려면 다음 단계를 따르세요.
- 파일 (macOS의 경우 Android 스튜디오) > 설정 > 도구 > Gemini > MCP 서버를 클릭하여 MCP 서버 설정으로 이동합니다.
- MCP 서버 사용 설정을 선택합니다.
- 제공된 필드에 MCP 구성을 추가합니다. 구성 파일은 Android 스튜디오의 구성 디렉터리에 있는
mcp.json파일에 저장됩니다. - OK(확인)을 클릭합니다.
다음 예시는 서버 구성이 여러 개 있는 mcp.json 파일을 보여줍니다.
{
"mcpServers": {
"figma": {
"httpUrl": "https://mcp.figma.com/mcp"
},
"github": {
"httpUrl": "https://api.githubcopilot.com/mcp/",
"headers": {
"Authorization": "Bearer <YOUR_PERSONAL_ACCESS_TOKEN>"
}
},
"gitlab": {
"httpUrl": "https://gitlab.com/api/v4/mcp"
},
"canva": {
"httpUrl": "https://mcp.canva.com/mcp"
},
"notion": {
"httpUrl": "https://mcp.notion.com/mcp"
},
"linear": {
"httpUrl": "https://mcp.linear.app/mcp"
}
}
}
이 파일에 나열할 정확한 구성 값은 통합하려는 MCP 서버의 문서를 참고하세요.
인증
확인을 클릭하면 'MCP 서버에 연결되었습니다...'라는 알림이 표시되거나 오류를 설명하는 알림이 표시됩니다. 대부분의 원격 MCP 서버에는 인증이 필요하므로 인증에 실패하면 '전송 연결 오류: 승인 예외'가 반환됩니다.
로그인 시작을 클릭하여 해당 서버의 인증 프로세스를 시작합니다. 브라우저에서 해당 서버의 로그인 페이지에 로그인하라는 메시지가 표시됩니다. 로그인하면 연결이 다시 시도되고, 성공하면 'MCP 서버에 연결되었습니다...' 알림이 표시됩니다.
MCP 도구 사용
Android 스튜디오에서 Gemini에 사용할 수 있는 도구를 확인하려면 채팅에 /mcp를 입력하세요.
그런 다음 채팅에서 도구를 참조할 수 있습니다(예: 'GitHub에서 내 저장소 목록을 표시해 줘').
구성
이 섹션에서는 모든 MCP 서버 구성 옵션을 설명합니다.
HTTP MCP 서버
다음 표에는 스트림 가능 HTTP 전송을 통해 MCP 서버에 연결하기 위한 구성 옵션이 나와 있습니다.
| 이름 | 유형 | 설명 |
|---|---|---|
httpUrl |
문자열 | 필수 항목입니다. 스트리밍 가능한 HTTP 엔드포인트의 전체 URL (예: https://example.com/mcp 또는 http://localhost:1234/mcp)입니다. |
headers |
맵<String, String> | 연결 요청에 포함할 맞춤 HTTP 헤더의 맵입니다.
기본값은 {} (빈 지도)입니다. |
timeout |
시간 | 연결 제한 시간(밀리초)입니다. -1은 제한 시간이 없음을 나타냅니다. 기본값은 -1입니다. |
enabled |
불리언 | 이 서버 구성이 활성 상태인지 여부입니다. 기본값은 true입니다. |
제한사항
Android 스튜디오의 MCP 통합은 다음 기능을 지원하지 않습니다.
stdio전송을 통한 MCP 서버 연결- MCP 리소스
- 프롬프트 템플릿
- GitHub와 같은 일부 MCP 서버를 사용한 OAuth 로그인