Adicionar um servidor MCP

O agente do Gemini no Android Studio pode interagir com ferramentas externas usando o Protocolo de Contexto de Modelo (MCP). Esse recurso oferece uma maneira padronizada para o modo Agente usar ferramentas e ampliar conhecimentos e recursos com o ambiente externo.

Há muitas ferramentas que podem ser conectadas ao host do MCP no Android Studio. Por exemplo, você pode fazer a integração com o servidor MCP do GitHub para criar solicitações de pull diretamente do Android Studio ou com o servidor MCP remoto do Figma para fornecer informações de design sem baixar o app para computador. Para mais ideias, consulte os servidores de exemplo do MCP.

Para adicionar um servidor MCP, siga estas etapas:

  1. Acesse as configurações do servidor MCP clicando em File (Android Studio no macOS) > Settings > Tools > Gemini > MCP Servers.
  2. Selecione Ativar servidores MCP.
  3. Adicione a configuração do MCP no campo fornecido. A configuração é salva em um arquivo mcp.json no diretório de configuração do Android Studio.

Confira um exemplo de arquivo 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"
    }
  }
}

Consulte a documentação do servidor MCP com que você está fazendo a integração para conferir os valores de configuração exatos que devem ser listados nesse arquivo. Talvez também seja necessário instalar ferramentas como Node.js ou Docker, dependendo dos requisitos de software do servidor MCP.

Configurações

Confira as opções completas de configuração do servidor MCP.

Servidor MCP local

A tabela a seguir lista as opções de configuração para iniciar um servidor MCP como um processo em segundo plano local.

Nome Tipo Descrição
command String Obrigatório. O executável ou comando a ser executado (por exemplo, npx, ./my-server).
args List<String> Opcional. Uma lista de argumentos da linha de comando a serem transmitidos para o executável. O padrão é [] (uma lista vazia).
env Map<String, String> Opcional. Um mapa de variáveis de ambiente a serem definidas para o processo. O padrão é {} (um mapa vazio).
enabled Booleano Opcional. Indica se a configuração do servidor está ativa. O padrão é true.

Servidor MCP remoto

A tabela a seguir lista as opções de configuração para se conectar a um servidor MCP por um transporte HTTP transmitível.

Nome Tipo Descrição
httpUrl String Obrigatório. O URL completo do endpoint HTTP de streaming (por exemplo, https://server.com/mcp).
headers Map<String, String> Um mapa de cabeçalhos HTTP personalizados a serem incluídos na solicitação de conexão. O padrão é {} (um mapa vazio).
timeout Longa Tempo limite de conexão em milissegundos. -1 indica que não há tempo limite. O padrão é -1.
enabled Booleano Indica se a configuração do servidor está ativa. O padrão é true.

Limitações

As seguintes funcionalidades ainda não são compatíveis com a integração do MCP do Android Studio:

  • Recursos do MCP
  • Modelos de comandos
  • Renderização de imagens na janela de chat quando o agente recupera imagens usando ferramentas como get_screenshot