Postiz MCP

परिचय

MCP (मॉडल कॉन्टेक्स्ट प्रोटोकॉल) का उपयोग करके AI एजेंटों को Postiz से कनेक्ट करें

MCP (मॉडल कॉन्टेक्स्ट प्रोटोकॉल) AI एजेंटों को Postiz के साथ सीधे इंटरैक्ट करने की सुविधा देता है—इंटीग्रेशन सूचीबद्ध करना, पोस्ट शेड्यूल करना, इमेज और वीडियो जनरेट करना, लंबे वीडियो को शॉर्ट्स में क्लिप करना—यह सब एक मानकीकृत टूल-कॉलिंग इंटरफेस के माध्यम से।

इसका मतलब है कि आप Claude, ChatGPT, Cursor, या किसी भी MCP-संगत क्लाइंट को अपने Postiz खाते से कनेक्ट कर सकते हैं और प्राकृतिक भाषा के माध्यम से अपने सोशल मीडिया का प्रबंधन कर सकते हैं।

यह कैसे काम करता है

Postiz एक MCP सर्वर प्रदान करता है जो AI एजेंटों को 13 टूल देता है। एजेंट इन टूल्स को खोजता है, उनके स्कीमा को समझता है, और आपकी ओर से उन्हें कॉल करता है।

sequenceDiagram
    participant Agent as AI Agent
    participant MCP as Postiz MCP Server
    participant Postiz as Postiz Backend

    Agent->>MCP: Connect with API key / OAuth token
    MCP-->>Agent: List available tools
    Agent->>MCP: Call tool (e.g., schedule post)
    MCP->>Postiz: Execute action
    Postiz-->>MCP: Return result
    MCP-->>Agent: Tool response

उपलब्ध टूल

टूल	विवरण
integrationList	सभी कनेक्टेड सोशल मीडिया खातों की सूची बनाएं (वैकल्पिक रूप से समूह द्वारा फ़िल्टर किया गया)
groupList	आपके संगठन के लिए सभी समूहों (ग्राहकों) की सूची बनाएं
integrationSchema	प्लेटफ़ॉर्म-विशिष्ट पोस्टिंग नियम और सेटिंग्स स्कीमा प्राप्त करें
triggerTool	प्लेटफ़ॉर्म-विशिष्ट सहायक निष्पादित करें (जैसे, Discord चैनल सूचीबद्ध करें)
schedulePostTool	पोस्ट शेड्यूल करें, ड्राफ्ट करें, या तुरंत प्रकाशित करें
postsListTool	दो तिथियों के बीच शेड्यूल किए गए संगठन के पोस्ट की सूची बनाएं (उनकी वर्तमान सेटिंग्स के साथ)
postSettingsTool	शेड्यूल किए गए पोस्ट या ड्राफ्ट की प्रदाता सेटिंग्स अपडेट करें जो अभी तक प्रकाशित नहीं हुआ है
generateImageTool	पोस्ट के लिए AI इमेज जनरेट करें
generateVideoOptions	उपलब्ध वीडियो जनरेशन विकल्पों की सूची बनाएं
videoFunctionTool	वीडियो जनरेटर सेटिंग्स प्राप्त करें (जैसे, उपलब्ध आवाज़ें)
generateVideoTool	पोस्ट के लिए वीडियो जनरेट करें
clippingTool	लंबे YouTube वीडियो को कैप्शन वाले वर्टिकल क्लिप और ड्राफ्ट पोस्ट में बदलें
clippingStatusTool	क्लिपिंग की जांच करें और तैयार क्लिप प्राप्त करें

प्रमाणीकरण

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

API कुंजी

इसे सीधे MCP एंडपॉइंट URL में, या Bearer टोकन के रूप में उपयोग करें।

OAuth टोकन

यदि आप अन्य Postiz उपयोगकर्ताओं के लिए ऐप बना रहे हैं, तो टोकन प्राप्त करने के लिए OAuth2 का उपयोग करें। OAuth टोकन pos_ से शुरू होते हैं और API कुंजियों की तरह ही काम करते हैं।

कनेक्ट करना

