Postiz MCP
आधिकारिकPostiz के साथ अपने सोशल मीडिया को सुव्यवस्थित करें। पोस्ट शेड्यूल करें, प्रदर्शन का विश्लेषण करें, और सभी खातों को एक ही स्थान पर प्रबंधित करें।
Postiz MCP के साथ आप क्या कर सकते हैं?
- कनेक्ट किए गए खाते सूचीबद्ध करें — एजेंट से अपने कनेक्ट किए गए सोशल मीडिया खातों की सूची माँगें; चाहें तो समूह के अनुसार फ़िल्टर करें।
- प्लैटफ़ॉर्म के नियम जाँचें — पोस्ट का मसौदा तैयार करने से पहले, प्लैटफ़ॉर्म-विशिष्ट पोस्टिंग नियम और सेटिंग स्कीमा प्राप्त करें।
- पोस्ट शेड्यूल करें या प्रकाशित करें — किसी कनेक्ट किए गए खाते पर पोस्ट शेड्यूल करें, उसे ड्राफ़्ट के रूप में सहेजें या तुरंत प्रकाशित करें।
- शेड्यूल की गई पोस्ट की समीक्षा करें — अपनी संस्था की दो तारीखों के बीच शेड्यूल की गई पोस्ट और उनकी मौजूदा सेटिंग की सूची देखें।
- मीडिया जनरेट करें — पोस्ट के लिए AI इमेज या वीडियो जनरेट करें और वीडियो जनरेशन के उपलब्ध विकल्पों की सूची देखें।
- लंबे वीडियो को क्लिप में बदलें — लंबे YouTube वीडियो को कैप्शन वाली वर्टिकल क्लिप और पोस्ट के ड्राफ़्ट में बदलें, फिर क्लिपिंग की स्थिति जाँचें।
दस्तावेज़
परिचय
Model Context Protocol (MCP) का उपयोग करके AI एजेंट को Postiz से कनेक्ट करें
MCP (Model Context Protocol) 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 | अपने संगठन के सभी ग्रुप (ग्राहक) की सूची देखें |
integrationConnectTool | नया सोशल मीडिया खाता कनेक्ट करने के लिए लिंक प्राप्त करें |
integrationSchema | प्लेटफ़ॉर्म-विशिष्ट पोस्टिंग नियम और सेटिंग स्कीमा प्राप्त करें |
triggerTool | प्लेटफ़ॉर्म-विशिष्ट हेल्पर चलाएँ (जैसे, Discord चैनलों की सूची देखना) |
schedulePostTool | पोस्ट शेड्यूल करें, ड्राफ़्ट बनाएँ या तुरंत प्रकाशित करें |
postsListTool | दो तारीखों के बीच शेड्यूल की गई संगठन की पोस्ट की सूची देखें (उनकी मौजूदा सेटिंग के साथ) |
postSettingsTool | ऐसी शेड्यूल की गई पोस्ट या ड्राफ़्ट की प्रोवाइडर सेटिंग अपडेट करें, जो अभी तक प्रकाशित नहीं हुई है |
generateImageTool | पोस्ट के लिए AI इमेज बनाएँ |
generateVideoOptions | उपलब्ध वीडियो जनरेशन विकल्पों की सूची देखें |
videoFunctionTool | वीडियो जनरेटर की सेटिंग प्राप्त करें (जैसे, उपलब्ध आवाज़ें) |
generateVideoTool | पोस्ट के लिए वीडियो बनाएँ |
clippingTool | लंबे YouTube वीडियो को कैप्शन वाले वर्टिकल क्लिप में बदलें और पोस्ट के ड्राफ़्ट बनाएँ |
clippingStatusTool | क्लिपिंग की स्थिति जाँचें और तैयार क्लिप प्राप्त करें |
प्रमाणीकरण
MCP सर्वर से प्रमाणीकरण के दो तरीके हैं:
API Key
इसे सीधे MCP endpoint URL में या Bearer token के रूप में इस्तेमाल करें।
OAuth Token
अगर आप अन्य Postiz उपयोगकर्ताओं के लिए ऐप बना रहे हैं, तो टोकन प्राप्त करने के लिए OAuth2 का उपयोग करें। OAuth टोकन pos_ से शुरू होते हैं और API key की तरह ही काम करते हैं।
कनेक्ट करना
[tab] Bearer Token
Bearer token के रूप में अपनी API key या OAuth token के साथ
/mcpendpoint का उपयोग करें:URL: https://mcp.postiz.com/mcp Authorization: Bearer your-api-keyयह तरीका API key और OAuth token—दोनों को सपोर्ट करता है (जिनका प्रीफ़िक्स
pos_है)।
[tab] URL में API Key
URL में अपनी API key जोड़कर
/mcp/:apiKeyendpoint का उपयोग करें:URL: https://mcp.postiz.com/mcp/your-api-key
त्वरित उदाहरण
Postiz MCP का उपयोग करने पर AI एजेंट के साथ सामान्य इंटरैक्शन कुछ ऐसा दिखता है:
- एजेंट
integrationListको कॉल करता है और आपके कनेक्ट किए गए खाते (X, LinkedIn आदि) प्राप्त करता है। - एजेंट
integrationSchemaकोplatform: "x"के साथ कॉल करता है और X की अक्षर सीमा, सेटिंग और नियम जानता है। - एजेंट
schedulePostToolको कॉल करता है और सही फ़ॉर्मैट में आपकी पोस्ट शेड्यूल करता है।
यह सब तब अपने आप होता है, जब आप अपने AI एजेंट से कुछ ऐसा कहते हैं:
"कल सुबह 10 बजे X पर एक पोस्ट शेड्यूल करें: हमारी नई सुविधा की घोषणा करते हुए बेहद उत्साहित हैं!"
अक्सर पूछे जाने वाले प्रश्न
क्या Postiz MCP का उपयोग करने के लिए मुझे OpenAI key चाहिए?
नहीं। MCP सर्वर सिर्फ़ Postiz के टूल उपलब्ध कराता है। आपका AI क्लाइंट (Claude, ChatGPT, Cursor आदि) मॉडल उपलब्ध कराता है। Postiz को केवल OPENAI_API_KEY की ज़रूरत तब होती है, जब आप Postiz की अपनी AI सुविधाओं (इमेज जनरेशन, copilot) का उपयोग करते हैं। ये सुविधाएँ आपके क्लाइंट को उपलब्ध कराए गए MCP टूल से अलग हैं।
मेरी API key की समय-सीमा समाप्त होने या उसे बदलने पर क्या होगा?
Postiz API key अपने आप रोटेट नहीं होतीं। लेकिन अगर आप Settings → Developers → Public API में कोई key फिर से जनरेट करते हैं, तो पुरानी key का उपयोग करने वाला हर MCP क्लाइंट तब तक काम करना बंद कर देगा, जब तक आप उसका कॉन्फ़िगरेशन अपडेट नहीं करते। अपने क्लाइंट कॉन्फ़िगरेशन में URL या Authorization हेडर अपडेट करें और फिर से कनेक्ट करें।
सेल्फ-होस्टेड: MCP endpoint को कैसे उपलब्ध कराऊँ?
MCP सर्वर, Postiz backend के हिस्से के रूप में शुरू होता है और /mcp (Bearer auth), /mcp/:apiKey (URL में key) और /mcp-oauth (OAuth-सुरक्षित) पर उपलब्ध होता है। आपके reverse proxy को इन पाथ को backend तक फ़ॉरवर्ड करना होगा और streaming HTTP (Transfer-Encoding: chunked) को सपोर्ट करना होगा। Reverse Proxies देखें।
क्या MCP टिप्पणियाँ पढ़ सकता है या उनका जवाब दे सकता है?
अभी नहीं। मौजूदा टूल सेट इंटीग्रेशन के लिए केवल पढ़ने की सुविधा देता है और पोस्ट/मीडिया के लिए केवल लिखने की। MCP के ज़रिए कोई getComments या replyToComment उपलब्ध नहीं कराया गया है। टिप्पणियों के जवाब Postiz UI के ज़रिए भेजने होंगे।
यह दस्तावेज़ Mintlify, एक डेवलपर दस्तावेज़ीकरण प्लेटफ़ॉर्म, पर बनाया और होस्ट किया गया है।