Como conectar o MCP da Nuvia ao Google Antigravity

Conecte o Gemini, através do Google Antigravity, aos dados da sua empresa na Nuvia, adicionando o servidor MCP manualmente pelo arquivo de configuração.

Disponível em
contas com acesso ao MCP da Nuvia
Quem pode fazer
apenas perfis Usuário e Company Admin

Nesta página3 seções

Módulo: configuração feita no Google Antigravity + tela de autorização da Nuvia.


O que é o MCP da Nuvia e o Antigravity

O MCP (Model Context Protocol) é um protocolo aberto que padroniza como aplicativos de IA acessam dados e ferramentas externas. A Nuvia expõe um servidor MCP em https://api.nuvia.ai/mcp.

O Google Antigravity é o ambiente agêntico do Google que roda modelos Gemini. Ele suporta servidores MCP nativamente, então dá para conectar a Nuvia e usar suas ferramentas (consultar conversas, agents, dados da plataforma etc.) direto de dentro do Antigravity.

Pré-requisitos: ter o Antigravity instalado e logado, e uma conta Nuvia com acesso (para autorizar o login).

Como conectar

A Nuvia ainda não está no catálogo de servidores prontos do Antigravity (Add MCP), então a conexão é feita manualmente pelo arquivo de configuração.

  • No Antigravity, vá em Settings → Customizations e desça até Installed MCP Servers.

  • Clique em Open MCP Config. Isso abre a pasta de configuração, com os arquivos config.json e mcp_config.json. Abra o mcp_config.json em um editor de texto (botão direito → Abrir Com → Editor de Texto).

  • Cole o bloco abaixo no arquivo e salve:

{   "mcpServers": {     "nuvia": {       "serverUrl": "https://api.nuvia.ai/mcp"     }   } }

Se já houver outros servidores configurados, coloque "nuvia": { ... } dentro do mcpServers que já existe, separando por vírgula. Não crie um segundo bloco mcpServers.

  • Volte para Customizations → Installed MCP Servers. O “nuvia” vai aparecer na lista com um botão Authenticate (se não aparecer na hora, clique em Refresh). É normal ver o erro Error: calling "initialize": ... Unauthorized antes de autenticar, isso é esperado.

  • Clique em Authenticate. Uma página abre no navegador: Autorizar acesso MCP (Nuvia), mostrando com qual usuário e empresa você está operando. Clique em Entrar com Google novamente e conclua o login.

  • Depois de autorizar, o erro de Unauthorized desaparece e o servidor fica ativo.

Como testar a conexão

Abra uma New Conversation com um modelo Gemini e peça algo que use o MCP, por exemplo:

O agent vai chamar a tool nuvia / whoami e retornar userId, companyId, nome do usuário e empresa. Se isso aparecer, a conexão está funcionando.

Perguntas frequentes

O Antigravity tem a Nuvia no catálogo de MCPs?

Ainda não. Por isso a conexão é feita manualmente, editando o mcp_config.json em vez de usar o botão Add MCP.

Preciso repetir esse processo toda vez que abro o Antigravity?

Não. Depois de autenticado, a conexão fica salva. Você só precisaria refazer o processo se remover o servidor ou se o token de autorização expirar.

O cliente conectado enxerga dados de outras empresas?

Não. O acesso é isolado por empresa (tenant-scoped). Cada conexão enxerga somente os dados da empresa do usuário que fez a autorização.

Este artigo ajudou?