Keboola MCP Server

आधिकारिक

एक ही सहज प्लेटफॉर्म पर मजबूत डेटा वर्कफ़्लो, एकीकरण और एनालिटिक्स बनाएँ।

दस्तावेज़

Keboola MCP सर्वर

अपने AI एजेंटों, MCP क्लाइंट्स (Cursor, Claude, Windsurf, VS Code ...) और अन्य AI सहायकों को Keboola से कनेक्ट करें। डेटा, रूपांतरण, SQL क्वेरीज़ और जॉब ट्रिगर्स को उजागर करें—कोई ग्लू कोड आवश्यक नहीं। एजेंटों को सही डेटा तब और वहाँ पहुँचाएँ जब और जहाँ उन्हें इसकी आवश्यकता हो।

अवलोकन

Keboola MCP सर्वर आपके Keboola प्रोजेक्ट और आधुनिक AI उपकरणों के बीच एक ओपन-सोर्स सेतु है। यह Keboola सुविधाओं—जैसे स्टोरेज एक्सेस, SQL रूपांतरण, और जॉब ट्रिगर्स—को Claude, Cursor, CrewAI, LangChain, Amazon Q, और अधिक के लिए कॉल करने योग्य उपकरणों में बदल देता है।

त्वरित शुरुआत
स्थानीय सेटअप

सुविधाएँ

AI एजेंट और MCP सर्वर के साथ, आप यह कर सकते हैं:

स्टोरेज: तालिकाओं से सीधे क्वेरी करें और तालिका या बकेट विवरण प्रबंधित करें
घटक: एक्सट्रैक्टर्स, राइटर्स, डेटा ऐप्स, और रूपांतरण कॉन्फ़िगरेशन बनाएँ, सूचीबद्ध करें और निरीक्षण करें
SQL: प्राकृतिक भाषा के साथ SQL रूपांतरण बनाएँ
जॉब्स: घटक और रूपांतरण चलाएँ, और जॉब निष्पादन विवरण प्राप्त करें
फ़्लो: सशर्त फ़्लो और ऑर्केस्ट्रेटर फ़्लो का उपयोग करके वर्कफ़्लो पाइपलाइन बनाएँ और प्रबंधित करें।
डेटा ऐप्स: स्टोरेज डेटा पर आपकी क्वेरीज़ प्रदर्शित करने वाले Keboola Streamlit डेटा ऐप्स बनाएँ, तैनात करें और प्रबंधित करें।
मेटाडेटा: प्राकृतिक भाषा का उपयोग करके प्रोजेक्ट दस्तावेज़ीकरण और ऑब्जेक्ट मेटाडेटा खोजें, पढ़ें और अपडेट करें
डेव शाखाएँ: उत्पादन के बाहर विकास शाखाओं में सुरक्षित रूप से काम करें, जहाँ सभी संचालन चयनित शाखा तक सीमित होते हैं।

🚀 त्वरित शुरुआत: दूरस्थ MCP सर्वर (सबसे आसान तरीका)

Keboola MCP सर्वर का उपयोग करने का सबसे आसान तरीका हमारे दूरस्थ MCP सर्वर के माध्यम से है। यह होस्टेड समाधान स्थानीय सेटअप, कॉन्फ़िगरेशन, या इंस्टॉलेशन की आवश्यकता को समाप्त करता है।

दूरस्थ MCP सर्वर क्या है?

हमारा दूरस्थ सर्वर प्रत्येक मल्टी-टेनेंट Keboola स्टैक पर होस्ट किया जाता है और OAuth प्रमाणीकरण का समर्थन करता है। आप इसे किसी भी AI सहायक से कनेक्ट कर सकते हैं जो दूरस्थ स्ट्रीमेबल HTTP कनेक्शन और OAuth प्रमाणीकरण का समर्थन करता है।

कैसे कनेक्ट करें

अपना दूरस्थ सर्वर URL प्राप्त करें: अपनी Keboola प्रोजेक्ट सेटिंग्स → MCP Server टैब पर जाएँ
सर्वर URL कॉपी करें: यह https://mcp.<YOUR_REGION>.keboola.com/mcp जैसा दिखेगा
अपने AI सहायक को कॉन्फ़िगर करें: URL को अपने AI सहायक की MCP सेटिंग्स में पेस्ट करें
प्रमाणित करें: आपको अपने Keboola खाते से प्रमाणित करने और अपना प्रोजेक्ट चुनने के लिए कहा जाएगा

