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 o conhecimento e as capacidades 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 envio 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.
  4. Clique em OK.

O exemplo a seguir mostra um arquivo mcp.json com várias configurações de servidor:

{
  "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"
    }
  }
}

Para conferir os valores de configuração exatos a serem listados nesse arquivo, consulte a documentação do servidor MCP com que você está fazendo a integração.

Autenticação

Depois de clicar em OK, você vai receber uma notificação dizendo "Conectado ao servidor MCP..." ou uma notificação descrevendo um erro. A maioria dos servidores MCP remotos exige autenticação e, portanto, retorna "Erro ao conectar ao transporte: exceção de autorização" quando a autorização falha.

Clique em Iniciar login para iniciar o processo de autenticação desse servidor. Será necessário fazer login na página de login desse servidor no navegador. Depois que você fizer login, a conexão será tentada novamente e, se for bem-sucedida, a notificação "Conexão estabelecida com o servidor MCP..." vai aparecer.

Usar ferramentas do MCP

Para saber quais ferramentas estão disponíveis para o Gemini no Android Studio, digite /mcp no chat.

Em seguida, você pode fazer referência às ferramentas no chat, por exemplo, "liste meus repositórios no GitHub".

Configurações

Esta seção descreve todas as opções de configuração do servidor MCP.

Servidor MCP HTTP

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 transmitível (por exemplo, https://example.com/mcp ou http://localhost:1234/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 Longo 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

A integração do MCP no Android Studio não é compatível com os seguintes recursos:

  • Conexão com servidores MCP pelo transporte stdio
  • Recursos do MCP
  • Modelos de comandos
  • Login do OAuth com alguns servidores MCP, como o GitHub