Baserow
官方对您的Baserow表格进行读写访问。
你可以用 Baserow MCP 做什么？
- 浏览 Baserow 数据 — 让您的助手列出已连接工作区中的数据库、表和行。
- 读取表内容 — 让您的助手检索并总结您已授权的特定表中的数据。
- 创建新行 — 指示您的助手使用您已启用的写入工具向表中添加记录。
- 更新现有行 — 让您的助手修改 Baserow 工作区中行的字段值。
- 删除行 — 指示您的助手从表中删除记录，具体操作受您在登录时授予的权限约束。
文档
Baserow MCP
将您的 AI 代理连接到 Baserow。您的代理可以读取和更改一个 Baserow 工作区中的表格，仅使用您登录时允许的工具。
此仓库安装 Baserow 的 MCP 服务器和一个简短的技能，教代理如何使用它。它适用于 Claude、ChatGPT、Codex、Cursor、VS Code、GitHub Copilot、Gemini CLI、OpenCode、Zed、Goose、Windsurf、Pi 和其他代理。
服务器 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 查找您已安装的代理，并询问要将 Baserow 添加到哪些代理。如果列出了 Claude Desktop，请取消勾选，并改为在那里将 Baserow 添加为自定义连接器。skills add 将 baserow-basics 技能复制到您的代理的技能文件夹中。在自托管的 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 登录。
按代理安装
| 代理 | 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 |
| 任何其他代理 | 快速开始 | 相同，使用您的 URL |
Codex、Copilot 和 Gemini 插件以及“添加”按钮始终指向 baserow.io，因此在自托管的 Baserow 上，仅为这些代理添加服务器。
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
打开插件，选择加号按钮，然后选择“添加自定义 MCP 服务器”，并输入您的服务器 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" } } }
登录
您的代理会在浏览器中打开一个 Baserow 页面。登录，选择工作区，并勾选代理可以使用的工具。读取工具允许代理浏览数据库、表格和行；写入工具允许其创建、更新和删除行。首次连接时，仅勾选读取工具。
登录开始的位置：
- Claude Code：运行
/mcp，选择plugin:baserow:baserow并进行身份验证。 - Codex：
codex mcp login baserow。 - Gemini CLI：
/mcp auth baserow。 - Claude.ai、ChatGPT、Cursor 和 VS Code：服务器旁边的“连接”或“登录”按钮。
要更改工作区或工具，请重新登录：在您的代理中重新验证服务器，或在 Baserow 中的“我的设置 → MCP 服务器”下断开应用并重新连接。简单的重新连接会保留旧的登录状态。
故障排除
- 缺少工具，或没有列出数据库。 连接仅包含您在登录时选择的工作区和工具。请按上述说明重新登录。更改表格或字段的工具无法通过 MCP 使用。
- 登录从未开始，或客户端提示服务器不支持 OAuth 或客户端注册。 在自托管的 Baserow 上，请检查自托管要求。
- 使用您输入的 URL 连接失败。 请精确复制“我的设置 → MCP 服务器”中显示的 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 及更早版本仅接受端点密钥，而插件不会设置此功能。从“我的设置 → MCP 服务器”复制端点 URL。它以 /sse 结尾并包含您的密钥。请手动将其添加到支持 SSE 服务器的代理中，例如 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 会将其写入您的用户配置而不是当前文件夹，因此它不会出现在提交中。
隐私与支持
开发
在 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