Xata MCP server

आधिकारिक

Xata MCP सर्वर AI सहायकों और एजेंटों को आपके Xata संगठनों, प्रोजेक्ट्स और Postgres डेटाबेस शाखाओं के साथ इंटरैक्ट करने की सुविधा देता है।

xata.io पर देखें

Xata MCP के साथ आप क्या कर सकते हैं?

API ऑपरेशन खोजें — अपने असिस्टेंट से किसी उद्देश्य के आधार पर Xata REST API ऑपरेशन ढूँढ़ने को कहें, जैसे ब्रांच की सूची बनाना या किसी सदस्य को आमंत्रित करना।
ऑपरेशन स्कीमा देखें — किसी विशिष्ट Xata API ऑपरेशन को कॉल करने से पहले उसके पैरामीटर और अनुरोध/प्रतिक्रिया स्कीमा प्राप्त करें।
केवल-पढ़ने वाले API कॉल चलाएँ — अपने असिस्टेंट के ज़रिए केवल-पढ़ने वाले Xata REST API ऑपरेशन चलाएँ, जैसे ब्रांच की सूची बनाना।
SQL से ब्रांच क्वेरी करें — किसी ब्रांच पर SQL चलाएँ; डिफ़ॉल्ट रूप से केवल पढ़ने की अनुमति होती है, जबकि लिखने के लिए स्पष्ट पुष्टि आवश्यक है।
ब्रांच स्कीमा देखें — उसकी संरचना समझने के लिए किसी ब्रांच की टेबल और कॉलम की सूची बनाएँ।
Xata दस्तावेज़ खोजें — Xata दस्तावेज़ खोजें या पाथ के आधार पर विशिष्ट दस्तावेज़ पेज पढ़ें।

दस्तावेज़

MCP Server

Cursor, Claude, VS Code और अन्य MCP क्लाइंट को Xata से कनेक्ट करें

Xata MCP server, AI सहायकों और एजेंटों को Model Context Protocol (MCP) का उपयोग करके आपके Xata संगठनों, प्रोजेक्ट और ब्रांच के साथ इंटरैक्ट करने देता है।

Xata MCP server क्या है?

एक होस्ट किया गया MCP server, जो Xata API के साथ चलता है — इसे इंस्टॉल करने या स्थानीय रूप से चलाने की कोई ज़रूरत नहीं है।
आपके ब्राउज़र में OAuth के ज़रिए या हेडलेस परिवेशों में Xata API key से प्रमाणित।
Streamable HTTP पर रिमोट सर्वर का समर्थन करने वाले किसी भी MCP क्लाइंट से उपलब्ध।

Server URL:

https://api.xata.tech/mcp

यह server Streamable HTTP ट्रांसपोर्ट का उपयोग करता है। कोई SSE endpoint या server का स्थानीय (npm) संस्करण उपलब्ध नहीं है।

प्रमाणीकरण

MCP server प्रमाणीकरण के दो तरीके समर्थित करता है:

तरीका	कब उपयोग करें	क्लाइंट की आवश्यकता
OAuth	एडिटर/चैट में इंटरैक्टिव उपयोग	MCP OAuth (डायनामिक क्लाइंट रजिस्ट्रेशन) का समर्थन
API key	ऑटोमेशन, CI, हेडलेस एजेंट	कस्टम HTTP हेडर का समर्थन

OAuth

OAuth-सक्षम क्लाइंट के साथ, आपको केवल server URL की ज़रूरत होती है। जब आपका क्लाइंट पहली बार कनेक्ट होता है, तो वह Xata के साथ अपना रजिस्ट्रेशन करता है, ब्राउज़र विंडो खोलता है और आपसे अपने Xata खाते में साइन इन करके ऐक्सेस की अनुमति देने को कहता है। टोकन की अवधि कम होती है और वे MCP server तक सीमित होते हैं।

API key

कस्टम हेडर का समर्थन करने वाले क्लाइंट इसके बजाय Xata API key से प्रमाणित कर सकते हैं:

Authorization: Bearer YOUR_XATA_API_KEY

[!WARNING]

MCP ऐक्सेस के लिए मौजूदा key का दोबारा उपयोग करने के बजाय एक अलग API key बनाएँ। इसे किसी environment variable या अपने क्लाइंट के secret storage में रखें — इसे कभी भी source control में commit न करें।

अपना MCP क्लाइंट सेट अप करें

Cursor

[!TIP]

Cursor, तुरंत OAuth सेटअप के लिए एक डीप लिंक देता है:

Cursor में जोड़ें

वैकल्पिक रूप से, इसे मैन्युअल रूप से जोड़ सकते हैं:

