Xata MCP server
आधिकारिकXata MCP सर्वर AI सहायकों और एजेंटों को आपके Xata संगठनों, प्रोजेक्ट्स और Postgres डेटाबेस शाखाओं के साथ इंटरैक्ट करने की सुविधा देता है।
Xata MCP के साथ आप क्या कर सकते हैं?
- अपनी पहचान सत्यापित करें — सहायक से
user_infoका उपयोग करके पुष्टि करने को कहें कि आप किस रूप में प्रमाणित हैं। - अपने डेटाबेस स्कीमा का अन्वेषण करें — सहायक से
describe_schemaके साथ किसी ब्रांच में टेबल और कॉलम सूचीबद्ध करने को कहें। - केवल-पठन SQL क्वेरी चलाएँ — सहायक से अपने डेटा का विश्लेषण करने के लिए किसी ब्रांच के विरुद्ध
run_sqlनिष्पादित करने को कहें। - API ऑपरेशन खोजें — अपना इरादा बताकर सही Xata REST API एंडपॉइंट खोजने के लिए
search_operationsका उपयोग करें। - रीड API कॉल आमंत्रित करें — ऑपरेशन का वर्णन करने के बाद सहायक को
call_read_operationके माध्यम से संसाधन प्राप्त करने दें। - Xata दस्तावेज़ खोजें — सहायक से
search_xataका उपयोग करके प्रासंगिक दस्तावेज़ खोजने या पथ द्वारा किसी विशिष्ट पृष्ठ को पढ़ने के लिए कहें।
दस्तावेज़
मुख्य सामग्री पर जाएं
Xata MCP सर्वर AI सहायकों और एजेंटों को मॉडल कॉन्टेक्स्ट प्रोटोकॉल (MCP) का उपयोग करके आपके Xata संगठनों, प्रोजेक्ट्स और शाखाओं के साथ इंटरैक्ट करने देता है।
Xata MCP सर्वर क्या है?
- एक होस्टेड MCP सर्वर जो Xata API के साथ चलता है — स्थानीय रूप से इंस्टॉल या चलाने के लिए कुछ भी नहीं है।
- आपके ब्राउज़र में OAuth के माध्यम से, या हेडलेस वातावरण के लिए Xata API कुंजी के साथ प्रमाणीकृत।
- स्ट्रीमेबल HTTP पर रिमोट सर्वर का समर्थन करने वाले किसी भी MCP क्लाइंट से सुलभ।
सर्वर URL:
https://api.xata.tech/mcp
सर्वर स्ट्रीमेबल HTTP ट्रांसपोर्ट का उपयोग करता है। कोई SSE एंडपॉइंट नहीं है और सर्वर का कोई स्थानीय (npm) संस्करण नहीं है।
प्रमाणीकरण
MCP सर्वर दो प्रमाणीकरण विधियों का समर्थन करता है:
| विधि | कब उपयोग करें | क्लाइंट आवश्यकता |
|---|---|---|
| OAuth | संपादक/चैट में इंटरैक्टिव उपयोग | MCP OAuth के लिए समर्थन (डायनामिक क्लाइंट पंजीकरण) |
| API कुंजी | ऑटोमेशन, CI, हेडलेस एजेंट | कस्टम HTTP हेडर के लिए समर्थन |
OAuth
OAuth-सक्षम क्लाइंट के साथ, आपको केवल सर्वर URL की आवश्यकता है। जब आपका क्लाइंट पहली बार कनेक्ट होता है, तो यह Xata के साथ खुद को पंजीकृत करता है, एक ब्राउज़र विंडो खोलता है, और आपको अपने Xata खाते में साइन इन करने और पहुंच को मंजूरी देने के लिए कहता है। टोकन अल्पकालिक होते हैं और MCP सर्वर तक सीमित होते हैं।
API कुंजी
कस्टम हेडर का समर्थन करने वाले क्लाइंट इसके बजाय Xata API कुंजी से प्रमाणीकृत कर सकते हैं:
Authorization: Bearer YOUR_XATA_API_KEY
मौजूदा कुंजी का पुन: उपयोग करने के बजाय MCP पहुंच के लिए एक समर्पित API कुंजी बनाएं। इसे एक पर्यावरण चर या अपने क्लाइंट के गुप्त भंडारण में संग्रहीत करें — इसे कभी भी स्रोत नियंत्रण में प्रतिबद्ध न करें।
अपना MCP क्लाइंट सेट करें
कर्सर
कर्सर त्वरित OAuth सेटअप के लिए एक डीप लिंक प्रदान करता है:कर्सर में जोड़ें
वैकल्पिक रूप से, आप इसे मैन्युअल रूप से जोड़ सकते हैं:
- कमांड पैलेट खोलें और "कर्सर सेटिंग्स" खोजें।
- टूल्स और MCP के तहत, नया MCP सर्वर पर क्लिक करें।
- खुलने वाली कॉन्फ़िगरेशन फ़ाइल में Xata सर्वर जोड़ें:
.cursor/mcp.json
{
"mcpServers": {
"xata": {
"url": "https://api.xata.tech/mcp"
}
}
}
- फ़ाइल सहेजें। कर्सर आपको प्रमाणीकृत करने के लिए संकेत देता है — ब्राउज़र प्रवाह का पालन करें और अपने Xata खाते तक पहुंच को मंजूरी दें।
क्लॉड कोड
अपने टर्मिनल से सर्वर जोड़ें:
claude mcp add --transport http xata https://api.xata.tech/mcp
फिर क्लॉड कोड शुरू करें और /mcp स्लैश कमांड चलाएं। xata सर्वर चुनें और प्रमाणीकृत करने के लिए ब्राउज़र निर्देशों का पालन करें। OAuth के बजाय API कुंजी का उपयोग करने के लिए (उदाहरण के लिए, CI में):
claude mcp add --transport http xata https://api.xata.tech/mcp
--header "Authorization: Bearer YOUR_XATA_API_KEY"
VS कोड
VS कोड में MCP सर्वर के लिए GitHub Copilot और GitHub Copilot Chat एक्सटेंशन की आवश्यकता होती है।
- कमांड पैलेट खोलें (
Cmd+Shift+P/Ctrl+Shift+P)। - MCP: सर्वर जोड़ें चलाएं और HTTP चुनें।
- URL के रूप में
https://api.xata.tech/mcpऔर नाम के रूप मेंxataदर्ज करें।
वैकल्पिक रूप से, इसे मैन्युअल रूप से अपने कॉन्फ़िगरेशन में जोड़ें:
.vscode/mcp.json
{
"servers": {
"xata": {
"type": "http",
"url": "https://api.xata.tech/mcp"
}
}
}
MCP: सर्वर सूची से सर्वर शुरू करें और संकेत मिलने पर इसे प्रमाणीकृत करने दें।
क्लॉड (वेब और डेस्कटॉप)
Xata को एक कस्टम कनेक्टर के रूप में जोड़ें:
- सेटिंग्स → कनेक्टर्स पर जाएं।
- कस्टम कनेक्टर जोड़ें पर क्लिक करें।
- सर्वर URL के रूप में
https://api.xata.tech/mcpदर्ज करें और जोड़ें पर क्लिक करें। - अपने Xata खाते से साइन इन करने के लिए संकेतों का पालन करें।
रिमोट MCP का उपयोग करने वाले कस्टम कनेक्टर सभी क्लॉड योजनाओं पर उपलब्ध नहीं हैं, और टीम योजनाओं पर उन्हें जोड़ने के लिए एक संगठन स्वामी की आवश्यकता हो सकती है। विवरण के लिए क्लॉड दस्तावेज़ीकरण देखें।
ChatGPT
कस्टम कनेक्टर का उपयोग करके ChatGPT को Xata से कनेक्ट करें:
- ChatGPT में, सेटिंग्स → कनेक्टर्स → उन्नत सेटिंग्स पर जाएं और डेवलपर मोड सक्षम करें।
- कनेक्टर्स टैब पर, सर्वर URL के साथ एक नया कनेक्टर बनाएं:
https://api.xata.tech/mcp
- प्रमाणीकरण के लिए OAuth चुनें और संकेत मिलने पर प्राधिकरण प्रवाह पूरा करें।
- प्रत्येक चैट में जहां आप Xata का उपयोग करना चाहते हैं, + बटन पर क्लिक करें और स्रोत जोड़ें के तहत Xata कनेक्टर सक्षम करें।
कोडेक्स CLI
Xata सर्वर जोड़ें:
codex mcp add xata --url https://api.xata.tech/mcp
add कमांड एक ब्राउज़र खोल सकता है और OAuth त्रुटि की रिपोर्ट कर सकता है। यदि ऐसा होता है, तो नीचे दिए गए लॉगिन कमांड के साथ जारी रखें; xata सर्वर प्रविष्टि पहले ही सहेजी जा चुकी है।
स्पष्ट OAuth स्कोप का उपयोग करके Xata के साथ प्रमाणीकृत करें:
codex mcp login xata --scopes mcp-client,offline_access
ब्राउज़र में प्राधिकरण पूरा करें। offline_access स्कोप कोडेक्स को किसी अन्य ब्राउज़र प्राधिकरण की आवश्यकता के बिना अपने Xata सत्र को ताज़ा करने की अनुमति देता है। फिर codex शुरू करें, /mcp चलाएं, और सत्यापित करें कि xata कनेक्टेड और प्रमाणीकृत है।
एंटीग्रैविटी CLI
अपने वैश्विक MCP कॉन्फ़िगरेशन में Xata जोड़ें:
~/.gemini/config/mcp_config.json
{
"mcpServers": {
"xata": {
"serverUrl": "https://api.xata.tech/mcp"
}
}
}
केवल एक प्रोजेक्ट के लिए Xata सक्षम करने के लिए, इसके बजाय उस प्रोजेक्ट के रूट में .agents/mcp_config.json का उपयोग करें। agy शुरू करें और /mcp दर्ज करें। MCP प्रबंधक में, xata के लिए प्रमाणीकृत करें का उपयोग करें और OAuth पूरा करने के लिए संकेतों का पालन करें।
OpenCode
अपनी OpenCode कॉन्फ़िगरेशन फ़ाइल में Xata सर्वर जोड़ें:
~/.config/opencode/opencode.json
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"xata": {
"type": "remote",
"url": "https://api.xata.tech/mcp"
}
}
}
फिर अपने टर्मिनल से प्रमाणीकृत करें:
opencode mcp auth xata
Amp
अपने टर्मिनल से सर्वर जोड़ें:
amp mcp add xata https://api.xata.tech/mcp
फिर amp शुरू करें — आपको ब्राउज़र में प्रमाणीकृत करने के लिए संकेत दिया जाना चाहिए। यह पुष्टि करने के लिए /mcp list tools चलाएं कि सर्वर कनेक्टेड है।
Windsurf
- Windsurf में, कैस्केड पैनल खोलें और MCP (हथौड़ा) आइकन पर क्लिक करें, फिर कच्ची कॉन्फ़िगरेशन फ़ाइल (
~/.codeium/windsurf/mcp_config.json) खोलने के लिए कॉन्फ़िगर करें पर क्लिक करें। - Xata सर्वर प्रविष्टि जोड़ें:
~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"xata": {
"serverUrl": "https://api.xata.tech/mcp"
}
}
}
- फ़ाइल सहेजें और कैस्केड साइडबार में ताज़ा करें पर क्लिक करें। ब्राउज़र विंडो खुलने पर OAuth प्रवाह पूरा करें।
Zed
- सेटिंग्स → AI → MCP सर्वर खोलें और सर्वर जोड़ें → रिमोट सर्वर जोड़ें पर क्लिक करें, या अपनी सेटिंग्स फ़ाइल को सीधे संपादित करें:
settings.json
{
"context_servers": {
"xata": {
"url": "https://api.xata.tech/mcp"
}
}
}
- Zed आपको मानक MCP OAuth प्रवाह का उपयोग करके सर्वर के खिलाफ प्रमाणीकृत करने के लिए संकेत देता है।
Cline
- VS कोड में Cline खोलें और MCP सर्वर आइकन पर क्लिक करें।
- रिमोट सर्वर टैब में, नाम के रूप में
xata, URL के रूप मेंhttps://api.xata.tech/mcpदर्ज करें, और ट्रांसपोर्ट के रूप में स्ट्रीमेबल HTTP चुनें। या कॉन्फ़िगरेशन JSON को सीधे संपादित करें:
{
"mcpServers": {
"xata": {
"type": "streamableHttp",
"url": "https://api.xata.tech/mcp"
}
}
}
ट्रांसपोर्ट प्रकार streamableHttp (कैमलकेस) होना चाहिए। इसे छोड़ने पर Cline लीगेसी SSE ट्रांसपोर्ट पर वापस आ जाता है, जिसे Xata MCP सर्वर समर्थन नहीं करता है।
अन्य MCP क्लाइंट
कोई भी MCP क्लाइंट कनेक्ट हो सकता है यदि वह समर्थन करता है:
- स्ट्रीमेबल HTTP पर रिमोट MCP सर्वर (SSE नहीं)
- डायनामिक क्लाइंट पंजीकरण के साथ OAuth, या API कुंजी प्रमाणीकरण के लिए कस्टम HTTP हेडर
रिमोट MCP सर्वर को कॉन्फ़िगर करने के लिए अपने क्लाइंट के दस्तावेज़ीकरण से परामर्श करें, और URL के रूप में https://api.xata.tech/mcp का उपयोग करें।
कनेक्शन सत्यापित करें
कनेक्ट करने के बाद, अपने सहायक से पूछें:
Xata MCP सर्वर का उपयोग करके मुझे बताएं कि मैं किसके रूप में प्रमाणीकृत हूं।
सहायक को user_info टूल को कॉल करना चाहिए और आपकी उपयोगकर्ता पहचान (या API कुंजी पहचान, यदि आपने एक कुंजी के साथ प्रमाणीकृत किया है) लौटानी चाहिए। यदि ऐसा होता है, तो कनेक्शन काम कर रहा है।
उपलब्ध उपकरण
Xata MCP सर्वर निम्नलिखित उपकरणों को उजागर करता है:
| उपकरण | विवरण |
|---|---|
user_info | प्रमाणीकृत कॉलर की पहचान लौटाता है — OAuth के लिए आपकी उपयोगकर्ता ID और ईमेल, या API कुंजी ID। |
search_operations | इरादे से एक Xata REST API ऑपरेशन खोजें (उदाहरण के लिए, "शाखाएं सूचीबद्ध करें" या "सदस्य आमंत्रित करें")। |
describe_operation | किसी विशिष्ट ऑपरेशन के लिए पैरामीटर और अनुरोध/प्रतिक्रिया स्कीमा लौटाएं। |
call_read_operation | एक रीड-ओनली Xata REST API ऑपरेशन लागू करें। |
call_write_operation | एक Xata REST API ऑपरेशन लागू करें जो डेटा बनाता या अपडेट करता है। |
call_destructive_operation | एक Xata REST API ऑपरेशन लागू करें जो डेटा को नष्ट करता है या पहुंच रद्द करता है। confirm=true की आवश्यकता है। |
run_sql | एक शाखा के खिलाफ SQL चलाएं। डिफ़ॉल्ट रूप से रीड-ओनली; डेटा को बदलने वाले स्टेटमेंट चलाने के लिए write=true पास करें। |
describe_schema | एक शाखा की तालिकाओं और स्तंभों को सूचीबद्ध करें। |
list_skills | उपलब्ध Xata कौशल सूचीबद्ध करें — सामान्य बहु-चरणीय कार्यों के लिए निर्देशित वर्कफ़्लो। |
get_skill | किसी विशिष्ट कौशल के लिए निर्देश पढ़ें। |
search_xata | Xata दस्तावेज़ीकरण खोजें। |
query_docs_filesystem_xata | पथ द्वारा Xata दस्तावेज़ीकरण पृष्ठ पढ़ें। |
सुरक्षा
- इंटरैक्टिव क्लाइंट के लिए OAuth को प्राथमिकता दें; टोकन अल्पकालिक होते हैं और आपके क्लाइंट में सर्वर को डिस्कनेक्ट करके रद्द किए जा सकते हैं।
- ऑटोमेशन के लिए, एक समर्पित API कुंजी का उपयोग करें और इसे नियमित रूप से घुमाएं।
- कुछ उपकरण आपके डेटा को संशोधित कर सकते हैं:
call_write_operationऔरcall_destructive_operationसंसाधनों को बदल या हटा सकते हैं (बाद वाले कोconfirm=trueकी आवश्यकता होती है), औरrun_sqlwrite=trueके साथ बुलाए जाने पर डेटा को बदल सकता है। अनुमोदन से पहले अपने सहायक द्वारा प्रस्तावित कार्यों की समीक्षा करें, और किसी भी लेखन या हटाने के लिए एक मानव को लूप में रखें।
समस्या निवारण
प्रमाणीकरण विफल होता रहता है या लूप करता है। अपने क्लाइंट से Xata सर्वर निकालें, क्लाइंट को पुनरारंभ करें, और एक ताज़ा OAuth प्रवाह ट्रिगर करने के लिए सर्वर को फिर से जोड़ें। सर्वर कनेक्ट होता है लेकिन कोई उपकरण नहीं दिखता है। सुनिश्चित करें कि आपने प्रमाणीकरण चरण पूरा कर लिया है — अधिकांश उपकरणों को प्रकट होने से पहले एक वैध सत्र की आवश्यकता होती है। अपने क्लाइंट के प्रमाणीकरण प्रवाह को फिर से चलाएं, फिर इसकी उपकरण सूची को ताज़ा करें। पूर्ण सेट के लिए उपलब्ध उपकरण देखें। आपका क्लाइंट बिल्कुल भी कनेक्ट नहीं हो सकता है। पुष्टि करें कि URL बिल्कुल https://api.xata.tech/mcp है और आपका क्लाइंट स्ट्रीमेबल HTTP का समर्थन करता है। केवल-SSE क्लाइंट समर्थित नहीं हैं। सर्वर आपके क्लाइंट में दिखाई नहीं देता है। क्लाइंट की MCP कॉन्फ़िगरेशन फ़ाइल सिंटैक्स की जाँच करें — JSON आकार क्लाइंट के बीच भिन्न होता है (mcpServers बनाम servers बनाम context_servers, url बनाम serverUrl) — और क्लाइंट के लॉग की जाँच करें। अधिकांश क्लाइंट को कॉन्फ़िगरेशन परिवर्तनों के बाद पूर्ण पुनरारंभ की आवश्यकता होती है।
क्या यह पृष्ठ सहायक था?