Baserow

Baserow MCP

将 AI Agent 连接到 Baserow。Agent 可以读取和修改一个 Baserow 工作区中的表格，但仅限于你登录时允许使用的工具。

此仓库会安装 Baserow 的 MCP 服务和一份简短的技能说明，教 Agent 如何使用它。它适用于 Claude、ChatGPT、Codex、Cursor、VS Code、GitHub Copilot、Gemini CLI、OpenCode、Zed、Goose、Windsurf、Pi 等其他 Agent。

服务 URL

• baserow.io：https://api.baserow.io/mcp
• 自托管：你的后端 URL 后接 /mcp，例如 https://baserow.example.com/mcp。可在 Baserow 的「我的设置 → MCP 服务」中复制。

以下示例使用 baserow.io URL。使用自托管 Baserow 时，请改用你自己的 URL。

快速开始

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

add-mcp 会查找已安装的 Agent，并询问要将 Baserow 添加到哪些 Agent。如果列表中有 Claude Desktop，请取消勾选，并将 Baserow 作为自定义连接器添加到 Claude Desktop。skills add 会将 baserow-basics 技能复制到 Agent 的技能文件夹中。使用自托管 Baserow 时，也要运行 skills add，因为只有下面的插件包含该技能。

自托管要求

• Baserow 版本需高于 2.4.1。较旧版本不支持 /mcp 或登录；请改用端点密钥。
• 在后端设置 BASEROW_MCP_OAUTH_ENABLED=true。此功能默认关闭。
• 需要可公开访问的 HTTPS 后端 URL，以便 Claude.ai 和 ChatGPT 等托管应用连接；后端还需能通过出站 HTTPS 获取这些应用的客户端元数据。
• 反向代理需将 /mcp、/mcp/ 下的路径、/oauth/、/.well-known/oauth-authorization-server 和 /.well-known/oauth-protected-resource 转发到后端。请精确匹配 /mcp，不要将其作为前缀匹配：前端会在 /mcp-authorize/ 提供登录页面。

请参阅自托管 Baserow 的 MCP OAuth 登录。

按 Agent 安装

Agent	baserow.io	自托管
Claude Code	插件	使用同一插件，并在提示时输入你的 URL
Claude.ai、Claude Desktop	自定义连接器	同上，使用你的 URL
ChatGPT	自定义 MCP 服务	同上，使用你的 URL
Codex	插件	codex mcp add baserow --url <your url>
GitHub Copilot CLI	插件	仅添加服务
Gemini CLI	gemini extensions install https://github.com/baserow/baserow-mcp	gemini mcp add -s user -t http baserow <your url>
Cursor	添加到 Cursor	配置文件
VS Code	添加到 VS Code	配置文件
Goose	添加到 Goose	使用你的 URL 按快速开始操作
OpenCode、Windsurf、Zed	配置文件	同上，使用你的 URL
其他 Agent	快速开始	同上，使用你的 URL

Codex、Copilot 和 Gemini 插件，以及「添加到」按钮始终指向 baserow.io，因此在自托管 Baserow 上，请仅为这些 Agent 添加服务。

Claude Code

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

提示输入 URL 时，按 Esc 保留 baserow.io，或输入你的自托管 URL。以后要更改，请运行 /plugin configure baserow@baserow。

Claude.ai 和 Claude Desktop

「自定义」→「连接器」→「+ 添加」→「添加自定义连接器」。将其命名为 Baserow，并输入你的服务 URL。在 Team 和 Enterprise 计划中，由所有者通过「组织设置」→「连接器」添加。

ChatGPT

打开 Plugins，选择加号按钮，然后选择 Add custom MCP server，并输入服务器 URL。菜单名称经常变化。对于 Business 和 Enterprise 计划，管理员必须先允许自定义 MCP 服务。

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

对于可自托管的 Baserow，只添加服务即可：copilot mcp add --transport http baserow <your url>。如果已安装插件，请先使用 copilot plugin uninstall baserow 卸载；插件的服务会在没有警告的情况下取代你添加的服务。

配置文件

若要仅添加服务而不添加插件：

• 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，然后运行 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，设置：

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

登录

你的 Agent 会在浏览器中打开 Baserow 页面。登录，选择工作区，并勾选 Agent 可以使用的工具。读取工具允许 Agent 浏览数据库、表和行；写入工具允许它创建、更新和删除行。首次连接时，只有读取工具会被勾选。

登录方式：

• Claude Code：运行 /mcp，选择 plugin:baserow:baserow 并进行身份验证。
• Codex：codex mcp login baserow。
• Gemini CLI：/mcp auth baserow。
• Claude.ai、ChatGPT、Cursor 和 VS Code：点击服务旁的 Connect 或 Sign in 按钮。

若要更改工作区或工具，请重新登录：在 Agent 中重新验证服务，或在 Baserow 的 My settings → MCP server 下断开应用连接后再重新连接。直接重新连接会保留旧的登录信息。

故障排除

• 缺少某个工具，或没有列出任何数据库。 连接只能访问你登录时选择的工作区和工具。请按照上述说明重新登录。无法通过 MCP 使用更改表或字段的工具。
• 登录没有启动，或客户端提示服务不支持 OAuth 或客户端注册。 对于可自托管的 Baserow，请检查自托管要求。
• 使用你输入的 URL 连接失败。 请准确复制 My settings → MCP server 中显示的 URL。URL 以 /mcp 结尾，末尾没有斜杠。
• Claude Code 中有两个 Baserow 服务。 如果 claude mcp list 显示插件的 plugin:baserow:baserow 和你手动添加的 baserow 服务，请保留能够连接的那个。claude plugin disable baserow@baserow 会关闭插件的服务；claude mcp remove baserow 会移除你添加的服务。

端点密钥

Baserow 2.4.1 及更早版本只接受端点密钥，且插件不会设置此密钥。请从 My settings → MCP server 复制端点 URL。它以 /sse 结尾，并包含你的密钥。手动将它添加到支持 SSE 服务的 Agent 中，例如 Claude Code、Cursor 或 VS Code；Codex 和 Goose 不支持：

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

较新版本还支持将密钥作为 /mcp 上的请求头，这对脚本很有用：

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

该密钥可完全访问其工作区。-g 会将密钥写入你的用户配置，而不是当前文件夹，因此不会意外提交到版本库。

隐私与支持

• 隐私政策：https://baserow.io/privacy-policy
• 条款：https://baserow.io/terms-and-conditions
• 帮助：社区论坛或联系我们

开发

在 scripts/ 中运行 npm install，然后运行 npm test 和 npm run check。CI 会运行相同的检查。工具链位于该目录中，因此安装插件时不会安装其依赖项。

Claude Code 插件在 .claude-plugin/plugin.json 中声明其服务，因此可以使用你输入的 URL。.mcp.json 存放 baserow.io URL，供其他读取 Claude 格式插件的工具使用，例如 GitHub Copilot CLI 和 Cursor。

许可证

MIT