Como configurar servidor MCP no Antigravity IDE

O que um servidor MCP faz no Antigravity IDE

O Model Context Protocol, ou MCP, fornece um padrão para agentes acessarem ferramentas e contexto externos. Um servidor pode expor esquema de banco, documentação, chamados, recursos de nuvem, analisadores de arquivo ou APIs. O Antigravity inicia o processo configurado ou conecta ao endpoint remoto, descobre as ferramentas e as apresenta dentro das permissões aprovadas.

Instalar MCP não é igual a instalar um tema. Um servidor stdio local executa um comando na máquina. Um remoto recebe solicitações e pode exigir OAuth ou token. Antes de adicionar, identifique o publicador, os dados acessíveis, as ações de escrita e se o acesso fora do repositório é realmente necessário.

Este fluxo segue a documentação atual do Google e separa IDE de CLI. A IDE oferece loja e edição JSON. A CLI tem o gerenciador /mcp, mas o estado exibido no terminal não prova que a IDE carregou o mesmo arquivo ou escopo.

Escolher configuração MCP global ou do projeto

Use o escopo mais restrito. Global é prático para uma ferramenta pessoal recorrente; a configuração do projeto é mais fácil de revisar, compartilhar e remover com o repositório.

Instalar um servidor pela MCP Store

Abra um projeto real, espere login e inicialização, clique no menu de três pontos no topo do painel do agente e escolha MCP Servers. Passe o mouse sobre uma integração e selecione Install ou leia os detalhes primeiro. Conclua a autenticação oficial e volte à lista para confirmar que ela aparece.

Comece com um servidor. Instalar muitos ao mesmo tempo dificulta saber qual processo, credencial ou definição falhou e aumenta as opções para o agente. Uma base limpa tem um publicador conhecido, um fluxo de autenticação e um pedido de teste.

1. Etapa 1 — Abra o painel do agente e o menu de três pontos.
2. Etapa 2 — Escolha MCP Servers e confira origem e acesso solicitado.
3. Etapa 3 — Instale um servidor, autentique pelo fluxo oficial e recarregue.
4. Etapa 4 — Peça uma leitura segura e revise resultado e permissão.

Adicionar servidor personalizado com mcp_config.json

Se ele não estiver na loja, escolha Manage MCP Servers e View raw config. O arquivo global documentado é ~/.gemini/config/mcp_config.json; o local pode ser .agents/mcp_config.json. Mantenha um único objeto mcpServers na raiz. Comando, argumentos, endpoint e autenticação precisam vir da documentação oficial do servidor.

O exemplo é propositalmente inativo. Para stdio, command e args iniciam o processo. Em conexões remotas atuais, o Google documenta serverUrl; campos antigos url ou httpUrl podem falhar. Não adivinhe pacote, CDN ou credencial e não grave chave secreta no Git.

{
  "mcpServers": {
    "servidor-exemplo": {
      "command": "COMANDO_OFICIAL",
      "args": ["ARGUMENTO_OFICIAL"]
    },
    "remoto-exemplo": {
      "serverUrl": "https://ENDPOINT_OFICIAL_DE_EXEMPLO/mcp"
    }
  }
}

Isto mostra somente a estrutura. Copie executável, URL, cabeçalhos e OAuth apenas da documentação primária escolhida.

Recarregar e validar o servidor MCP

Salve JSON válido, volte à lista e recarregue. O nome e as ferramentas ou recursos devem aparecer. Não comece escrevendo. Peça a lista de recursos, a leitura de um documento de teste ou somente os nomes das ferramentas.

Se houver autenticação, confira conta e escopo. Um indicador verde comprova conexão, não segurança para dados confidenciais. Revise ferramenta, argumentos e fonte antes de memorizar uma autorização.

• Carregado — O nome esperado aparece e as ferramentas podem ser inspecionadas.
• Autorizado — Conta e escopo concedidos correspondem ao projeto.
• Fundamentado — O teste devolve a fonte correta, não dados inventados.
• Reversível — Você sabe desativar a entrada, revogar token e remover configuração.

Segurança e permissões MCP

Trate cada servidor como código atravessando uma fronteira de dados. Prefira o publicador original ou repositório auditável, fixe versões quando possível e evite comandos de download e execução de tutoriais sem verificação. Para banco e nuvem, use conta de desenvolvimento com privilégio mínimo, nunca proprietário de produção no primeiro teste.

Escopo de projeto não cria sandbox automaticamente. O processo pode ler o que a conta do sistema operacional permite. Mantenha segredos fora de prompts e JSON versionado. Revise escrita, exclusão, deploy, pagamentos, mensagens e administração de conta até existir política documentada.

Corrigir problemas MCP no Antigravity IDE e WSL

As causas comuns são escopo errado, JSON inválido, PATH, autenticação ou caminhos misturados entre Windows e WSL. Altere uma variável por vez.

O servidor não aparece após recarregar

Valide JSON, confirme mcpServers na raiz e edite o arquivo exibido por Manage MCP Servers. Procure outra configuração global ou local. Reinicie somente após o recarregamento normal falhar.

O comando funciona no terminal, mas não na IDE

O processo gráfico pode ter PATH, pasta inicial ou variáveis diferentes. Use caminho absoluto se suportado e reabra o Antigravity após mudanças no sistema.

A execução pelo WSL falha

Defina qual sistema inicia o processo. Uma IDE Windows geralmente precisa de wsl.exe explícito e caminhos Linux dentro do comando. Um processo WSL não deve receber C:\ como caminho Linux. Teste o comando exato fora da IDE.

O remoto conecta, mas não mostra ferramentas

Confira endpoint oficial, autenticação e transporte. A configuração atual usa serverUrl. Página de produto ou painel não é endpoint MCP.

O servidor inicia e para repetidamente

Execute diretamente e examine stderr sem expor segredos. Procure runtime ausente, versão incompatível, logs indevidos em stdout ou credencial expirada.

Verificação de versão e fonte de download

Como este é um site de download, a versão foi verificada antes da publicação. Em 24 de julho de 2026, o changelog oficial mostrava a versão 2.2.1, datada de 25 de junho de 2026. O site já informava v2.2.1; nenhum número precisou mudar. A página não inventa tamanho, checksum, varredura de segurança ou link direto do pacote.

O botão usa a página oficial como alternativa verificada. Confira-a novamente ao instalar, pois a distribuição pode ser gradual. Para caminhos MCP e esquema remoto atuais, a documentação oficial abaixo é a autoridade final.