Baserow

Baserow MCP

Conecta tu agente de IA a Baserow. Tu agente puede leer y modificar tablas en un espacio de trabajo de Baserow, usando solo las herramientas que permitas al iniciar sesión.

Este repositorio instala el servidor MCP de Baserow y una breve habilidad que enseña al agente cómo usarlo. Funciona con Claude, ChatGPT, Codex, Cursor, VS Code, GitHub Copilot, Gemini CLI, OpenCode, Zed, Goose, Windsurf, Pi y otros agentes.

URL del servidor

• baserow.io: https://api.baserow.io/mcp
• Autoalojado: la URL de tu backend seguida de /mcp, por ejemplo https://baserow.example.com/mcp. Cópiala desde Mi configuración → Servidor MCP en Baserow.

Los ejemplos a continuación usan la URL de baserow.io. En Baserow autoalojado, usa tu propia URL en su lugar.

Inicio rápido

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

add-mcp encuentra los agentes que tienes instalados y pregunta a cuáles añadir Baserow. Desmarca Claude Desktop si aparece en la lista y añade Baserow allí como conector personalizado en su lugar. skills add copia la habilidad baserow-basics en las carpetas de habilidades de tus agentes. En Baserow autoalojado, ejecuta también skills add, ya que solo los complementos a continuación incluyen la habilidad.

Requisitos para autoalojado

• Una versión de Baserow más reciente que 2.4.1. Las versiones anteriores no tienen /mcp ni inicio de sesión; usa una clave de endpoint allí.
• BASEROW_MCP_OAUTH_ENABLED=true en el backend. Está desactivado por defecto.
• Una URL de backend HTTPS pública, para que aplicaciones alojadas como Claude.ai y ChatGPT puedan acceder a ella, y HTTPS saliente desde el backend, que obtiene los metadatos del cliente de las aplicaciones.
• Tu proxy inverso envía /mcp y las rutas bajo /mcp/, /oauth/, /.well-known/oauth-authorization-server y /.well-known/oauth-protected-resource al backend. Coincide con /mcp exactamente, no como prefijo: el frontend sirve la página de inicio de sesión en /mcp-authorize/.

Consulta Inicio de sesión OAuth MCP para Baserow autoalojado.

Instalación por agente

Agente	baserow.io	Autoalojado
Claude Code	Complemento	Mismo complemento, introduce tu URL cuando se solicite
Claude.ai, Claude Desktop	Conector personalizado	Igual, con tu URL
ChatGPT	Servidor MCP personalizado	Igual, con tu URL
Codex	Complemento	codex mcp add baserow --url <your url>
GitHub Copilot CLI	Complemento	Solo servidor
Gemini CLI	gemini extensions install https://github.com/baserow/baserow-mcp	gemini mcp add -s user -t http baserow <your url>
Cursor	Añadir a Cursor	Archivo de configuración
VS Code	Añadir a VS Code	Archivo de configuración
Goose	Añadir a Goose	Inicio rápido con tu URL
OpenCode, Windsurf, Zed	Archivo de configuración	Igual, con tu URL
Cualquier otro agente	Inicio rápido	Igual, con tu URL

Los complementos de Codex, Copilot y Gemini y los botones Añadir siempre apuntan a baserow.io, así que en Baserow autoalojado añade solo el servidor para esos agentes.

Claude Code

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

Cuando pregunte por la URL, presiona Esc para mantener baserow.io, o introduce tu URL autoalojada. Para cambiarla más tarde, ejecuta /plugin configure baserow@baserow.

Claude.ai y Claude Desktop

Personalizar → Conectores → + Añadir → Añadir conector personalizado. Nómbralo Baserow e introduce la URL de tu servidor. En planes Team y Enterprise, un propietario lo añade en Configuración de la organización → Conectores.

ChatGPT

Abre Complementos, selecciona el botón de más, luego Añadir servidor MCP personalizado e introduce la URL de tu servidor. Los nombres de los menús cambian con frecuencia. En planes Business y Enterprise, un administrador debe permitir servidores MCP personalizados primero.

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

En Baserow autoalojado, añade solo el servidor: copilot mcp add --transport http baserow <your url>. Si el complemento está instalado, desinstálalo primero con copilot plugin uninstall baserow; su servidor reemplaza al tuyo sin advertencia.

Archivos de configuración

Para añadir solo el servidor, sin el complemento:

• 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, luego 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, configuración:

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

Inicio de sesión

Tu agente abre una página de Baserow en tu navegador. Inicia sesión, elige el espacio de trabajo y marca las herramientas que el agente puede usar. Las herramientas de lectura permiten al agente explorar bases de datos, tablas y filas; las herramientas de escritura le permiten crear, actualizar y eliminar filas. Solo las herramientas de lectura están marcadas en una primera conexión.

Dónde comienza el inicio de sesión:

• Claude Code: ejecuta /mcp, elige plugin:baserow:baserow y autentícate.
• Codex: codex mcp login baserow.
• Gemini CLI: /mcp auth baserow.
• Claude.ai, ChatGPT, Cursor y VS Code: el botón Conectar o Iniciar sesión junto al servidor.

Para cambiar el espacio de trabajo o las herramientas, inicia sesión de nuevo: reautentica el servidor en tu agente, o desconecta la aplicación en Mi configuración → Servidor MCP en Baserow y vuelve a conectar. Una reconexión simple mantiene el inicio de sesión anterior.

Solución de problemas

• Falta una herramienta, o no se listan bases de datos. La conexión solo tiene el espacio de trabajo y las herramientas que elegiste al iniciar sesión. Inicia sesión de nuevo como se describe arriba. Las herramientas que modifican tablas o campos no están disponibles a través de MCP.
• El inicio de sesión nunca comienza, o el cliente dice que el servidor no admite OAuth o registro de cliente. En Baserow autoalojado, revisa los requisitos para autoalojado.
• La conexión falla con una URL que escribiste. Copia la URL exactamente como la muestra Mi configuración → Servidor MCP. Termina en /mcp, sin barra final.
• Dos servidores Baserow en Claude Code. Si claude mcp list muestra el plugin:baserow:baserow del complemento y un servidor baserow que añadiste manualmente, conserva el que se conecta. claude plugin disable baserow@baserow desactiva el del complemento; claude mcp remove baserow elimina el tuyo.

Claves de endpoint

Baserow 2.4.1 y versiones anteriores solo aceptan una clave de endpoint, y el complemento no la configura. Copia la URL del endpoint desde Mi configuración → Servidor MCP. Termina en /sse y contiene tu clave. Añádela manualmente a un agente que admita servidores SSE, como Claude Code, Cursor o VS Code; Codex y Goose no:

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

Las versiones más recientes también aceptan la clave como encabezado en /mcp, lo cual es útil para scripts:

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

La clave da acceso completo a su espacio de trabajo. -g la escribe en tu configuración de usuario en lugar de la carpeta actual, para que no pueda terminar en un commit.

Privacidad y soporte

• Política de privacidad: https://baserow.io/privacy-policy
• Términos: https://baserow.io/terms-and-conditions
• Ayuda: foro de la comunidad o contáctanos

Desarrollo

En scripts/, ejecuta npm install, luego npm test y npm run check. CI ejecuta las mismas verificaciones. Las herramientas viven allí para que las instalaciones de complementos no instalen sus dependencias.

El complemento de Claude Code declara su servidor en .claude-plugin/plugin.json, para que pueda usar la URL que introduces. .mcp.json contiene la URL de baserow.io para otras herramientas que leen complementos en formato Claude, como GitHub Copilot CLI y Cursor.

Licencia

MIT