Conectar LLMs ao BigQuery com o MCP

MCP Store

A maneira mais simples de se conectar ao BigQuery no Antigravity é usando a MCP Store integrada.

1. Abra o Antigravity e o painel do agente do editor.
2. Clique no ícone "..." na parte de cima do painel e selecione Servidores MCP.
3. Localize o BigQuery na lista de servidores disponíveis e clique em Instalar.
4. Siga as instruções na tela para vincular suas contas de forma segura, quando aplicável.

Depois de instalar o BigQuery na MCP Store, os recursos e as ferramentas do servidor ficam disponíveis automaticamente para o editor.

Configuração personalizada

Para se conectar a um servidor MCP personalizado, siga estas etapas:

1. Abra Antigravity e navegue até a MCP Store usando o menu suspenso "..." na parte de cima do painel do agente do editor.
2. Para abrir o arquivo mcp_config.json, clique em Servidores MCP e em Gerenciar servidores MCP > Ver configuração bruta.
3. Adicione a configuração a seguir, substitua a variável de ambiente pelos seus valores e salve.

{
  "mcpServers": {
    "bigquery": {
      "command": "npx",
      "args": ["-y","@toolbox-sdk/server","--prebuilt","bigquery","--stdio"],
      "env": {
          "BIGQUERY_PROJECT": "PROJECT_ID"
      }
    }
  }
}

Claude Code

1. Instale o Claude Code.
2. Crie um arquivo .mcp.json na raiz do projeto, se ele não existir.
3. Adicione a configuração, substitua as variáveis de ambiente pelos seus valores e salve:

           {
             "mcpServers": {
               "bigquery": {
                 "command": "./PATH/TO/toolbox",
                 "args": ["--prebuilt","bigquery","--stdio"],
                 "env": {
                   "BIGQUERY_PROJECT": "PROJECT_ID"
                 }
               }
             }
           }
           

4. Reinicie o Claude Code para carregar as novas configurações. Quando ele for reaberto, a ferramenta vai indicar que o servidor MCP configurado foi detectado.

Claude Desktop

1. Abra Claude Desktop e navegue até Configurações.
2. Na guia Desenvolvedor, clique em Editar configuração para abrir o arquivo de configuração.
3. Adicione a configuração, substitua as variáveis de ambiente pelos seus valores e salve:

           {
             "mcpServers": {
               "bigquery": {
                 "command": "./PATH/TO/toolbox",
                 "args": ["--prebuilt","bigquery","--stdio"],
                 "env": {
                   "BIGQUERY_PROJECT": "PROJECT_ID"
                 }
               }
             }
           }
           

4. Reinicie o Claude Desktop.
5. A nova tela de chat mostra um ícone de martelo (MCP) com o novo servidor MCP.

Cline

1. Abra a extensão Cline no VS Code e toque no ícone Servidores MCP.
2. Toque em Configurar servidores MCP para abrir o arquivo de configuração.
3. Adicione a configuração a seguir, substitua as variáveis de ambiente com seus valores e salve:

           {
             "mcpServers": {
               "bigquery": {
                 "command": "./PATH/TO/toolbox",
                 "args": ["--prebuilt","bigquery","--stdio"],
                 "env": {
                   "BIGQUERY_PROJECT": "PROJECT_ID"
                 }
               }
             }
           }
           

Um status ativo verde aparece depois que o servidor se conecta.

Cursor

1. Crie o diretório .cursor na raiz do projeto, se ele não existir.
2. Crie o arquivo .cursor/mcp.json, se ele não existir, e abra-o.
3. Adicione a configuração a seguir, substitua as variáveis de ambiente com seus valores e salve:

           {
             "mcpServers": {
               "bigquery": {
                 "command": "./PATH/TO/toolbox",
                 "args": ["--prebuilt","bigquery","--stdio"],
                 "env": {
                   "BIGQUERY_PROJECT": "PROJECT_ID"
                 }
               }
             }
           }
           

4. Abra o Cursor e navegue até Configurações > Configurações do cursor > MCP. Um status ativo verde aparece quando o servidor se conecta.

Visual Studio Code (Copilot)

1. Abra o VS Code e crie um diretório .vscode na raiz do projeto, se ele não existir.
2. Crie o arquivo .vscode/mcp.json, se ele não existir, e abra-o.
3. Adicione a configuração a seguir, substitua as variáveis de ambiente com seus valores e salve:

           {
             "servers": {
               "bigquery": {
                 "command": "./PATH/TO/toolbox",
                 "args": ["--prebuilt","bigquery","--stdio"],
                 "env": {
                   "BIGQUERY_PROJECT": "PROJECT_ID"
                 }
               }
             }
           }
           

4. Atualize a janela do VS Code. A extensão compatível com MCP detecta automaticamente a configuração e inicia o servidor.

Windsurf

1. Abra o Windsurf e navegue até o assistente do Cascade.
2. Clique no ícone do MCP e em Configurar para abrir o arquivo de configuração.
3. Adicione a configuração a seguir, substitua as variáveis de ambiente com seus valores e salve:

           {
             "mcpServers": {
               "bigquery": {
                 "command": "./PATH/TO/toolbox",
                 "args": ["--prebuilt","bigquery","--stdio"],
                 "env": {
                   "BIGQUERY_PROJECT": "PROJECT_ID"
                 }
               }
             }
           }