Baserow

Baserow MCP

Conecte seu agente de IA ao Baserow. Seu agente pode ler e alterar tabelas em um workspace do Baserow, usando apenas as ferramentas que você permitir ao fazer login.

Este repositório instala o servidor MCP do Baserow e uma skill curta que ensina o agente a usá-lo. Funciona com Claude, ChatGPT, Codex, Cursor, VS Code, GitHub Copilot, Gemini CLI, OpenCode, Zed, Goose, Windsurf, Pi e outros agentes.

URL do servidor

• baserow.io: https://api.baserow.io/mcp
• Auto-hospedado: a URL do seu backend seguida de /mcp, por exemplo https://baserow.example.com/mcp. Copie-a em Minhas configurações → Servidor MCP no Baserow.

Os exemplos abaixo usam a URL do baserow.io. No Baserow auto-hospedado, use sua própria URL.

Início rápido

npx add-mcp https://api.baserow.io/mcp -n baserow -g
npx skills add baserow/baserow-mcp

add-mcp encontra os agentes que você instalou e pergunta a quais adicionar o Baserow. Desmarque o Claude Desktop se ele aparecer na lista e adicione o Baserow lá como um conector personalizado. skills add copia a skill baserow-basics para as pastas de skills dos seus agentes. No Baserow auto-hospedado, execute também skills add, pois apenas os plugins abaixo incluem a skill.

Requisitos para auto-hospedagem

• Uma versão do Baserow mais recente que a 2.4.1. Versões mais antigas não têm /mcp nem login; use uma chave de endpoint nelas.
• BASEROW_MCP_OAUTH_ENABLED=true no backend. Vem desativado por padrão.
• Uma URL de backend HTTPS pública, para que apps hospedados como Claude.ai e ChatGPT possam alcançá-la, e HTTPS de saída a partir do backend, que busca os metadados de cliente dos apps.
• Seu proxy reverso envia /mcp e caminhos sob /mcp/, /oauth/, /.well-known/oauth-authorization-server e /.well-known/oauth-protected-resource para o backend. Corresponda a /mcp exatamente, não como prefixo: o frontend serve a página de login em /mcp-authorize/.

Veja Login OAuth do MCP para Baserow auto-hospedado.

Instalação por agente

Agente	baserow.io	Auto-hospedado
Claude Code	Plugin	Mesmo plugin, informe sua URL quando solicitado
Claude.ai, Claude Desktop	Conector personalizado	O mesmo, com sua URL
ChatGPT	Servidor MCP personalizado	O mesmo, com sua URL
Codex	Plugin	codex mcp add baserow --url <your url>
GitHub Copilot CLI	Plugin	Somente servidor
Gemini CLI	gemini extensions install https://github.com/baserow/baserow-mcp	gemini mcp add -s user -t http baserow <your url>
Cursor	Adicionar ao Cursor	Arquivo de configuração
VS Code	Adicionar ao VS Code	Arquivo de configuração
Goose	Adicionar ao Goose	Início rápido com sua URL
OpenCode, Windsurf, Zed	Arquivo de configuração	O mesmo, com sua URL
Qualquer outro agente	Início rápido	O mesmo, com sua URL

Os plugins do Codex, Copilot e Gemini e os botões Adicionar sempre apontam para o baserow.io, então no Baserow auto-hospedado adicione apenas o servidor para esses agentes.

Claude Code

/plugin marketplace add baserow/baserow-mcp
/plugin install baserow@baserow

Quando ele pedir a URL, pressione Esc para manter o baserow.io, ou informe sua URL auto-hospedada. Para alterá-la depois, execute /plugin configure baserow@baserow.

Claude.ai e Claude Desktop

Personalizar → Conectores → + Adicionar → Adicionar conector personalizado. Nomeie como Baserow e informe a URL do seu servidor. Nos planos Team e Enterprise, um proprietário o adiciona em Configurações da organização → Conectores.

ChatGPT

Abra Plugins, selecione o botão de mais, depois Adicionar servidor MCP personalizado e informe a URL do seu servidor. Os nomes dos menus mudam com frequência. Nos planos Business e Enterprise, um administrador precisa permitir servidores MCP personalizados primeiro.

Codex

codex plugin marketplace add baserow/baserow-mcp
codex plugin add baserow@baserow
codex mcp login baserow

GitHub Copilot CLI

copilot plugin marketplace add baserow/baserow-mcp
copilot plugin install baserow@baserow

