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 के साथ /mcp endpoint का उपयोग करें:

URL: https://mcp.postiz.com/mcp
Authorization: Bearer your-api-key

यह तरीका API key और OAuth token—दोनों को सपोर्ट करता है (जिनका प्रीफ़िक्स pos_ है)।

[tab] URL में API Key

URL में अपनी API key जोड़कर /mcp/:apiKey endpoint का उपयोग करें:

URL: https://mcp.postiz.com/mcp/your-api-key

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

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

  1. एजेंट integrationList को कॉल करता है और आपके कनेक्ट किए गए खाते (X, LinkedIn आदि) प्राप्त करता है।
  2. एजेंट integrationSchema को platform: "x" के साथ कॉल करता है और X की अक्षर सीमा, सेटिंग और नियम जानता है।
  3. एजेंट 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, एक डेवलपर दस्तावेज़ीकरण प्लेटफ़ॉर्म, पर बनाया और होस्ट किया गया है।