DataFast MCP

MCP से शुरुआत करें

अपने AI सहायक को DataFast से कनेक्ट करें ताकि आप ट्रैफ़िक, राजस्व और कस्टम लक्ष्यों के बारे में पूछ सकें, या उन वेबसाइट संचालनों को प्रबंधित कर सकें जिन्हें आप अधिकृत करते हैं। आपको API एक्सेस के साथ DataFast खाते की आवश्यकता है।

कनेक्ट करने का तरीका चुनें

एक तरीका चुनें। दोनों DataFast के साथ संवाद करने के लिए Streamable HTTP का उपयोग करते हैं।

• OAuth से साइन इन करें — उन क्लाइंट्स के लिए अनुशंसित जो OAuth साइन-इन प्रदान करते हैं, जिसमें Codex और Claude Code शामिल हैं। DataFast पर वेबसाइट और अनुमतियाँ चुनें; क्लाइंट अपना कनेक्शन टोकन स्वचालित रूप से संभालता है। आप API कुंजी नहीं बनाते या कॉपी नहीं करते।
• API टोकन का उपयोग करें — उन क्लाइंट्स के लिए जो Bearer टोकन मांगते हैं। DataFast में एक स्कोप्ड खाता टोकन बनाएं और इसे अपने क्लाइंट के कॉन्फ़िगरेशन में जोड़ें।

दोनों तरीके समान DataFast टूल प्रदान करते हैं। OAuth अनुमतियाँ आपको एनालिटिक्स, वेबसाइट प्रशासन, खाता क्रियाएँ और क्रेडेंशियल प्रबंधन को अलग-अलग अनुमोदित करने देती हैं। प्रत्येक तरीका क्या समर्थन करता है, इसके लिए टूल संदर्भ देखें।

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

1. DataFast को अपने क्लाइंट में जोड़ें

नीचे दिए गए URL के साथ एक रिमोट MCP सर्वर जोड़ें और OAuth या साइन इन चुनें।

https://datafa.st/api/mcp

Codex के लिए, सर्वर जोड़ें और ब्राउज़र साइन-इन पूरा करें:

codex mcp add datafast --url https://datafa.st/api/mcp

बाद में फिर से साइन इन करने के लिए, codex mcp login datafast चलाएँ। क्लाइंट मेटाडेटा दस्तावेज़ और डायनामिक रजिस्ट्रेशन दोनों समर्थित हैं, जिसमें नेटिव लूपबैक कॉलबैक शामिल हैं। यदि DataFast पहले से Bearer टोकन के साथ कॉन्फ़िगर किया गया है, तो OAuth पर स्विच करने से पहले क्लाइंट के DataFast कॉन्फ़िगरेशन से उस क्रेडेंशियल को हटा दें।

Claude Code के लिए, सर्वर जोड़ें, फिर Claude Code के अंदर /mcp खोलें और DataFast को प्रमाणित करें:

claude mcp add --transport http datafast https://datafa.st/api/mcp

2. साइन इन करें और एक्सेस अनुमोदित करें

1. अपने मौजूदा DataFast खाते से datafa.st पर साइन इन करें।
2. उन वेबसाइटों का चयन करें जिन तक यह क्लाइंट पहुँच सकता है।
3. अनुरोधित अनुमतियों की समीक्षा करें। पढ़ने की अनुमतियाँ डिफ़ॉल्ट रूप से चयनित हैं; केवल तभी लिखने को सक्षम करें जब आप चाहते हैं कि क्लाइंट वे परिवर्तन करे।
4. अपने क्लाइंट पर लौटने के लिए Allow access चुनें।

DataFast उस कनेक्शन के लिए क्लाइंट को एक एक्सेस टोकन जारी करता है। क्लाइंट इसे संग्रहीत करता है और कनेक्शन वैध रहने तक इसे स्वचालित रूप से रीफ़्रेश करता है। आपका DataFast पासवर्ड, डैशबोर्ड सत्र और मौजूदा API कुंजियाँ क्लाइंट के साथ साझा नहीं की जाती हैं।

3. इसे आज़माएँ

DataFast सक्षम के साथ एक बातचीत शुरू करें और पूछें:

मेरी उपलब्ध वेबसाइटों की सूची बनाएं, फिर पिछले सात दिनों में मेरी वेबसाइट के लिए विज़िटर और राजस्व दिखाएं।

