Baserow
官方讀取和寫入您的 Baserow 表格。
你可以用 Baserow MCP 做什麼?
- 搜尋工作區 — 請你的代理程式透過
baserow-workspace搜尋你在 Baserow 工作區中可查看的所有內容。 - 讀取及編輯資料庫 — 透過
baserow-databases讀取資料庫、資料表、欄位、檢視和資料列,然後建立或變更這些項目,包括排序、隱藏欄位和資料列顏色。 - 管理自動化 — 透過
baserow-automations讀取工作流程和節點、建立自動化、變更節點,以及發佈或暫停工作流程。 - 建立儀表板 — 透過
baserow-dashboards讀取儀表板和小工具數據,並建立或變更儀表板和小工具。 - 使用應用程式 — 透過
baserow-app-builder讀取及變更頁面、資料來源、元素、動作、樣式和主題,並設定登入功能。 - 檢視稽核記錄 — 若持有進階版或企業版授權,且具備工作區管理員權限,即可讀取工作區中的操作記錄。
文件
Baserow MCP
將你的 AI 代理連線至 Baserow。你的代理可以在一個 Baserow 工作區中讀取及建立資料庫、自動化、儀表板和應用程式,只使用你允許的工具。
此儲存庫會安裝 Baserow 的 MCP 伺服器和簡短技能,教導代理如何使用它:baserow-basics 用於資料列及其他缺少的功能,baserow-databases 用於資料庫、資料表、欄位和檢視,baserow-automations 用於工作流程,baserow-dashboards 用於儀表板,baserow-app-builder 用於應用程式建置工具,baserow-workspace 用於搜尋、資料列留言和稽核記錄。它適用於 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,也請執行 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.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 頁面。登入、選擇工作區,並勾選代理可以使用的工具。工具依功能分組:
- 工作區:搜尋使用者可見的所有內容。
- 資料庫:讀取資料庫、資料表、欄位、檢視、資料列和資料列留言;建立及變更這些項目,包括檢視排序、隱藏欄位和資料列顏色,並發佈留言;刪除資料列、欄位、檢視、篩選器和資料列顏色。
- 自動化:讀取工作流程及其節點;建立自動化和工作流程、變更節點,以及發佈或暫停工作流程;刪除節點。
- 儀表板:讀取儀表板和小工具數據;建立儀表板和小工具並加以變更;刪除小工具。
- 應用程式建置工具:讀取頁面、資料來源、元素和動作;建立及變更應用程式、頁面、元素、動作、樣式和佈景主題,並設定登入;刪除資料表欄和選單項目。
- 稽核記錄:讀取工作區中的操作紀錄。需要進階或企業授權,以及工作區管理員權限。
首次連線時會勾選「唯讀」預設選項。它涵蓋搜尋,以及讀取資料庫、儀表板和應用程式建置工具;若要代理使用其他功能,請啟用相應工具。資料列留言、資料列顏色和圖表需要進階授權。你能看到哪些工具取決於 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。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。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 則為其他讀取 Claude 格式外掛的工具(例如 GitHub Copilot CLI 和 Cursor)提供 baserow.io URL。
授權條款
MIT