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 में My settings → MCP server से कॉपी करें।

नीचे दिए गए उदाहरण 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 प्लगइन्स और Add to बटन हमेशा baserow.io की ओर इशारा करते हैं, इसलिए सेल्फ-होस्टेड Baserow पर उन एजेंटों के लिए केवल सर्वर जोड़ें।

Claude Code

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

जब यह URL पूछे, तो baserow.io रखने के लिए Esc दबाएं, या अपना सेल्फ-होस्टेड URL दर्ज करें। बाद में इसे बदलने के लिए, /plugin configure baserow@baserow चलाएं।

Claude.ai और Claude Desktop

Customize → Connectors → + Add → Add custom connector। इसे Baserow नाम दें और अपना सर्वर URL दर्ज करें। Team और Enterprise योजनाओं पर एक मालिक इसे Organization settings → Connectors के अंतर्गत जोड़ता है।

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 पर, केवल सर्वर जोड़ें: 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 बटन।

वर्कस्पेस या टूल बदलने के लिए, फिर से साइन इन करें: अपने एजेंट में सर्वर को फिर से प्रमाणित करें, या Baserow में My settings → MCP server के अंतर्गत ऐप को डिस्कनेक्ट करें और फिर से कनेक्ट करें। एक साधारण पुनः कनेक्शन पुराने साइन-इन को बनाए रखता है।

समस्या निवारण

• कोई टूल गायब है, या कोई डेटाबेस सूचीबद्ध नहीं है। कनेक्शन में केवल वही वर्कस्पेस और टूल हैं जो आपने साइन-इन पर चुने थे। ऊपर बताए अनुसार फिर से साइन इन करें। टेबल या फ़ील्ड बदलने वाले टूल MCP पर उपलब्ध नहीं हैं।
• साइन-इन कभी शुरू नहीं होता, या क्लाइंट कहता है कि सर्वर OAuth या क्लाइंट पंजीकरण का समर्थन नहीं करता। सेल्फ-होस्टेड Baserow पर, सेल्फ-होस्टेड आवश्यकताएँ जांचें।
• आपके द्वारा टाइप किए गए URL के साथ कनेक्शन विफल होता है। URL को बिल्कुल वैसे ही कॉपी करें जैसे My settings → MCP server दिखाता है। यह /mcp में समाप्त होता है, बिना किसी अनुगामी स्लैश के।
• Claude Code में दो Baserow सर्वर। यदि claude mcp list प्लगइन का plugin:baserow:baserow और एक baserow सर्वर दिखाता है जिसे आपने हाथ से जोड़ा है, तो जो कनेक्ट होता है उसे रखें। claude plugin disable baserow@baserow प्लगइन के सर्वर को बंद कर देता है; claude mcp remove baserow आपके सर्वर को हटा देता है।

एंडपॉइंट कुंजियाँ

Baserow 2.4.1 और पुराने केवल एक एंडपॉइंट कुंजी स्वीकार करते हैं, और प्लगइन इसे सेट नहीं करता। My settings → MCP server से एंडपॉइंट 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 इसे वर्तमान फ़ोल्डर के बजाय आपके उपयोगकर्ता कॉन्फ़िग में लिखता है, ताकि यह किसी कमिट में समाप्त न हो सके।

गोपनीयता और समर्थन

• गोपनीयता नीति: https://baserow.io/privacy-policy
• शर्तें: https://baserow.io/terms-and-conditions
• सहायता: सामुदायिक फ़ोरम या हमसे संपर्क करें

विकास

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