Baserow

ทางการ

สิทธิ์ในการอ่านและเขียนตาราง Baserow ของคุณ

คุณทำอะไรได้บ้างด้วย Baserow MCP?

  • เรียกดูข้อมูล Baserow — ให้ผู้ช่วยของคุณแสดงรายการฐานข้อมูล ตาราง และแถวข้อมูลจากพื้นที่ทำงานที่เชื่อมต่ออยู่
  • อ่านเนื้อหาตาราง — ให้ผู้ช่วยของคุณดึงข้อมูลและสรุปจากตารางเฉพาะที่คุณอนุญาต
  • สร้างแถวใหม่ — สั่งให้ผู้ช่วยของคุณเพิ่มระเบียนลงในตารางโดยใช้เครื่องมือเขียนที่คุณเปิดใช้งาน
  • อัปเดตแถวที่มีอยู่ — ขอให้ผู้ช่วยของคุณแก้ไขค่าฟิลด์ในแถวข้อมูลทั่วพื้นที่ทำงาน Baserow ของคุณ
  • ลบแถว — สั่งให้ผู้ช่วยของคุณลบระเบียนออกจากตาราง ภายใต้สิทธิ์ที่คุณให้ไว้เมื่อเข้าสู่ระบบ

เอกสาร

Baserow MCP

เชื่อมต่อเอเจนต์ AI ของคุณกับ Baserow เอเจนต์ของคุณสามารถอ่านและแก้ไขตารางในเวิร์กสเปซ Baserow หนึ่งแห่ง โดยใช้เฉพาะเครื่องมือที่คุณอนุญาตเมื่อเข้าสู่ระบบ

พื้นที่เก็บข้อมูลนี้ติดตั้งเซิร์ฟเวอร์ MCP ของ Baserow และสกิลสั้นๆ ที่สอนเอเจนต์วิธีใช้งาน ใช้งานได้กับ Claude, ChatGPT, Codex, Cursor, VS Code, GitHub Copilot, Gemini CLI, OpenCode, Zed, Goose, Windsurf, Pi และเอเจนต์อื่นๆ

URL ของเซิร์ฟเวอร์

  • baserow.io: https://api.baserow.io/mcp
  • Self-hosted: URL แบ็กเอนด์ของคุณตามด้วย /mcp เช่น https://baserow.example.com/mcp คัดลอกจาก การตั้งค่าของฉัน → เซิร์ฟเวอร์ MCP ใน Baserow

ตัวอย่างด้านล่างใช้ URL ของ baserow.io สำหรับ Baserow แบบ self-hosted ให้ใช้ 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 แบบ self-hosted ให้รัน skills add ด้วยเช่นกัน เนื่องจากเฉพาะปลั๊กอินด้านล่างเท่านั้นที่มีสกิลนี้

ข้อกำหนดสำหรับ self-hosted

  • เวอร์ชัน Baserow ที่ใหม่กว่า 2.4.1 เวอร์ชันเก่ากว่าไม่มี /mcp หรือการเข้าสู่ระบบ ให้ใช้ คีย์เอนด์พอยต์ แทน
  • BASEROW_MCP_OAUTH_ENABLED=true บนแบ็กเอนด์ โดยปกติปิดอยู่
  • URL แบ็กเอนด์ HTTPS สาธารณะ เพื่อให้แอปโฮสต์เช่น Claude.ai และ ChatGPT เข้าถึงได้ และต้องมี HTTPS ขาออกจากแบ็กเอนด์ ซึ่งใช้ดึงข้อมูลเมตาของไคลเอ็นต์ของแอป
  • พร็อกซีย้อนกลับของคุณส่ง /mcp และพาธภายใต้ /mcp/, /oauth/, /.well-known/oauth-authorization-server และ /.well-known/oauth-protected-resource ไปยังแบ็กเอนด์ ตรงกับ /mcp แบบตรงทั้งหมด ไม่ใช่แบบคำนำหน้า: ส่วนหน้าจะแสดงหน้าเข้าสู่ระบบที่ /mcp-authorize/

ดู การเข้าสู่ระบบ OAuth ของ MCP สำหรับ Baserow แบบ self-hosted

