MCP

AI क्लाइंट को Influence के खातों, मीडिया, समीक्षाओं, शेड्यूलिंग और उपलब्ध इनसाइट्स से कनेक्ट करें.

काम के हिसाब से एंडपॉइंट चुनें. प्रोडक्ट टूल के लिए अनुमति वाला Influence वर्कस्पेस चाहिए; दस्तावेज़ों का सर्वर सिर्फ़ सार्वजनिक गाइड पढ़ता है.

एंडपॉइंट	उद्देश्य
`https://influence.so/api/mcp`	सामान्य प्रोडक्ट कनेक्शन, जिसमें चालू होने पर योजना, इमेज और शोध के टूल शामिल हैं.
`https://influence.so/api/mcp/claude`	Claude कनेक्शन. इसमें मीडिया अपलोड, ड्राफ़्ट, समीक्षा, शेड्यूलिंग, योजना और इनसाइट्स हैं; इमेज बनाने वाले टूल और `search`/`fetch` शामिल नहीं हैं.
`https://docs.influence.so/mcp`	सार्वजनिक दस्तावेज़ खोजना और पढ़ना. प्रोडक्ट खाता ज़रूरी नहीं; यह वर्कस्पेस का डेटा नहीं खोल सकता और पब्लिश नहीं कर सकता.

कनेक्ट करें और टूल खोजें

क्लाइंट में Influence की OAuth प्रक्रिया इस्तेमाल करें या, जहाँ क्लाइंट बेयरर प्रमाणीकरण का समर्थन करे, सीमित अनुमतियों वाली API कुंजी इस्तेमाल करें. ऐप्स और ऑटोमेशन में क्लाइंट के हिसाब से सेटअप मिलता है. API कुंजियों को क्लाइंट के सीक्रेट एनवायरनमेंट में रखें.

Influence का ईमेल और वर्कस्पेस (nickname) सत्यापित करने के लिए profileGet पढ़ें, फिर स्कोप और AI शेड्यूलिंग सीमा के लिए connectionStatusGet पढ़ें. AI क्लाइंट के अपने साइन इन में अलग ईमेल हो सकता है. अनुमति देते समय सही Influence पहचान चुनें.

OAuth ऐक्सेस रिन्यू करने के लिए offline_access की स्पष्ट सहमति चाहिए. नए ChatGPT कस्टम कनेक्शन के सेटअप निर्देशों में यह Base स्कोप भी दिया गया है. टूल रीफ़्रेश करने से अनुमतियाँ नहीं जुड़तीं और पुराने कनेक्शन के Base स्कोप अपग्रेड नहीं होते.

tools/list और MCP टूल रेफ़रेंस इस्तेमाल करें. खोज में ऐसे टूल भी दिख सकते हैं जिनके स्कोप अभी नहीं दिए गए हैं; हर कॉल में फिर भी अनुमतियाँ लागू होती हैं. चालू फ़ीचर और क्लाइंट का समर्थन उपलब्धता को प्रभावित करते हैं. सामान्य और Claude एंडपॉइंट अलग हैं; स्किल या प्लगइन डाउनलोड करने से यह साबित नहीं होता कि इंस्टॉल किए गए क्लाइंट ने उसके टूल लोड कर लिए.

तैयार कंटेंट से पोस्ट बनाएँ

accountList पढ़ें, फिर हर चुने हुए खाते की ज़रूरी सेटिंग्स और मीडिया सीमाओं के लिए integrationSchema पढ़ें. बोर्ड, चैनल और ऐसे दूसरे गंतव्य खोजने के लिए बताए गए सेवा प्रदाता लुकअप टूल इस्तेमाल करें.
ऐक्सेस की जा सकने वाली HTTPS फ़ाइल को url और वैकल्पिक name के साथ mediaImport से इंपोर्ट करें. असली होस्ट फ़ाइल अलग file ऑब्जेक्ट इस्तेमाल करती है; फ़ाइल ID न गढ़ें. लोकल फ़ाइल के लिए मल्टीपार्ट अपलोड टूल या मौजूदा SDK/CLI हेल्पर इस्तेमाल करें. मीडिया की सीमाएँ और तैयार होने की स्थिति लागू हैं.
शेड्यूल करने के लिए तैयार 1–10 पोस्ट के हर आइटम में स्थिर itemKey, draft और scheduledFor के साथ campaignScheduleBatchReview इस्तेमाल करें. यह ड्राफ़्ट और लंबित समीक्षाएँ एक साथ सहेजता है, हर गंतव्य के लिए टेक्स्ट/मीडिया और अधिकतम 50 डिलीवरी के साथ. सिर्फ़ ड्राफ़्ट बनाने या एडिट करने के लिए campaignDraftSave इस्तेमाल करें; campaignReview सहेजे गए कैंपेन के लिए इच्छित कार्रवाई तैयार करता है.
पूरी सहेजी गई समीक्षा दिखाएँ. दिखाया गया और लोड हो चुका कार्ड वह जानकारी देता है; कार्ड न हो, तो सटीक खाते, टेक्स्ट, मीडिया प्रीव्यू या लिंक, सेटिंग्स, शेड्यूल किया गया समय और टाइम ज़ोन दिखाएँ. समीक्षा गायब, पुरानी या अनिश्चित हो तो campaignReviewGet पढ़ें.
कार्रवाई करने से पहले इंसान की नई, स्पष्ट मंज़ूरी लें. समर्थित कार्ड का अपना मंज़ूरी बटन होता है. योग्य सोशल पोस्ट के लिए चैट की मंज़ूरी campaignReviewExecute या campaignScheduleBatchExecute से भेजी जाती है. निजी campaignReviewApprove UI कार्रवाई मॉडल से कॉल न करें.