जारी रखने से पहले वेबसाइट और दिनांक सीमा की पुष्टि करें। आपकी योजना और अनुमतियाँ अभी भी लागू हैं।

Settings → API / MCP → Connected apps के अंतर्गत कनेक्शन प्रबंधित या रद्द करें। जब DataFast आपसे फिर से एक्सेस अनुमोदित करने के लिए कहे, या जब आप अलग वेबसाइट या अनुमतियाँ साझा करना चाहें, तो पुनः कनेक्ट करें।

API टोकन से कनेक्ट करें

इस विधि का उपयोग करें जब आपका क्लाइंट API कुंजी या Bearer टोकन मांगता है। MCP के लिए, खाता एक्सेस टोकन से शुरू करें, जो dft_ से शुरू होता है।

1. खाता टोकन बनाएं

1. Account settings → API / MCP खोलें।
2. New access token के अंतर्गत, एक्सेस प्रतिबंधित करने के लिए Specific websites चुनें, या All websites चुनें यदि आपके वर्कफ़्लो को यही चाहिए।
3. केवल उन्हीं अनुमतियों का चयन करें जिनकी आपको आवश्यकता है। एनालिटिक्स कनेक्शन के लिए, Websites → Read और Analytics → Read से शुरू करें, बाकी सभी अनुमतियाँ अक्षम रखें।
4. टोकन को एक पहचानने योग्य नाम दें, Create token चुनें, और dft_ मान कॉपी करें। यह केवल एक बार दिखाया जाता है।

2. टोकन को अपने क्लाइंट में जोड़ें

https://datafa.st/api/mcp का उपयोग करें और टोकन को Authorization: Bearer … हेडर के रूप में भेजें। इसे क्लाइंट की क्रेडेंशियल सेटिंग्स या एक पर्यावरण चर में रखें, स्रोत नियंत्रण और चैट संदेशों से बाहर।

Codex: अपने टोकन को DATAFAST_TOKEN पर्यावरण चर के रूप में उपलब्ध कराएं, फिर चलाएँ:

codex mcp add datafast \
  --url https://datafa.st/api/mcp \
  --bearer-token-env-var DATAFAST_TOKEN

Claude Code: dft_xxx को अपने टोकन से बदलें:

claude mcp add --transport http datafast https://datafa.st/api/mcp \
  --header "Authorization: Bearer dft_xxx"

Cursor: अपने mcp.json में यह प्रविष्टि जोड़ें। DATAFAST_TOKEN को Cursor के पर्यावरण में उपलब्ध कराएं; Cursor कनेक्ट होने पर पर्यावरण चर का विस्तार करता है।

{
  "mcpServers": {
    "datafast": {
      "url": "https://datafa.st/api/mcp",
      "headers": {
        "Authorization": "Bearer ${env:DATAFAST_TOKEN}"
      }
    }
  }
}

अन्य क्लाइंट: उनकी रिमोट MCP सेटिंग्स में सर्वर URL और Bearer टोकन दर्ज करें। जो क्लाइंट केवल स्थानीय stdio सर्वर का समर्थन करते हैं, उन्हें mcp-remote जैसे ब्रिज की आवश्यकता होती है।

3. इसे आज़माएँ और एक्सेस प्रबंधित करें

अपने क्लाइंट से अपनी उपलब्ध वेबसाइटों की सूची बनाने के लिए कहें, फिर पिछले सात दिनों में एक वेबसाइट के लिए विज़िटर और राजस्व का अनुरोध करें।

Account settings → API / MCP में Your access tokens के अंतर्गत टोकन प्रबंधित करें। यह क्या कर सकता है, इसे बदलने के लिए Edit permissions का उपयोग करें, इसके रहस्य को बदलने के लिए Roll का उपयोग करें, या इसे रद्द करने के लिए Delete का उपयोग करें। टोकन रोल करने के बाद, अपने क्लाइंट में मान अपडेट करें।

पहले से df_ वेबसाइट API कुंजी है? सामान्य MCP एंडपॉइंट उन्हें भी स्वीकार करता है, जिसमें एक्सेस उस वेबसाइट से जुड़ी होती है। यह जो संचालन समर्थन करता है, उसके लिए API प्रमाणीकरण देखें। आप ऊपर Specific websites का उपयोग करके खाता टोकन को एक वेबसाइट तक भी सीमित कर सकते हैं।

एक्सेस कैसे सीमित है