समर्थित क्लाइंट

Cursor: अपने प्रोजेक्ट की MCP सर्वर सेटिंग्स में "कर्सर में इंस्टॉल करें" बटन का उपयोग करें या इस बटन पर क्लिक करें
Claude Desktop: सेटिंग्स → इंटीग्रेशन के माध्यम से एकीकरण जोड़ें
Claude Code: claude mcp add --transport http keboola <URL> का उपयोग करके इंस्टॉल करें (विवरण के लिए नीचे देखें)
Windsurf: दूरस्थ सर्वर URL के साथ कॉन्फ़िगर करें
Make: दूरस्थ सर्वर URL के साथ कॉन्फ़िगर करें
अन्य MCP क्लाइंट: दूरस्थ सर्वर URL के साथ कॉन्फ़िगर करें

Claude Code सेटअप

Claude Code एक कमांड-लाइन इंटरफ़ेस उपकरण है जो आपको अपने टर्मिनल का उपयोग करके Claude के साथ बातचीत करने की अनुमति देता है। आप एक सरल कमांड का उपयोग करके Keboola MCP सर्वर एकीकरण स्थापित कर सकते हैं।

इंस्टॉलेशन:

अपने टर्मिनल में निम्नलिखित कमांड चलाएँ, <YOUR_REGION> को अपने Keboola क्षेत्र से बदलें:

claude mcp add --transport http keboola https://mcp.<YOUR_REGION>.keboola.com/mcp

क्षेत्र-विशिष्ट कमांड:

क्षेत्र	इंस्टॉलेशन कमांड
US Virginia AWS	`claude mcp add --transport http keboola https://mcp.keboola.com/mcp`
US Virginia GCP	`claude mcp add --transport http keboola https://mcp.us-east4.gcp.keboola.com/mcp`
EU Frankfurt AWS	`claude mcp add --transport http keboola https://mcp.eu-central-1.keboola.com/mcp`
EU Ireland Azure	`claude mcp add --transport http keboola https://mcp.north-europe.azure.keboola.com/mcp`
EU Frankfurt GCP	`claude mcp add --transport http keboola https://mcp.europe-west3.gcp.keboola.com/mcp`

उपयोग:

एक बार इंस्टॉल हो जाने पर, आप अपनी बातचीत में /mcp टाइप करके और उन Keboola उपकरणों का चयन करके Claude Code में Keboola MCP सर्वर का उपयोग कर सकते हैं जिनका आप उपयोग करना चाहते हैं।

प्रमाणीकरण:

जब आप पहली बार Claude Code में Keboola MCP सर्वर का उपयोग करते हैं, तो एक ब्राउज़र विंडो खुलेगी जो आपको यह करने के लिए कहेगी:

अपने Keboola खाते से लॉग इन करें
उस प्रोजेक्ट का चयन करें जिससे आप कनेक्ट करना चाहते हैं
कनेक्शन को अधिकृत करें

प्रमाणीकरण के बाद, आप सीधे Claude Code से Keboola उपकरणों का उपयोग शुरू कर सकते हैं।

विस्तृत सेटअप निर्देशों और क्षेत्र-विशिष्ट URL के लिए, हमारा दूरस्थ सर्वर सेटअप दस्तावेज़ीकरण देखें।

विकास शाखाओं का उपयोग करना

आप अपने उत्पादन डेटा को प्रभावित किए बिना Keboola विकास शाखाओं में सुरक्षित रूप से काम कर सकते हैं। दूरस्थ रूप से होस्ट किए गए MCP सर्वर KBC_BRANCH_ID पैरामीटर का सम्मान करते हैं और सभी संचालन को निर्दिष्ट शाखा तक सीमित कर देंगे। आप UI में विकास शाखा पर नेविगेट करते समय URL में विकास शाखा ID पा सकते हैं, उदाहरण के लिए: https://connection.us-east4.gcp.keboola.com/admin/projects/PROJECT_ID/branch/BRANCH_ID/dashboard। शाखा ID को प्रत्येक अनुरोध में हेडर X-Branch-Id: <branchId> का उपयोग करके शामिल किया जाना चाहिए, अन्यथा MCP सर्वर डिफ़ॉल्ट रूप से उत्पादन शाखा का उपयोग करता है। इसे AI क्लाइंट या सर्वर कनेक्शन को संभालने वाले वातावरण द्वारा प्रबंधित किया जाना चाहिए।