TikTok Direct में सामान्य चैट से काम किया जा सकता है. tiktokCreatorInfoGet पढ़ें, फिर विज़िबिलिटी, इंटरैक्शन, प्रचार और लागू AI/संगीत विकल्पों में जो तय नहीं हुए हैं, उनके बारे में एक ही सवाल पूछें. लागू सहमति का टेक्स्ट और लिंक दिखाएँ; सहमति मान न लें और प्रतिबंधित इंटरैक्शन चालू न करें. व्यक्ति के पूरे चुनाव campaignReview से सहेजें; इसमें reviewId और tiktokSettings एंट्री दें, जिनमें connectionId और settings हों. इससे नई लंबित समीक्षा लौटती है, मंज़ूरी नहीं. वही समीक्षा दिखाएँ और कार्रवाई करने से पहले नई, स्पष्ट मंज़ूरी का इंतज़ार करें. समर्थित समीक्षा कार्ड वैकल्पिक रहता है. TikTok इनबॉक्स पोस्टिंग TikTok में पूरी होती है.

TikTok की सहमति उसी सटीक समीक्षा से जुड़ी होती है; ड्राफ़्ट पर सहेजी सहमति से यह चरण पूरा नहीं होता. समीक्षा के चुनाव सहेजने से ड्राफ़्ट का नया वर्शन बनता है और पिछली समीक्षा पुरानी हो जाती है, भले सेटिंग्स न बदली हों.

पुष्टि और रिकवरी

जिन टूल को पुष्टि चाहिए, उन्हें पहले _confirmationCapability या _idempotencyKey के बिना तैयार करें. लौटाई गई कैपेबिलिटी और कॉलर की बनाई स्थिर इडेम्पोटेंसी कुंजी के साथ उसी बिज़नेस इनपुट की पुष्टि करें. इस आदान-प्रदान से उस टूल की बताई कार्रवाई सहेजी या पूरी की जाती है; यह इंसान की पब्लिशिंग मंज़ूरी से अलग है. होस्ट की अनुमति संबंधी माँगों का पालन करें.

mediaUploadPart, mediaUploadComplete और mediaUploadAbort अनुमति मिले अपलोड को सीधे आगे बढ़ाते हैं. फ़ाइल के बाइट लौटाए गए स्टोरेज URL पर ट्रांसफ़र करें, टूल JSON में नहीं. रुकावट के बाद अपलोड की स्थिति पढ़ें और उसी फ़ाइल व clientKey से आगे बढ़ें.

अपलोड का expiresAt उसकी मौजूदा ट्रांसफ़र या प्रोसेसिंग समय सीमा है: शुरुआत में 24 घंटे, फिर अपलोड पूरा होने के बाद प्रोसेसिंग शुरू होते ही 15 मिनट. तैयार मीडिया इस समय सीमा से समाप्त नहीं होता; मीडिया लाइब्रेरी से उसका assetId दोबारा इस्तेमाल करें.

अनिश्चितता के बाद पुष्टि और दोबारा कोशिश के मान रखें. पब्लिशिंग की कार्रवाई फिर चलाने से पहले सहेजी समीक्षा या कैंपेन पढ़ें; कभी न मानें कि टाइमआउट का मतलब कुछ नहीं हुआ. बदली हुई या समय सीमा पार कर चुकी समीक्षा के लिए नई समीक्षा और मंज़ूरी चाहिए.

AI शेड्यूलिंग सीमाएँ MCP क्लाइंट और Influence IQ में साझा हैं. सामान्य HTTP/CLI ऑटोमेशन और वेब पर हाथ से शेड्यूल करना इससे बाहर हैं. इनसाइट्स के दायरे और रीफ़्रेश के व्यवहार का वर्णन इनसाइट्स में है. वैकल्पिक इवेंट सब्सक्रिप्शन के लिए सक्षम होस्ट का अलग समर्थन चाहिए; वे हर क्लाइंट में बैकग्राउंड सूचना मिलने का सामान्य वादा नहीं हैं.