MCP/API

MCP/API Qubix का एकमात्र प्रोग्रामिंग इंटरफ़ेस है। बाहरी क्लाइंट — एक AI असिस्टेंट, एक BI स्क्रिप्ट, एक ऑटोमेशन टूल — MCP (Model Context Protocol) के माध्यम से एक ही endpoint से कनेक्ट होते हैं और इस पृष्ठ पर सूचीबद्ध मेथड कॉल करते हैं। हर कॉल सख्ती से आपकी अनुमतियों के दायरे में चलती है: एक प्रशासक पूरे खाते तक पहुँचता है, एक बायर केवल अपनी टीम के डेटा तक।

सीखने के लिए कोई अलग REST API नहीं है: जो मेथड आप यहाँ देखते हैं, वही endpoint प्रस्तुत करता है, इसलिए कैटलॉग असली इंटरफ़ेस से कभी अलग नहीं हो सकता।

वही मेथड बिल्ट-इन असिस्टेंट को भी संचालित करते हैं

ये मेथड केवल बाहरी क्लाइंट के लिए नहीं हैं। बिल्ट-इन Qubix AI असिस्टेंट — एडमिन पैनल की हर स्क्रीन पर उपलब्ध पैनल, बिना किसी सेटअप के — ठीक उसी कैटलॉग को कॉल करता है। इसलिए चाहे आप बिल्ट-इन असिस्टेंट से पूछें या अपना खुद का AI एजेंट MCP के माध्यम से कनेक्ट करें, दोनों आपके डेटा को पढ़ते हैं और कार्य करते हैं उन्हीं मेथड के जरिए, हमेशा आपकी अनुमतियों के दायरे में।

• बिल्ट-इन — हर पृष्ठ पर असिस्टेंट। देखें AI विश्लेषक चैट.
• बाहरी — Claude, Cursor या कोई अन्य MCP क्लाइंट कनेक्ट करें। देखें बाहरी AI कनेक्ट करना.

इसे कहाँ खोजें

एडमिन पैनल में, खाता मेनू (ऊपर-दाएँ, आपके नाम के बगल में) खोलें और चुनें MCP/API।

Endpoint

सब कुछ एक ही पते पर जाता है:

POST https://<your-domain>/api/mcp

ट्रांसपोर्ट Streamable HTTP (JSON-RPC 2.0) है — एक एकल endpoint जिसे तैयार MCP क्लाइंट स्वाभाविक रूप से समझते हैं, और जिसे आप किसी भी भाषा से सीधे भी कॉल कर सकते हैं (नीचे कोड उदाहरण देखें)।

आपका API टोकन

प्रोग्रामेटिक एक्सेस एक व्यक्तिगत टोकन (PAT) का उपयोग करती है — इसी पृष्ठ पर, API टोकन ब्लॉक में बनाया और प्रबंधित किया जाता है।

1. API टोकन जनरेट करें दबाएँ (या पुनः जनरेट करें यदि आपके पास पहले से एक है)।
2. टोकन तुरंत कॉपी करें — यह केवल एक बार दिखाया जाता है।

टोकन qbx_… जैसा दिखता है। Qubix केवल उसका hash संग्रहीत करता है और उसे फिर कभी नहीं दिखा सकता।

• प्रति उपयोगकर्ता एक टोकन। यह आपकी भूमिका और अनुमतियाँ विरासत में लेता है, इसलिए API के माध्यम से आप ठीक वही डेटा और कार्य देखते हैं जो इंटरफ़ेस में।
• पुनः जनरेट करें एक नया टोकन जारी करता है और पुराना तुरंत काम करना बंद कर देता है।
• रद्द करें टोकन को हटा देता है और उसका उपयोग करने वाली सारी पहुँच काट देता है।

टोकन को पासवर्ड की तरह समझें

एक व्यक्तिगत टोकन आपके रूप में साइन इन करने के बराबर है। इसे प्रकाशित या साझा न करें। यदि यह लीक हो जाए, तो यहाँ पुनः जनरेट करें दबाएँ — पुराना टोकन तुरंत मर जाता है।

क्लाइंट कनेक्ट करें

अधिकांश MCP क्लाइंट एक छोटा कॉन्फ़िग लेते हैं: endpoint और Authorization हेडर। जबकि टोकन जनरेशन के तुरंत बाद दिखाया जाता है, यह पृष्ठ नीचे दिए गए उदाहरण में पहले से ही असली मान भर देता है — इसे जैसा है वैसा ही कॉपी करें।