उपकरण प्राधिकरण और अभिगम नियंत्रण

HTTP-आधारित ट्रांसपोर्ट (स्ट्रीमेबल HTTP) का उपयोग करते समय, आप HTTP हेडर का उपयोग करके नियंत्रित कर सकते हैं कि क्लाइंट्स के लिए कौन से उपकरण उपलब्ध हैं। यह AI एजेंट क्षमताओं को प्रतिबंधित करने या अनुपालन नीतियों को लागू करने के लिए उपयोगी है।

प्राधिकरण हेडर

हेडर	विवरण	उदाहरण
`X-Allowed-Tools`	अनुमत उपकरणों की अल्पविराम-पृथक सूची	`get_configs,get_buckets,query_data`
`X-Disallowed-Tools`	बहिष्कृत करने के लिए उपकरणों की अल्पविराम-पृथक सूची	`create_config,run_job`
`X-Read-Only-Mode`	केवल पठनीय उपकरणों तक सीमित करें	`true`, `1`, या `yes`

फ़िल्टर व्यवहार

फ़िल्टर क्रम में लागू होते हैं: अनुमत → केवल-पठनीय प्रतिच्छेदन → अस्वीकृत बहिष्करण। खाली हेडर = कोई प्रतिबंध नहीं।

केवल-पठनीय उपकरण

केवल-पठनीय उपकरण वे हैं जो readOnlyHint=True के साथ एनोटेट किए गए हैं। ये उपकरण आपके Keboola प्रोजेक्ट में कोई बदलाव किए बिना केवल जानकारी प्राप्त करते हैं। केवल-पठनीय उपकरणों की वर्तमान सूची के लिए, TOOLS.md फ़ाइल देखें जो वास्तविक उपकरण सेट का एक ऑटो-जनरेटेड स्नैपशॉट है।

उदाहरण: केवल-पठनीय पहुँच

X-Read-Only-Mode: true

विस्तृत दस्तावेज़ीकरण के लिए, developers.keboola.com/integrate/mcp/#tool-authorization-and-access-control देखें।

स्थानीय MCP सर्वर सेटअप (कस्टम या डेव तरीका)

पूर्ण नियंत्रण और आसान विकास के लिए अपनी मशीन पर MCP सर्वर चलाएँ। इसे तब चुनें जब आप उपकरणों को अनुकूलित करना चाहते हैं, स्थानीय रूप से डीबग करना चाहते हैं, या तेज़ी से पुनरावृत्ति करना चाहते हैं। आप रेपो को क्लोन करेंगे, सर्वर ट्रांसपोर्ट के आधार पर पर्यावरण चर या हेडर के माध्यम से Keboola क्रेडेंशियल सेट करेंगे, निर्भरताएँ स्थापित करेंगे, और सर्वर शुरू करेंगे। यह दृष्टिकोण अधिकतम लचीलापन (कस्टम उपकरण, स्थानीय लॉगिंग, ऑफ़लाइन पुनरावृत्ति) प्रदान करता है लेकिन इसके लिए मैन्युअल सेटअप की आवश्यकता होती है और आप अपडेट और सीक्रेट्स स्वयं प्रबंधित करते हैं।

सर्वर कई ट्रांसपोर्ट विकल्पों का समर्थन करता है, जिन्हें सर्वर शुरू करते समय --transport <transport> तर्क प्रदान करके चुना जा सकता है:

stdio - डिफ़ॉल्ट जब --transport निर्दिष्ट नहीं है। मानक इनपुट/आउटपुट, आमतौर पर एकल क्लाइंट के साथ स्थानीय परिनियोजन के लिए उपयोग किया जाता है।
streamable-http - सर्वर को HTTP पर द्विदिश स्ट्रीमिंग चैनल के साथ दूरस्थ रूप से चलाता है, जिससे क्लाइंट और सर्वर लगातार संदेशों का आदान-प्रदान कर सकते हैं। /mcp के माध्यम से कनेक्ट करें (जैसे, http://localhost:8000/mcp)।
http-compat - streamable-http के लिए एक उपनाम, पिछड़े संगतता के लिए रखा गया है।

क्लाइंट-सर्वर संचार के लिए, आपके Keboola क्षेत्र में आपके प्रोजेक्ट के साथ काम करने को सक्षम करने के लिए Keboola क्रेडेंशियल प्रदान किए जाने चाहिए। निम्नलिखित आवश्यक हैं: KBC_STORAGE_TOKEN, KBC_STORAGE_API_URL, KBC_WORKSPACE_SCHEMA और वैकल्पिक रूप से KBC_BRANCH_ID। आप इन्हें दो तरीकों से प्रदान कर सकते हैं:

व्यक्तिगत उपयोग के लिए (मुख्य रूप से stdio ट्रांसपोर्ट के साथ): सर्वर शुरू करने से पहले पर्यावरण चर सेट करें। सभी अनुरोध इन पूर्वनिर्धारित क्रेडेंशियल्स का पुन: उपयोग करेंगे।
बहु-उपयोगकर्ता उपयोग के लिए: अनुरोध हेडर में चर शामिल करें ताकि प्रत्येक अनुरोध इसके साथ प्रदान किए गए क्रेडेंशियल्स का उपयोग करे।

KBC_STORAGE_TOKEN

यह Keboola के लिए आपका प्रमाणीकरण टोकन है:

स्टोरेज API टोकन बनाने और प्रबंधित करने के निर्देशों के लिए, आधिकारिक Keboola दस्तावेज़ीकरण देखें।

नोट: यदि आप चाहते हैं कि MCP सर्वर की सीमित पहुँच हो, तो कस्टम स्टोरेज टोकन का उपयोग करें, यदि आप चाहते हैं कि MCP आपके प्रोजेक्ट में सब कुछ एक्सेस करे, तो मास्टर टोकन का उपयोग करें।

KBC_WORKSPACE_SCHEMA

यह Keboola में आपके कार्यक्षेत्र की पहचान करता है और SQL क्वेरीज़ के लिए उपयोग किया जाता है। हालाँकि, यह केवल तभी आवश्यक है जब आप मास्टर टोकन के बजाय कस्टम स्टोरेज टोकन का उपयोग कर रहे हों:

यदि मास्टर टोकन का उपयोग कर रहे हैं: कार्यक्षेत्र पर्दे के पीछे स्वचालित रूप से बनाया जाता है
यदि कस्टम स्टोरेज टोकन का उपयोग कर रहे हैं: अपना KBC_WORKSPACE_SCHEMA प्राप्त करने के लिए इस Keboola गाइड का पालन करें

नोट: मैन्युअल रूप से कार्यक्षेत्र बनाते समय, सभी प्रोजेक्ट डेटा तक केवल-पठनीय पहुँच प्रदान करें विकल्प की जाँच करें

नोट: KBC_WORKSPACE_SCHEMA को BigQuery कार्यक्षेत्रों में डेटासेट नाम कहा जाता है, आप बस कनेक्ट पर क्लिक करें और डेटासेट नाम कॉपी करें

KBC_STORAGE_API_URL (Keboola क्षेत्र)

आपका Keboola क्षेत्र API URL आपके परिनियोजन क्षेत्र पर निर्भर करता है। आप अपने Keboola प्रोजेक्ट में लॉग इन होने पर अपने ब्राउज़र में URL देखकर अपना क्षेत्र निर्धारित कर सकते हैं:

क्षेत्र	API URL
AWS उत्तरी अमेरिका	`https://connection.keboola.com`
AWS यूरोप	`https://connection.eu-central-1.keboola.com`
Google Cloud EU	`https://connection.europe-west3.gcp.keboola.com`
Google Cloud US	`https://connection.us-east4.gcp.keboola.com`
Azure EU	`https://connection.north-europe.azure.keboola.com`

KBC_BRANCH_ID (वैकल्पिक)

किसी विशिष्ट Keboola विकास शाखा पर काम करने के लिए, KBC_BRANCH_ID पैरामीटर का उपयोग करके शाखा ID सेट करें। MCP सर्वर अपनी कार्यक्षमता को निर्दिष्ट शाखा तक सीमित करता है, यह सुनिश्चित करता है कि सभी परिवर्तन पृथक रहें और उत्पादन शाखा को प्रभावित न करें।

यदि प्रदान नहीं किया गया है, तो सर्वर डिफ़ॉल्ट रूप से उत्पादन शाखा का उपयोग करता है।
विकास कार्य के लिए, KBC_BRANCH_ID को अपनी शाखा की संख्यात्मक ID पर सेट करें (जैसे, 123456)। आप UI में विकास शाखा पर नेविगेट करते समय URL में विकास शाखा ID पा सकते हैं, उदाहरण के लिए: https://connection.us-east4.gcp.keboola.com/admin/projects/PROJECT_ID/branch/BRANCH_ID/dashboard।
दूरस्थ ट्रांसपोर्ट पर, आप HTTP हेडर X-Branch-Id: <branchId> या KBC_BRANCH_ID: <branchId> के साथ प्रति-अनुरोध ओवरराइड कर सकते हैं।

इंस्टॉलेशन

सुनिश्चित करें कि आपके पास है:

Python 3.10+ स्थापित
व्यवस्थापक अधिकारों के साथ Keboola प्रोजेक्ट तक पहुँच
आपका पसंदीदा MCP क्लाइंट (Claude, Cursor, आदि)

नोट: सुनिश्चित करें कि आपके पास uv स्थापित है। MCP क्लाइंट इसका उपयोग Keboola MCP सर्वर को स्वचालित रूप से डाउनलोड और चलाने के लिए करेगा। uv स्थापित करना:

macOS/Linux:

#if homebrew is not installed on your machine use:
# /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Install using Homebrew
brew install uv

Windows:

# Using the installer script
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

# Or using pip
pip install uv

# Or using winget
winget install --id=astral-sh.uv -e

अधिक इंस्टॉलेशन विकल्पों के लिए, आधिकारिक uv दस्तावेज़ीकरण देखें।

Keboola MCP सर्वर चलाना

आपकी आवश्यकताओं के आधार पर, Keboola MCP सर्वर का उपयोग करने के चार तरीके हैं:

विकल्प A: एकीकृत मोड (अनुशंसित)

इस मोड में, Claude या Cursor आपके लिए MCP सर्वर स्वचालित रूप से प्रारंभ करता है। आपको अपने टर्मिनल में कोई कमांड चलाने की आवश्यकता नहीं है।

अपने MCP क्लाइंट (Claude/Cursor) को उपयुक्त सेटिंग्स के साथ कॉन्फ़िगर करें
क्लाइंट आवश्यकता पड़ने पर स्वचालित रूप से MCP सर्वर लॉन्च करेगा

Claude Desktop कॉन्फ़िगरेशन

Claude पर जाएँ (आपकी स्क्रीन के ऊपरी बाएँ कोने में) -> सेटिंग्स → डेवलपर → कॉन्फ़िग संपादित करें (यदि आपको claude_desktop_config.json दिखाई नहीं देता है, तो इसे बनाएँ)
निम्नलिखित कॉन्फ़िगरेशन जोड़ें:
परिवर्तनों को प्रभावी होने के लिए Claude डेस्कटॉप को पुनरारंभ करें

{
  "mcpServers": {
    "keboola": {
      "command": "uvx",
      "args": ["keboola_mcp_server --transport <transport>"],
      "env": {
        "KBC_STORAGE_API_URL": "https://connection.YOUR_REGION.keboola.com",
        "KBC_STORAGE_TOKEN": "your_keboola_storage_token",
        "KBC_WORKSPACE_SCHEMA": "your_workspace_schema",
        "KBC_BRANCH_ID": "your_branch_id_optional"
      }
    }
  }
}

कॉन्फ़िग फ़ाइल स्थान:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Cursor कॉन्फ़िगरेशन

सेटिंग्स → MCP पर जाएँ
"+ नया वैश्विक MCP सर्वर जोड़ें" पर क्लिक करें
इन सेटिंग्स के साथ कॉन्फ़िगर करें:

{
  "mcpServers": {
    "keboola": {
      "command": "uvx",
      "args": ["keboola_mcp_server --transport <transport>"],
      "env": {
        "KBC_STORAGE_API_URL": "https://connection.YOUR_REGION.keboola.com",
        "KBC_STORAGE_TOKEN": "your_keboola_storage_token",
        "KBC_WORKSPACE_SCHEMA": "your_workspace_schema",
        "KBC_BRANCH_ID": "your_branch_id_optional"
      }
    }
  }
}

नोट: MCP सर्वर के लिए छोटे, वर्णनात्मक नामों का उपयोग करें। चूँकि पूर्ण उपकरण नाम में सर्वर का नाम शामिल होता है और इसे ~60 वर्णों से कम रहना चाहिए, लंबे नाम Cursor में फ़िल्टर किए जा सकते हैं और एजेंट को प्रदर्शित नहीं किए जाएंगे।

Windows WSL के लिए Cursor कॉन्फ़िगरेशन

Cursor AI के साथ Windows Subsystem for Linux से MCP सर्वर चलाते समय, इस कॉन्फ़िगरेशन का उपयोग करें:

{
  "mcpServers": {
    "keboola":{
      "command": "wsl.exe",
      "args": [
          "bash",
          "-c '",
          "export KBC_STORAGE_API_URL=https://connection.YOUR_REGION.keboola.com &&",
          "export KBC_STORAGE_TOKEN=your_keboola_storage_token &&",
          "export KBC_WORKSPACE_SCHEMA=your_workspace_schema &&",
          "export KBC_BRANCH_ID=your_branch_id_optional &&",
          "/snap/bin/uvx keboola_mcp_server --transport <transport>",
          "'"
      ]
    }
  }
}

विकल्प B: स्थानीय विकास मोड

MCP सर्वर कोड पर स्वयं काम करने वाले डेवलपर्स के लिए:

रिपॉजिटरी को क्लोन करें और एक स्थानीय वातावरण सेट अप करें
Claude/Cursor को अपने स्थानीय Python पथ का उपयोग करने के लिए कॉन्फ़िगर करें:

{
  "mcpServers": {
    "keboola": {
      "command": "/absolute/path/to/.venv/bin/python",
      "args": [
        "-m",
        "keboola_mcp_server --transport <transport>"
      ],
      "env": {
        "KBC_STORAGE_API_URL": "https://connection.YOUR_REGION.keboola.com",
        "KBC_STORAGE_TOKEN": "your_keboola_storage_token",
        "KBC_WORKSPACE_SCHEMA": "your_workspace_schema",
        "KBC_BRANCH_ID": "your_branch_id_optional"
      }
    }
  }
}

विकल्प C: मैन्युअल CLI मोड (केवल परीक्षण के लिए)

आप परीक्षण या डिबगिंग के लिए टर्मिनल में सर्वर को मैन्युअल रूप से चला सकते हैं:

# Set environment variables
export KBC_STORAGE_API_URL=https://connection.YOUR_REGION.keboola.com
export KBC_STORAGE_TOKEN=your_keboola_storage_token
export KBC_WORKSPACE_SCHEMA=your_workspace_schema
export KBC_BRANCH_ID=your_branch_id_optional

uvx keboola_mcp_server --transport streamable-http

नोट: यह मोड मुख्य रूप से डिबगिंग या परीक्षण के लिए है। Claude या Cursor के साथ सामान्य उपयोग के लिए, आपको सर्वर को मैन्युअल रूप से चलाने की आवश्यकता नहीं है।

नोट: सर्वर स्ट्रीमेबल HTTP ट्रांसपोर्ट का उपयोग करेगा और आने वाले कनेक्शनों के लिए /mcp पर localhost:8000 पर सुनेगा। आप इसे कहीं और सुनने के लिए --port और --host पैरामीटर का उपयोग कर सकते हैं।

विकल्प D: Docker का उपयोग करना

docker pull keboola/mcp-server:latest

docker run \
  --name keboola_mcp_server \
  --rm \
  -it \
  -p 127.0.0.1:8000:8000 \
  -e KBC_STORAGE_API_URL="https://connection.YOUR_REGION.keboola.com" \
  -e KBC_STORAGE_TOKEN="YOUR_KEBOOLA_STORAGE_TOKEN" \
  -e KBC_WORKSPACE_SCHEMA="YOUR_WORKSPACE_SCHEMA" \
  -e KBC_BRANCH_ID="YOUR_BRANCH_ID_OPTIONAL" \
  keboola/mcp-server:latest \
  --transport streamable-http \
  --host 0.0.0.0

नोट: सर्वर स्ट्रीमेबल HTTP ट्रांसपोर्ट का उपयोग करेगा और आने वाले कनेक्शनों के लिए /mcp पर localhost:8000 पर सुनेगा। आप कंटेनर के पोर्ट को कहीं और मैप करने के लिए -p बदल सकते हैं।

क्या मुझे स्वयं सर्वर शुरू करने की आवश्यकता है?

परिदृश्य	मैन्युअल रूप से चलाने की आवश्यकता है?	इस सेटअप का उपयोग करें
Claude/Cursor का उपयोग करना	नहीं	ऐप सेटिंग में MCP कॉन्फ़िगर करें
MCP को स्थानीय रूप से विकसित करना	नहीं (Claude इसे शुरू करता है)	कॉन्फ़िग को python पथ पर इंगित करें
CLI का मैन्युअल परीक्षण	हाँ	चलाने के लिए टर्मिनल का उपयोग करें
Docker का उपयोग करना	हाँ	डॉकर कंटेनर चलाएँ

MCP सर्वर का उपयोग करना

एक बार जब आपका MCP क्लाइंट (Claude/Cursor) कॉन्फ़िगर और चल रहा हो, तो आप अपने Keboola डेटा से क्वेरी करना शुरू कर सकते हैं:

अपने सेटअप की पुष्टि करें

आप यह पुष्टि करने के लिए एक सरल क्वेरी से शुरू कर सकते हैं कि सब कुछ काम कर रहा है:

What buckets and tables are in my Keboola project?

आप क्या कर सकते हैं इसके उदाहरण

डेटा अन्वेषण:

"किन तालिकाओं में ग्राहक जानकारी है?"
"राजस्व के हिसाब से शीर्ष 10 ग्राहकों को खोजने के लिए एक क्वेरी चलाएँ"

डेटा विश्लेषण:

"पिछली तिमाही के लिए क्षेत्र के अनुसार मेरे बिक्री डेटा का विश्लेषण करें"
"ग्राहक की आयु और खरीद आवृत्ति के बीच संबंध खोजें"

डेटा पाइपलाइन:

"एक SQL रूपांतरण बनाएँ जो ग्राहक और ऑर्डर तालिकाओं को जोड़ता है"
"मेरे Salesforce घटक के लिए डेटा निष्कर्षण कार्य प्रारंभ करें"

संगतता

MCP क्लाइंट समर्थन

MCP क्लाइंट	समर्थन स्थिति	कनेक्शन विधि
Claude (डेस्कटॉप और वेब)	✅ समर्थित	stdio
Cursor	✅ समर्थित	stdio
Windsurf, Zed, Replit	✅ समर्थित	stdio
Codeium, Sourcegraph	✅ समर्थित	स्ट्रीमेबल HTTP
कस्टम MCP क्लाइंट	✅ समर्थित	स्ट्रीमेबल HTTP या stdio

समर्थित उपकरण

नोट: आपके AI एजेंट स्वचालित रूप से नए उपकरणों के लिए समायोजित हो जाएंगे।

विस्तृत विवरण, पैरामीटर और उपयोग के उदाहरणों के साथ उपलब्ध उपकरणों की पूरी सूची के लिए, TOOLS.md देखें।

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

सामान्य समस्याएँ

समस्या	समाधान
प्रमाणीकरण त्रुटियाँ	सत्यापित करें कि `KBC_STORAGE_TOKEN` मान्य है
कार्यक्षेत्र समस्याएँ	पुष्टि करें कि `KBC_WORKSPACE_SCHEMA` सही है
कनेक्शन टाइमआउट	नेटवर्क कनेक्टिविटी की जाँच करें

विकास

स्थापना

मूल सेटअप:

uv sync --extra dev

मूल सेटअप के साथ, आप परीक्षण चलाने और कोड शैली की जाँच करने के लिए uv run tox का उपयोग कर सकते हैं।

अनुशंसित सेटअप:

uv sync --extra dev --extra tests --extra integtests --extra codestyle

अनुशंसित सेटअप के साथ, परीक्षण और कोड शैली जाँच के लिए पैकेज स्थापित किए जाएंगे जो VsCode या Cursor जैसे IDE को विकास के दौरान कोड की जाँच करने या परीक्षण चलाने की अनुमति देते हैं।

एकीकरण परीक्षण

स्थानीय रूप से एकीकरण परीक्षण चलाने के लिए, uv run tox -e integtests का उपयोग करें। नोट: आपको निम्नलिखित पर्यावरण चर सेट करने होंगे:

INTEGTEST_POOL_STORAGE_API_URL
INTEGTEST_STORAGE_TOKENS
INTEGTEST_STORAGE_TOKEN_STORAGE_BRANCHES

इन मानों को प्राप्त करने के लिए, आपको एकीकरण परीक्षणों के लिए समर्पित Keboola परियोजनाओं की आवश्यकता है। प्रत्येक परीक्षण सत्र अपना स्वयं का केवल-पढ़ने योग्य कार्यक्षेत्र बनाता है, इसलिए किसी कार्यक्षेत्र स्कीमा को कॉन्फ़िगर करने की आवश्यकता नहीं है। विस्तृत सेटअप निर्देशों और डिज़ाइन दस्तावेज़ीकरण के लिए integtests/README.md देखें।

`uv.lock` अपडेट करना

यदि आपने निर्भरताएँ जोड़ी या हटाई हैं तो uv.lock फ़ाइल अपडेट करें। रिलीज़ बनाते समय नए निर्भरता संस्करणों के साथ लॉक को अपडेट करने पर भी विचार करें (uv lock --upgrade)।

उपकरण दस्तावेज़ीकरण अपडेट करना

जब आप किसी भी उपकरण विवरण (उपकरण कार्यों में docstrings) में परिवर्तन करते हैं, तो आपको इन परिवर्तनों को दर्शाने के लिए TOOLS.md दस्तावेज़ीकरण फ़ाइल को पुन: उत्पन्न करना होगा:

uv run python -m src.keboola_mcp_server.generate_tool_docs

रिलीज़ करना

हम प्रत्येक मर्ज किए गए PR के लिए रिलीज़ नहीं काटते हैं। काम लगातार ट्रंक (main) पर आता है, और हम समय-समय पर रिलीज़ करते हैं एक बार परिवर्तनों का एक साथ पुन: परीक्षण किया जा चुका हो — यह उपयोगकर्ताओं के लिए काम कर रहे सेटअप को तोड़ने से बचाता है।

एक रिलीज़ एक या दो git टैग पुश करके बनाई जाती है:

vX.Y.Z — MCP सर्वर रिलीज़ (हमेशा)
agent-vX.Y.Z — इन प्लेटफ़ॉर्म एजेंट रिलीज़ (केवल तब जब एजेंट भी रिलीज़ किया जा रहा हो)

कोई भी टैग release.yml CI को ट्रिगर करता है, जो डॉकर इमेज बनाता और प्रकाशित करता है। KaiBench केवल उत्पादन vX.Y.Z टैग पर चलता है (agent-vX.Y.Z नहीं, और -dev. प्री-रिलीज़ नहीं)। release-notes कौशल का उपयोग करें — यह रिलीज़ नोट्स और ड्राफ्ट PR तैयार करता है और vX.Y.Z और agent-vX.Y.Z दोनों को टैग करने के माध्यम से चलता है।

समर्थन और प्रतिक्रिया

⭐ सहायता प्राप्त करने, बग रिपोर्ट करने या सुविधाओं का अनुरोध करने का प्राथमिक तरीका GitHub पर एक मुद्दा खोलना है। ⭐

विकास टीम सक्रिय रूप से मुद्दों की निगरानी करती है और यथाशीघ्र प्रतिक्रिया देगी। Keboola के बारे में सामान्य जानकारी के लिए, कृपया नीचे दिए गए संसाधनों का उपयोग करें।

संसाधन

उपयोगकर्ता दस्तावेज़ीकरण
डेवलपर दस्तावेज़ीकरण
Keboola प्लेटफ़ॉर्म
मुद्दा ट्रैकर ← MCP सर्वर के लिए प्राथमिक संपर्क विधि