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 de agente usar ferramentas e ampliar o conhecimento e os 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 envio diretamente no Android Studio ou com o servidor MCP remoto do Figma para fornecer informações de design sem fazer o download do 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 > AI > MCP Servers.
  2. Selecione Enable MCP Servers.
  3. Adicione a configuração do MCP no campo fornecido. A configuração é salva em um mcp.json arquivo 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 informando "Successfully connected to servidor MCP..." ou uma notificação descrevendo um erro. A maioria dos servidores MCP remotos exige autenticação e, portanto, retorna "Error connecting to transport: Authorization Exception" quando a autorização falha.

Clique em Start Login para iniciar o processo de autenticação desse servidor. Você vai precisar fazer login na página de login do servidor no navegador. Depois de fazer login, a conexão será tentada novamente e, se for bem-sucedida, você vai receber a notificação "Successfully connected to MCP server...".

Usar ferramentas do MCP

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

Em seguida, você pode referenciar as ferramentas no chat, por exemplo, "list my repositories on GitHub".

Configurações

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

Servidor HTTP MCP

A tabela a seguir lista as opções de configuração para conexão 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 essa configuração do servidor está ativa. O padrão é true.

Limitações

A integração do MCP do Android Studio não oferece suporte aos seguintes recursos:

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