Baserow

Baserow MCP

Kết nối tác nhân AI của bạn với Baserow. Tác nhân của bạn có thể đọc và thay đổi các bảng trong một không gian làm việc Baserow, chỉ sử dụng các công cụ bạn cho phép khi đăng nhập.

Kho lưu trữ này cài đặt máy chủ MCP của Baserow và một kỹ năng ngắn dạy tác nhân cách sử dụng nó. Nó hoạt động với Claude, ChatGPT, Codex, Cursor, VS Code, GitHub Copilot, Gemini CLI, OpenCode, Zed, Goose, Windsurf, Pi và các tác nhân khác.

URL máy chủ

• baserow.io: https://api.baserow.io/mcp
• Tự lưu trữ: URL backend của bạn theo sau bởi /mcp, ví dụ https://baserow.example.com/mcp. Sao chép từ Cài đặt của tôi → Máy chủ MCP trong Baserow.

Các ví dụ bên dưới sử dụng URL baserow.io. Trên Baserow tự lưu trữ, hãy sử dụng URL của riêng bạn.

Bắt đầu nhanh

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

add-mcp tìm các tác nhân bạn đã cài đặt và hỏi bạn muốn thêm Baserow vào tác nhân nào. Bỏ chọn Claude Desktop nếu nó được liệt kê và thêm Baserow ở đó như một trình kết nối tùy chỉnh thay vào đó. skills add sao chép kỹ năng baserow-basics vào thư mục kỹ năng của các tác nhân của bạn. Trên Baserow tự lưu trữ, hãy chạy skills add nữa, vì chỉ các plugin bên dưới bao gồm kỹ năng này.

Yêu cầu tự lưu trữ

• Phiên bản Baserow mới hơn 2.4.1. Các phiên bản cũ hơn không có /mcp hoặc đăng nhập; sử dụng khóa điểm cuối ở đó.
• BASEROW_MCP_OAUTH_ENABLED=true trên backend. Nó tắt theo mặc định.
• URL backend HTTPS công khai, để các ứng dụng lưu trữ như Claude.ai và ChatGPT có thể truy cập, và HTTPS gửi đi từ backend, nơi tải siêu dữ liệu máy khách của các ứng dụng.
• Bộ đảo ngược proxy của bạn gửi /mcp và các đường dẫn dưới /mcp/, /oauth/, /.well-known/oauth-authorization-server và /.well-known/oauth-protected-resource đến backend. Khớp /mcp chính xác, không phải như một tiền tố: giao diện người dùng phục vụ trang đăng nhập tại /mcp-authorize/.

Xem Đăng nhập OAuth MCP cho Baserow tự lưu trữ.

Cài đặt theo tác nhân

Tác nhân	baserow.io	Tự lưu trữ
Claude Code	Plugin	Cùng plugin, nhập URL của bạn khi được hỏi
Claude.ai, Claude Desktop	Trình kết nối tùy chỉnh	Tương tự, với URL của bạn
ChatGPT	Máy chủ MCP tùy chỉnh	Tương tự, với URL của bạn
Codex	Plugin	codex mcp add baserow --url <your url>
GitHub Copilot CLI	Plugin	Chỉ máy chủ
Gemini CLI	gemini extensions install https://github.com/baserow/baserow-mcp	gemini mcp add -s user -t http baserow <your url>
Cursor	Thêm vào Cursor	Tệp cấu hình
VS Code	Thêm vào VS Code	Tệp cấu hình
Goose	Thêm vào Goose	Bắt đầu nhanh với URL của bạn
OpenCode, Windsurf, Zed	Tệp cấu hình	Tương tự, với URL của bạn
Bất kỳ tác nhân nào khác	Bắt đầu nhanh	Tương tự, với URL của bạn

Các plugin Codex, Copilot và Gemini và các nút Thêm vào luôn trỏ đến baserow.io, vì vậy trên Baserow tự lưu trữ chỉ thêm máy chủ cho các tác nhân đó.

Claude Code

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

Khi nó hỏi URL, nhấn Esc để giữ baserow.io, hoặc nhập URL tự lưu trữ của bạn. Để thay đổi sau này, chạy /plugin configure baserow@baserow.

Claude.ai và Claude Desktop

Tùy chỉnh → Trình kết nối → + Thêm → Thêm trình kết nối tùy chỉnh. Đặt tên là Baserow và nhập URL máy chủ của bạn. Trên các gói Team và Enterprise, chủ sở hữu thêm nó dưới Cài đặt tổ chức → Trình kết nối.

ChatGPT