अपनी API कुंजी या OAuth टोकन को Bearer टोकन के रूप में उपयोग करके `/mcp` एंडपॉइंट का उपयोग करें:

```text theme={null}
URL: https://mcp.postiz.com/mcp
Authorization: Bearer your-api-key
```

यह विधि API कुंजियों और OAuth टोकन दोनों का समर्थन करती है (जो `pos_` से उपसर्गित हैं)।

अपनी API कुंजी को URL में एम्बेड करके `/mcp/:apiKey` एंडपॉइंट का उपयोग करें:

```text theme={null}
URL: https://mcp.postiz.com/mcp/your-api-key
```

त्वरित उदाहरण

जब कोई AI एजेंट Postiz MCP का उपयोग करता है तो एक सामान्य इंटरैक्शन इस प्रकार दिखता है:

1. एजेंट integrationList को कॉल करता है, आपके कनेक्टेड खाते (X, LinkedIn, आदि) वापस मिलते हैं
2. एजेंट platform: "x" के साथ integrationSchema को कॉल करता है और X की वर्ण सीमाएं, सेटिंग्स और नियम सीखता है
3. एजेंट schedulePostTool को कॉल करता है, सही प्रारूप के साथ आपकी पोस्ट शेड्यूल करता है

यह सब स्वचालित रूप से होता है जब आप अपने AI एजेंट को कुछ इस तरह बताते हैं:

"कल सुबह 10 बजे X पर एक पोस्ट शेड्यूल करें: हमारी नई सुविधा की घोषणा करते हुए उत्साहित हैं!"

अक्सर पूछे जाने वाले प्रश्न

क्या Postiz MCP का उपयोग करने के लिए मुझे OpenAI कुंजी की आवश्यकता है?

नहीं। MCP सर्वर केवल Postiz के टूल्स को उजागर करता है। आपका AI क्लाइंट (Claude, ChatGPT, Cursor, आदि) मॉडल प्रदान करता है। Postiz को केवल OPENAI_API_KEY की आवश्यकता होती है यदि आप Postiz की अपनी AI सुविधाओं (इमेज जनरेशन, कोपायलट) का उपयोग करते हैं, जो आपके क्लाइंट को दिखाए गए MCP टूल्स से अलग हैं।

जब मेरी API कुंजी समाप्त हो जाती है या घुमाई जाती है तो क्या होता है?

Postiz API कुंजियाँ स्वचालित रूप से घूमती नहीं हैं, लेकिन यदि आप सेटिंग्स → डेवलपर्स → सार्वजनिक API में एक को पुनर्जीवित करते हैं, तो पुरानी कुंजी का उपयोग करने वाला हर MCP क्लाइंट तब तक काम करना बंद कर देता है जब तक आप उसका कॉन्फ़िगरेशन अपडेट नहीं करते। अपने क्लाइंट कॉन्फ़िगरेशन में URL या Authorization हेडर अपडेट करें और पुनः कनेक्ट करें।

सेल्फ-होस्टेड: मैं MCP एंडपॉइंट कैसे उजागर करूं?

MCP सर्वर Postiz बैकएंड के हिस्से के रूप में शुरू होता है और /mcp (Bearer प्रमाणीकरण), /mcp/:apiKey (URL में कुंजी), और /mcp-oauth (OAuth-संरक्षित) पर पहुंच योग्य है। आपके रिवर्स प्रॉक्सी को इन पथों को बैकएंड पर अग्रेषित करना चाहिए और स्ट्रीमिंग HTTP (Transfer-Encoding: chunked) का समर्थन करना चाहिए। रिवर्स प्रॉक्सी देखें।

क्या MCP टिप्पणियाँ पढ़ या उत्तर दे सकता है?

आज नहीं। वर्तमान टूल सेट इंटीग्रेशन पर केवल-पढ़ने और पोस्ट/मीडिया पर केवल-लिखने के लिए है। MCP के माध्यम से कोई getComments या replyToComment उजागर नहीं है। टिप्पणी उत्तर Postiz UI के माध्यम से ट्रिगर किए जाने चाहिए।

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