JSON

{
  "mcpServers": {
    "qubix": {
      "url": "https://<your-domain>/api/mcp",
      "headers": { "Authorization": "Bearer qbx_YOUR_TOKEN" }
    }
  }
}

किसी विशिष्ट असिस्टेंट (Claude Code, Claude Desktop, Cursor) के चरण-दर-चरण सेटअप के लिए, देखें बाहरी AI कनेक्ट करना.

कोड उदाहरण

अपने खुद के कोड से endpoint कॉल करने के लिए, auth और Streamable-HTTP हेडर के साथ एक JSON-RPC अनुरोध भेजें। पृष्ठ cURL, JavaScript और Python के लिए तैयार स्निपेट प्रदान करता है — टैब बदलें और कॉपी करें। उदाहरण के लिए, उपलब्ध मेथड की सूची बनाना:

Bash

curl -X POST 'https://<your-domain>/api/mcp' \
  -H 'Authorization: Bearer qbx_YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Python

import requests

res = requests.post(
    "https://<your-domain>/api/mcp",
    headers={
        "Authorization": "Bearer qbx_YOUR_TOKEN",
        "Content-Type": "application/json",
        "Accept": "application/json, text/event-stream",
    },
    json={"jsonrpc": "2.0", "id": 1, "method": "tools/list"},
)
print(res.text)

कस्टम इंटीग्रेशन के लिए

ये कच्ची कॉल किसी भी भाषा से प्रोटोकॉल को दर्शाती हैं। तैयार क्लाइंट (Claude, Cursor) को इनकी आवश्यकता नहीं — वे ऊपर दिए गए कॉन्फ़िग का उपयोग करते हैं।

API क्या प्रस्तुत करता है

पृष्ठ पूरा मेथड कैटलॉग सूचीबद्ध करता है — आज लगभग सौ मेथड — और प्रत्येक को रीड या राइट टैग किया गया है। वे आपकी अनुमतियों के दायरे में निम्न को कवर करते हैं:

• विश्लेषण — डैशबोर्ड, geo, ऑफ़र, networks, ट्रैफ़िक स्रोत, Facebook स्क्रीन और विज़िटर फ़नल, साथ ही एक एकल विज्ञापन, कैंपेन, ऑफ़र, क्रिएटिव, PWA, geo या ट्रैफ़िक स्रोत के लिए ड्रिल-डाउन।
• क्रिएटिव — सिमेंटिक खोज और सबसे अच्छा प्रदर्शन करने वाले क्रिएटिव थीम।
• Britva — ऑटोमेशन नियम, रोके गए विज्ञापन और फायरिंग इतिहास देखें; नियम बनाएँ, संपादित करें और रिलीज़ करें।
• क्रियाएँ — विज्ञापन और कैंपेन रोकें और फिर से शुरू करें; ऑफ़र, networks, ट्रैफ़िक स्रोत, ट्रैकर कैंपेन, pixels, वेबसाइट, डोमेन, PWA और push कैंपेन प्रबंधित करें।
• फ्री-फॉर्म क्वेरी — उन प्रश्नों के लिए एक रीड-ओनली क्वेरी मेथड जिन्हें तैयार मेथड कवर नहीं करते।

प्रत्येक मेथड अपने पैरामीटर दिखाता है और यह कि वह डेटा बदलता है या नहीं। किसी एक को नाम या विवरण से खोजने के लिए खोज बॉक्स का उपयोग करें।

राइट मेथड असली हैं

API के माध्यम से एक विज्ञापन रोकना, एक नियम या एक ऑफ़र हटाना आपके लाइव कैंपेन बदल देता है। Claude जैसे चैट क्लाइंट में ऐसे कार्य केवल आपकी पुष्टि के बाद चलते हैं — स्वीकृति देने से पहले प्रस्तावित चीज़ की समीक्षा करें।

आगे क्या

बाहरी AI कनेक्ट करना

Claude, Cursor या कोई अन्य MCP क्लाइंट चरण-दर-चरण सेट करें।

कनेक्शन

Qubix जिन बाहरी सेवाओं के साथ एकीकृत होता है उनकी कुंजियाँ।

टेम्पलेट

आपकी भूमिका — और इसलिए आपका टोकन — किस डेटा और कार्यों तक पहुँच सकती है।