Mở Plugins, chọn nút cộng, sau đó Thêm máy chủ MCP tùy chỉnh, và nhập URL máy chủ của bạn. Tên menu thay đổi thường xuyên. Trên các gói Business và Enterprise, quản trị viên phải cho phép các máy chủ MCP tùy chỉnh trước.

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

Trên Baserow tự lưu trữ, chỉ thêm máy chủ: copilot mcp add --transport http baserow <your url>. Nếu plugin được cài đặt, hãy gỡ cài đặt nó trước với copilot plugin uninstall baserow; máy chủ của nó thay thế của bạn mà không có cảnh báo.

Tệp cấu hình

Để chỉ thêm máy chủ, không có plugin:

• 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, sau đó 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, cài đặt:

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

Đăng nhập

Tác nhân của bạn mở một trang Baserow trong trình duyệt của bạn. Đăng nhập, chọn không gian làm việc và đánh dấu các công cụ tác nhân có thể sử dụng. Các công cụ đọc cho phép tác nhân duyệt cơ sở dữ liệu, bảng và hàng; các công cụ ghi cho phép nó tạo, cập nhật và xóa hàng. Chỉ các công cụ đọc được đánh dấu trong lần kết nối đầu tiên.

Nơi đăng nhập bắt đầu:

• Claude Code: chạy /mcp, chọn plugin:baserow:baserow và xác thực.
• Codex: codex mcp login baserow.
• Gemini CLI: /mcp auth baserow.
• Claude.ai, ChatGPT, Cursor và VS Code: nút Kết nối hoặc Đăng nhập bên cạnh máy chủ.

Để thay đổi không gian làm việc hoặc công cụ, đăng nhập lại: xác thực lại máy chủ trong tác nhân của bạn, hoặc ngắt kết nối ứng dụng dưới Cài đặt của tôi → Máy chủ MCP trong Baserow và kết nối lại. Một kết nối lại đơn giản giữ đăng nhập cũ.

Khắc phục sự cố

• Một công cụ bị thiếu, hoặc không có cơ sở dữ liệu nào được liệt kê. Kết nối chỉ có không gian làm việc và công cụ bạn chọn khi đăng nhập. Đăng nhập lại như mô tả ở trên. Các công cụ thay đổi bảng hoặc trường không khả dụng qua MCP.
• Đăng nhập không bao giờ bắt đầu, hoặc máy khách nói máy chủ không hỗ trợ OAuth hoặc đăng ký máy khách. Trên Baserow tự lưu trữ, kiểm tra yêu cầu tự lưu trữ.
• Kết nối thất bại với URL bạn đã nhập. Sao chép URL chính xác như Cài đặt của tôi → Máy chủ MCP hiển thị. Nó kết thúc bằng /mcp, không có dấu gạch chéo cuối.
• Hai máy chủ Baserow trong Claude Code. Nếu claude mcp list hiển thị plugin:baserow:baserow của plugin và một máy chủ baserow bạn thêm bằng tay, hãy giữ cái kết nối. claude plugin disable baserow@baserow tắt của plugin; claude mcp remove baserow xóa của bạn.

Khóa điểm cuối

Baserow 2.4.1 và cũ hơn chỉ chấp nhận khóa điểm cuối, và plugin không thiết lập điều này. Sao chép URL điểm cuối từ Cài đặt của tôi → Máy chủ MCP. Nó kết thúc bằng /sse và chứa khóa của bạn. Thêm nó bằng tay vào một tác nhân hỗ trợ máy chủ SSE, như Claude Code, Cursor hoặc VS Code; Codex và Goose không:

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

Các phiên bản mới hơn cũng chấp nhận khóa như một tiêu đề trên /mcp, hữu ích cho các tập lệnh:

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

Khóa cung cấp quyền truy cập đầy đủ vào không gian làm việc của nó. -g ghi nó vào cấu hình người dùng của bạn thay vì thư mục hiện tại, để nó không thể xuất hiện trong một commit.

Quyền riêng tư và hỗ trợ

• Chính sách quyền riêng tư: https://baserow.io/privacy-policy
• Điều khoản: https://baserow.io/terms-and-conditions
• Trợ giúp: diễn đàn cộng đồng hoặc liên hệ chúng tôi

Phát triển

Trong scripts/, chạy npm install, sau đó npm test và npm run check. CI chạy các kiểm tra tương tự. Công cụ nằm ở đó để cài đặt plugin không cài đặt các phụ thuộc của nó.

Plugin Claude Code khai báo máy chủ của nó trong .claude-plugin/plugin.json, để nó có thể sử dụng URL bạn nhập. .mcp.json giữ URL baserow.io cho các công cụ khác đọc plugin định dạng Claude, như GitHub Copilot CLI và Cursor.

Giấy phép

MIT