ติดตั้งตามเอเจนต์

เอเจนต์baserow.ioSelf-hosted
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 รวมถึงปุ่ม Add to ชี้ไปที่ baserow.io เสมอ ดังนั้นบน Baserow แบบ self-hosted ให้เพิ่มเฉพาะเซิร์ฟเวอร์สำหรับเอเจนต์เหล่านั้น

Claude Code

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

เมื่อถาม URL ให้กด Esc เพื่อใช้ baserow.io หรือป้อน URL แบบ self-hosted ของคุณ หากต้องการเปลี่ยนภายหลัง ให้รัน /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 แบบ self-hosted ให้เพิ่มเฉพาะเซิร์ฟเวอร์: 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: ปุ่ม Connect หรือ Sign in ถัดจากเซิร์ฟเวอร์

หากต้องการเปลี่ยนเวิร์กสเปซหรือเครื่องมือ ให้ลงชื่อเข้าอีกครั้ง: ตรวจสอบสิทธิ์เซิร์ฟเวอร์ในเอเจนต์ของคุณอีกครั้ง หรือยกเลิกการเชื่อมต่อแอปภายใต้ การตั้งค่าของฉัน → เซิร์ฟเวอร์ MCP ใน Baserow แล้วเชื่อมต่อใหม่ การเชื่อมต่อใหม่แบบธรรมดาจะคงการเข้าสู่ระบบเดิมไว้

การแก้ไขปัญหา

  • เครื่องมือหายไป หรือไม่มีฐานข้อมูลแสดง การเชื่อมต่อมีเฉพาะเวิร์กสเปซและเครื่องมือที่คุณเลือกเมื่อเข้าสู่ระบบ ลงชื่อเข้าอีกครั้งตามที่อธิบายไว้ข้างต้น เครื่องมือที่เปลี่ยนแปลงตารางหรือฟิลด์ไม่พร้อมใช้งานผ่าน MCP
  • การเข้าสู่ระบบไม่เริ่ม หรือไคลเอ็นต์แจ้งว่าเซิร์ฟเวอร์ไม่รองรับ OAuth หรือการลงทะเบียนไคลเอ็นต์ บน Baserow แบบ self-hosted ให้ตรวจสอบ ข้อกำหนดสำหรับ self-hosted
  • การเชื่อมต่อล้มเหลวด้วย URL ที่คุณพิมพ์ คัดลอก URL ตามที่แสดงใน การตั้งค่าของฉัน → เซิร์ฟเวอร์ MCP ตรงทั้งหมด ลงท้ายด้วย /mcp โดยไม่มีเครื่องหมายทับท้าย
  • เซิร์ฟเวอร์ Baserow สองตัวใน Claude Code หาก claude mcp list แสดง plugin:baserow:baserow ของปลั๊กอินและเซิร์ฟเวอร์ baserow ที่คุณเพิ่มด้วยตนเอง ให้เก็บตัวที่เชื่อมต่อได้ claude plugin disable baserow@baserow ปิดปลั๊กอิน; claude mcp remove baserow ลบของคุณ

คีย์เอนด์พอยต์

Baserow 2.4.1 และเก่ากว่ารองรับเฉพาะคีย์เอนด์พอยต์ และปลั๊กอินไม่ได้ตั้งค่านี้ คัดลอก URL เอนด์พอยต์จาก การตั้งค่าของฉัน → เซิร์ฟเวอร์ MCP ลงท้ายด้วย /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 เรียกใช้การตรวจสอบเดียวกัน เครื่องมืออยู่ที่นั่นเพื่อให้การติดตั้งปลั๊กอินไม่ติดตั้ง dependencies ของมัน

ปลั๊กอิน Claude Code ประกาศเซิร์ฟเวอร์ใน .claude-plugin/plugin.json เพื่อให้ใช้ URL ที่คุณป้อนได้ .mcp.json เก็บ URL ของ baserow.io สำหรับเครื่องมืออื่นๆ ที่อ่านปลั๊กอินรูปแบบ Claude เช่น GitHub Copilot CLI และ Cursor

สัญญาอนุญาต

MIT