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 的 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 CLIgemini extensions install https://github.com/baserow/baserow-mcpgemini 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