कमांड पैलेट खोलें और "Cursor Settings" खोजें।
Tools & MCP के अंतर्गत, New MCP Server पर क्लिक करें।
खुलने वाली कॉन्फ़िगरेशन फ़ाइल में Xata server जोड़ें:

{
  "mcpServers": {
    "xata": {
      "url": "https://api.xata.tech/mcp"
    }
  }
}

फ़ाइल सेव करें। Cursor आपसे प्रमाणित करने के लिए कहेगा — ब्राउज़र में दिए गए चरणों का पालन करें और अपने Xata खाते का ऐक्सेस मंज़ूर करें।

Claude Code

अपने टर्मिनल से server जोड़ें:

claude mcp add --transport http xata https://api.xata.tech/mcp

फिर Claude Code शुरू करें और /mcp slash command चलाएँ। xata server चुनें और प्रमाणित करने के लिए ब्राउज़र में दिए गए निर्देशों का पालन करें।

OAuth के बजाय API key का उपयोग करने के लिए (उदाहरण के लिए, CI में):

claude mcp add --transport http xata https://api.xata.tech/mcp \
  --header "Authorization: Bearer YOUR_XATA_API_KEY"

VS Code

VS Code में MCP servers के लिए GitHub Copilot और GitHub Copilot Chat एक्सटेंशन ज़रूरी हैं।

Command Palette (Cmd+Shift+P / Ctrl+Shift+P) खोलें।
MCP: Add Server चलाएँ और HTTP चुनें।
URL के रूप में https://api.xata.tech/mcp और नाम के रूप में xata दर्ज करें।

वैकल्पिक रूप से, इसे अपनी कॉन्फ़िगरेशन में मैन्युअल रूप से जोड़ें:

{
  "servers": {
    "xata": {
      "type": "http",
      "url": "https://api.xata.tech/mcp"
    }
  }
}

MCP: List Servers से server शुरू करें और संकेत मिलने पर उसे प्रमाणित होने दें।

Claude (वेब और डेस्कटॉप)

[!TIP]

Claude का कस्टम कनेक्टर डायलॉग खोलें, जिसमें Xata की जानकारी पहले से भरी हुई हो:

Xata को Claude से कनेक्ट करें

Claude में कनेक्टर की समीक्षा करके पुष्टि करें, फिर Xata से प्रमाणित करें।

वैकल्पिक रूप से, Xata को कस्टम कनेक्टर के रूप में मैन्युअल रूप से जोड़ें:

Settings → Connectors पर जाएँ।
Add custom connector पर क्लिक करें।
server URL के रूप में https://api.xata.tech/mcp दर्ज करें और Add पर क्लिक करें।
अपने Xata खाते से साइन इन करने के लिए दिए गए निर्देशों का पालन करें।

[!NOTE]

रिमोट MCP का उपयोग करने वाले कस्टम कनेक्टर सभी Claude प्लान पर उपलब्ध नहीं हैं, और टीम प्लान पर इन्हें जोड़ने के लिए संगठन के मालिक की ज़रूरत हो सकती है। विवरण के लिए Claude दस्तावेज़ देखें।

ChatGPT

कस्टम कनेक्टर का उपयोग करके ChatGPT को Xata से कनेक्ट करें:

ChatGPT में, Settings → Connectors → Advanced settings पर जाएँ और Developer mode सक्षम करें।
Connectors टैब पर, server URL के साथ एक नया कनेक्टर बनाएँ:

https://api.xata.tech/mcp

प्रमाणीकरण के लिए OAuth चुनें और संकेत मिलने पर प्राधिकरण प्रक्रिया पूरी करें।
हर उस चैट में जहाँ आप Xata का उपयोग करना चाहते हैं, + बटन पर क्लिक करें और Add sources के अंतर्गत Xata कनेक्टर सक्षम करें।

Codex CLI

Xata server जोड़ें:

codex mcp add xata --url https://api.xata.tech/mcp

[!NOTE]

add कमांड ब्राउज़र खोलकर OAuth त्रुटि दिखा सकती है। ऐसा होने पर, नीचे दिए गए लॉगिन कमांड के साथ आगे बढ़ें; xata server एंट्री पहले ही सेव हो चुकी है।

स्पष्ट OAuth स्कोप के साथ Xata से प्रमाणित करें:

codex mcp login xata --scopes mcp-client,offline_access

ब्राउज़र में प्राधिकरण पूरा करें। offline_access स्कोप, Codex को ब्राउज़र में दोबारा प्राधिकरण की ज़रूरत के बिना अपना Xata सत्र रिफ़्रेश करने देता है।