दोनों विधियाँ क्लाइंट को एक गुप्त क्रेडेंशियल देती हैं। OAuth आपकी सहमति के बाद उस क्रेडेंशियल को जारी करने और नवीनीकृत करने को स्वचालित करता है; API टोकन एक क्रेडेंशियल है जिसे आप स्वयं बनाते और कॉन्फ़िगर करते हैं।

DataFast सर्वर पर क्रेडेंशियल, अनुमत क्रिया, वेबसाइट एक्सेस, वर्तमान सदस्यता और लागू खाता या योजना प्रतिबंधों की जाँच करता है। टूल अनुरोध में वेबसाइट ID एक लक्ष्य है जिसे जाँचा जाना है, एक्सेस का प्रमाण नहीं। उदाहरण के लिए, वेबसाइट A को पढ़ने के लिए अनुमोदित OAuth कनेक्शन वेबसाइट B को नहीं पढ़ सकता या वेबसाइट A को संपादित नहीं कर सकता।

OAuth कनेक्शन केवल अनुमोदित वेबसाइटों तक पहुँचते हैं। अनुमोदित OAuth टूल के माध्यम से बनाई गई वेबसाइट उस कनेक्शन में जोड़ी जाती है; अन्यत्र जोड़ी गई वेबसाइटें स्वचालित रूप से साझा नहीं की जाती हैं। OAuth टोकन एक घंटे के बाद समाप्त हो जाते हैं, जारी होने से 30 दिनों तक स्वचालित रूप से रीफ़्रेश होते हैं, और अधिकतम 90 दिनों के बाद नई सहमति की आवश्यकता होती है। डैशबोर्ड में बनाए गए खाता टोकन तब तक वैध रहते हैं जब तक आप उन्हें रोल या हटाते नहीं हैं, आपके खाता एक्सेस और अनुमतियों के अधीन। OAuth के माध्यम से जारी API कुंजियाँ और खाता टोकन भी मूल कनेक्शन के वैध रहने पर निर्भर करते हैं।

OAuth टोकन केवल उसी MCP एंडपॉइंट पर काम करते हैं जिसके लिए वे जारी किए गए थे। उन्हें सार्वजनिक REST API में पेस्ट नहीं किया जा सकता या DataFast डैशबोर्ड में साइन इन करने के लिए उपयोग नहीं किया जा सकता। खाता टोकन समर्थित REST API एंडपॉइंट्स के साथ भी काम करते हैं।

सुरक्षा

• सीमित एक्सेस से शुरू करें। क्लाइंट को केवल वही वेबसाइट और अनुमतियाँ दें जिनकी उसे आवश्यकता है। खाता क्रियाएँ, क्रेडेंशियल प्रबंधन और पूर्ण विज़िटर विवरण के लिए अलग OAuth अनुमतियाँ आवश्यक हैं जो डिफ़ॉल्ट रूप से बंद हैं।
• परिवर्तनों की समीक्षा करें। OAuth लेखन टूल को पुष्टि और पुनः प्रयास कुंजी की आवश्यकता होती है। API-टोकन टूल को डेटा हटाने या क्रेडेंशियल जारी करने जैसे संवेदनशील संचालन के लिए पुष्टि की आवश्यकता होती है। ये जाँचें क्लाइंट के पुष्टिकरण UI की पूरक हैं; वे एक भरोसेमंद क्लाइंट चुनने का विकल्प नहीं बदलतीं।
• क्रेडेंशियल निजी रखें। दोनों विधियाँ Bearer टोकन का उपयोग करती हैं: जो कोई भी वैध टोकन प्राप्त करता है वह उसकी अनुमत एक्सेस का उपयोग तब तक कर सकता है जब तक वह समाप्त या रद्द नहीं हो जाता। क्रेडेंशियल को URL, स्रोत नियंत्रण या चैट संदेशों में कभी न रखें।
• आवश्यकता पड़ने पर डिस्कनेक्ट करें। OAuth कनेक्शन रद्द करने से बाद के अनुरोध और रीफ़्रेश अवरुद्ध हो जाते हैं। पहले से चल रहा अनुरोध पूरा हो सकता है, और दूसरे ऐप के साथ पहले से साझा किया गया डेटा रद्द करने से हटाया नहीं जाता।
• डैशबोर्ड-केवल संचालन डैशबोर्ड में रहते हैं। MCP वेबसाइट हटा नहीं सकता या भुगतान प्रदाताओं को कनेक्ट/डिस्कनेक्ट नहीं कर सकता।