No Baserow auto-hospedado, adicione apenas o servidor: copilot mcp add --transport http baserow <your url>. Se o plugin estiver instalado, desinstale-o primeiro com copilot plugin uninstall baserow; o servidor dele substitui o seu sem aviso.

Arquivos de configuração

Para adicionar apenas o servidor, sem o plugin:

• Cursor, ~/.cursor/mcp.json:

  { "mcpServers": { "baserow": { "url": "https://api.baserow.io/mcp" } } }
  

• VS Code, .vscode/mcp.json:

  { "servers": { "baserow": { "type": "http", "url": "https://api.baserow.io/mcp" } } }
  

• OpenCode, opencode.json, depois opencode mcp auth baserow:

  { "mcp": { "baserow": { "type": "remote", "url": "https://api.baserow.io/mcp" } } }
  

• Windsurf, ~/.codeium/windsurf/mcp_config.json:

  { "mcpServers": { "baserow": { "serverUrl": "https://api.baserow.io/mcp" } } }
  

• Zed, configurações:

  { "context_servers": { "baserow": { "url": "https://api.baserow.io/mcp" } } }
  

Fazendo login

Seu agente abre uma página do Baserow no seu navegador. Faça login, escolha o workspace e marque as ferramentas que o agente pode usar. As ferramentas de leitura permitem que o agente navegue por bancos de dados, tabelas e linhas; as ferramentas de escrita permitem que ele crie, atualize e exclua linhas. Apenas as ferramentas de leitura vêm marcadas na primeira conexão.

Onde o login começa:

• Claude Code: execute /mcp, escolha plugin:baserow:baserow e autentique.
• Codex: codex mcp login baserow.
• Gemini CLI: /mcp auth baserow.
• Claude.ai, ChatGPT, Cursor e VS Code: o botão Conectar ou Fazer login ao lado do servidor.

Para alterar o workspace ou as ferramentas, faça login novamente: reautentique o servidor no seu agente, ou desconecte o app em Minhas configurações → Servidor MCP no Baserow e conecte novamente. Uma reconexão simples mantém o login antigo.

Solução de problemas

• Falta uma ferramenta, ou nenhum banco de dados é listado. A conexão tem apenas o workspace e as ferramentas que você escolheu no login. Faça login novamente conforme descrito acima. Ferramentas que alteram tabelas ou campos não estão disponíveis via MCP.
• O login nunca começa, ou o cliente diz que o servidor não suporta OAuth ou registro de cliente. No Baserow auto-hospedado, verifique os requisitos para auto-hospedagem.
• A conexão falha com uma URL que você digitou. Copie a URL exatamente como Minhas configurações → Servidor MCP a mostra. Ela termina em /mcp, sem barra final.
• Dois servidores Baserow no Claude Code. Se claude mcp list mostrar o plugin:baserow:baserow do plugin e um servidor baserow que você adicionou manualmente, mantenha o que conecta. claude plugin disable baserow@baserow desativa o do plugin; claude mcp remove baserow remove o seu.

Chaves de endpoint

O Baserow 2.4.1 e anteriores só aceitam uma chave de endpoint, e o plugin não configura isso. Copie a URL do endpoint em Minhas configurações → Servidor MCP. Ela termina em /sse e contém sua chave. Adicione-a manualmente a um agente que suporte servidores SSE, como Claude Code, Cursor ou VS Code; Codex e Goose não suportam:

npx add-mcp "<endpoint url>" -t sse -n baserow -g -a claude-code

Versões mais recentes também aceitam a chave como cabeçalho em /mcp, o que é útil para scripts:

npx add-mcp https://baserow.example.com/mcp -n baserow -g -a claude-code -h "Authorization: Bearer <key>"

A chave dá acesso total ao seu workspace. -g a grava na sua configuração de usuário em vez da pasta atual, para que não acabe em um commit.

Privacidade e suporte

• Política de privacidade: https://baserow.io/privacy-policy
• Termos: https://baserow.io/terms-and-conditions
• Ajuda: fórum da comunidade ou fale conosco

Desenvolvimento

Em scripts/, execute npm install, depois npm test e npm run check. A CI executa as mesmas verificações. O ferramental fica lá para que as instalações do plugin não instalem suas dependências.

O plugin do Claude Code declara seu servidor em .claude-plugin/plugin.json, para que possa usar a URL que você informar. .mcp.json contém a URL do baserow.io para outras ferramentas que leem plugins no formato Claude, como GitHub Copilot CLI e Cursor.

Licença

MIT