फिर codex शुरू करें, /mcp चलाएँ और पुष्टि करें कि xata कनेक्ट और प्रमाणित है।

Antigravity CLI

अपने वैश्विक MCP कॉन्फ़िगरेशन में Xata जोड़ें:

{
  "mcpServers": {
    "xata": {
      "serverUrl": "https://api.xata.tech/mcp"
    }
  }
}

Xata को केवल एक प्रोजेक्ट के लिए सक्षम करने हेतु, उस प्रोजेक्ट के रूट में इसके बजाय .agents/mcp_config.json का उपयोग करें।

agy शुरू करें और /mcp दर्ज करें। MCP Manager में, xata के लिए Authenticate का उपयोग करें और OAuth पूरा करने के लिए दिए गए निर्देशों का पालन करें।

OpenCode

अपनी OpenCode कॉन्फ़िगरेशन फ़ाइल में Xata server जोड़ें:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "xata": {
      "type": "remote",
      "url": "https://api.xata.tech/mcp"
    }
  }
}

फिर अपने टर्मिनल से प्रमाणित करें:

opencode mcp auth xata

Amp

अपने टर्मिनल से server जोड़ें:

amp mcp add xata https://api.xata.tech/mcp

फिर amp शुरू करें — ब्राउज़र में प्रमाणित करने का संकेत मिलना चाहिए। पुष्टि करने के लिए /mcp list tools चलाएँ कि server कनेक्ट है।

Windsurf

Windsurf में, Cascade पैनल खोलें और MCP (हथौड़ा) आइकन पर क्लिक करें, फिर raw कॉन्फ़िगरेशन फ़ाइल (~/.codeium/windsurf/mcp_config.json) खोलने के लिए Configure पर क्लिक करें।
Xata server एंट्री जोड़ें:

{
  "mcpServers": {
    "xata": {
      "serverUrl": "https://api.xata.tech/mcp"
    }
  }
}

फ़ाइल सेव करें और Cascade साइडबार में Refresh पर क्लिक करें। ब्राउज़र विंडो खुलने पर OAuth प्रक्रिया पूरी करें।

Zed

Settings → AI → MCP Servers खोलें और Add Server → Add Remote Server पर क्लिक करें, या अपनी settings फ़ाइल सीधे संपादित करें:

{
  "context_servers": {
    "xata": {
      "url": "https://api.xata.tech/mcp"
    }
  }
}

Zed, मानक MCP OAuth प्रक्रिया का उपयोग करके server से प्रमाणित करने के लिए कहेगा।

Cline

VS Code में Cline खोलें और MCP Servers आइकन पर क्लिक करें।
Remote Servers टैब में, नाम के रूप में xata, URL के रूप में https://api.xata.tech/mcp दर्ज करें और ट्रांसपोर्ट के रूप में Streamable HTTP चुनें। या कॉन्फ़िगरेशन JSON को सीधे संपादित करें:

{
  "mcpServers": {
    "xata": {
      "type": "streamableHttp",
      "url": "https://api.xata.tech/mcp"
    }
  }
}

[!NOTE]

ट्रांसपोर्ट का प्रकार streamableHttp (camelCase) होना चाहिए। इसे छोड़ने पर Cline पुराने SSE ट्रांसपोर्ट पर चला जाता है, जिसका Xata MCP server समर्थन नहीं करता।

अन्य MCP क्लाइंट

कोई भी MCP क्लाइंट कनेक्ट कर सकता है, बशर्ते वह इनका समर्थन करता हो:

Streamable HTTP पर रिमोट MCP servers (SSE नहीं)
डायनामिक क्लाइंट रजिस्ट्रेशन वाला OAuth, या API key प्रमाणीकरण के लिए कस्टम HTTP हेडर

रिमोट MCP servers को कॉन्फ़िगर करने का तरीका जानने के लिए अपने क्लाइंट के दस्तावेज़ देखें और URL के रूप में https://api.xata.tech/mcp का उपयोग करें।

कनेक्शन सत्यापित करें

कनेक्ट होने के बाद, अपने सहायक से पूछें:

ब्रांच की सूची पाने के लिए REST API ऑपरेशन खोजने हेतु Xata MCP server का उपयोग करें।

सहायक को {"query":"list branches"} के साथ search_operations कॉल करना चाहिए और listBranches ऑपरेशन लौटाना चाहिए, जिसे call_read_operation के ज़रिए चलाया जा सकता है। अगर ऐसा होता है, तो कनेक्शन काम कर रहा है।

उपलब्ध टूल

Xata MCP server ये टूल उपलब्ध कराता है:

टूल	विवरण
`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` और `confirm=true` दोनों ज़रूरी हैं।
`describe_schema`	किसी ब्रांच की टेबल और कॉलम की सूची बनाएँ।
`list_skills`	उपलब्ध Xata skills की सूची बनाएँ — कई चरणों वाले सामान्य कार्यों के लिए निर्देशित वर्कफ़्लो।
`get_skill`	किसी विशिष्ट skill के निर्देश पढ़ें।
`search_xata`	Xata दस्तावेज़ खोजें।
`query_docs_filesystem_xata`	पाथ के आधार पर Xata दस्तावेज़ पेज पढ़ें।

सुरक्षा

इंटरैक्टिव क्लाइंट के लिए OAuth को प्राथमिकता दें; टोकन की अवधि कम होती है और आप अपने क्लाइंट में server डिस्कनेक्ट करके उन्हें रद्द कर सकते हैं।
ऑटोमेशन के लिए एक अलग API key का उपयोग करें और उसे नियमित रूप से बदलें।
कुछ टूल आपके डेटा में बदलाव कर सकते हैं: call_write_operation और call_destructive_operation संसाधनों को बदल या मिटा सकते हैं (बाद वाले के लिए confirm=true ज़रूरी है), और run_sql को write=true और confirm=true दोनों के साथ कॉल करने पर डेटा में बदलाव हो सकता है। मंज़ूरी देने से पहले अपने सहायक द्वारा प्रस्तावित कार्रवाइयों की समीक्षा करें और लिखने या मिटाने की किसी भी कार्रवाई में इंसान को शामिल रखें।

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

प्रमाणीकरण बार-बार विफल हो रहा है या लूप में फँस रहा है। अपने क्लाइंट से Xata server हटाएँ, क्लाइंट रीस्टार्ट करें और नया OAuth प्रवाह शुरू करने के लिए server फिर से जोड़ें।

ब्राउज़र में प्रमाणीकरण के दौरान "Client not found" दिखता है। हो सकता है कि आपके MCP क्लाइंट में ऐसा सेव किया हुआ OAuth रजिस्ट्रेशन हो, जो अब Xata के प्रमाणीकरण server पर उपलब्ध नहीं है। क्लाइंट के आधार पर, MCP server को हटाकर फिर से जोड़ने पर भी यह रजिस्ट्रेशन बना रह सकता है। अपने क्लाइंट में Xata के लिए सेव किया हुआ OAuth रजिस्ट्रेशन हटाएँ, फिर नया रजिस्ट्रेशन करने के लिए Xata MCP server रीस्टार्ट करें और दोबारा प्रमाणित करें।

उदाहरण के लिए, VS Code में:

Command Palette (Cmd+Shift+P / Ctrl+Shift+P) खोलें।
Authentication: Remove Dynamic Authentication Providers चलाएँ।
Xata से जुड़े provider को चुनें और अन्य providers को जस का तस छोड़ें।
Xata MCP server रीस्टार्ट करें और फिर से प्रमाणीकरण पूरा करें।

Server कनेक्ट होता है, लेकिन कोई टूल नहीं दिखता। सुनिश्चित करें कि आपने प्रमाणीकरण पूरा कर लिया है — ज़्यादातर टूल दिखने से पहले एक मान्य सत्र ज़रूरी होता है। अपने क्लाइंट का प्रमाणीकरण प्रवाह फिर से चलाएँ, फिर उसकी टूल सूची रिफ़्रेश करें। पूरी सूची के लिए उपलब्ध टूल देखें।

आपका क्लाइंट बिल्कुल कनेक्ट नहीं हो पा रहा है। पुष्टि करें कि URL ठीक https://api.xata.tech/mcp है और आपका क्लाइंट Streamable HTTP का समर्थन करता है। केवल SSE का समर्थन करने वाले क्लाइंट समर्थित नहीं हैं।

आपके क्लाइंट में server दिखाई नहीं देता। क्लाइंट की MCP कॉन्फ़िगरेशन फ़ाइल का सिंटैक्स जाँचें — JSON का स्वरूप अलग-अलग क्लाइंट में अलग होता है (mcpServers बनाम servers बनाम context_servers, url बनाम serverUrl) — और क्लाइंट के लॉग भी जाँचें। कॉन्फ़िगरेशन में बदलाव के बाद ज़्यादातर क्लाइंट को पूरी तरह रीस्टार्ट करना पड़ता है।

यह दस्तावेज़ Mintlify, जो डेवलपर दस्तावेज़ों का एक प्लेटफ़ॉर्म है, पर बनाया और होस्ट किया गया है।