Postiz MCP

आधिकारिक

Postiz के साथ अपने सोशल मीडिया को सुव्यवस्थित करें। पोस्ट शेड्यूल करें, प्रदर्शन का विश्लेषण करें, और सभी खातों को एक ही स्थान पर प्रबंधित करें।

Postiz MCP के साथ आप क्या कर सकते हैं?

  • कनेक्टेड सोशल अकाउंट्स की सूची देखें — एजेंट से अपने सभी लिंक किए गए प्लेटफ़ॉर्म को integrationList के साथ प्राप्त करने के लिए कहें, वैकल्पिक रूप से ग्राहक समूह द्वारा फ़िल्टर किया गया।
  • प्लेटफ़ॉर्म पोस्टिंग नियम जांचें — पोस्ट करने से पहले किसी विशिष्ट प्लेटफ़ॉर्म के लिए वर्ण सीमाएँ, समर्थित मीडिया प्रकार और सेटिंग्स प्राप्त करने के लिए integrationSchema का उपयोग करें।
  • पोस्ट शेड्यूल करें या प्रकाशित करें — प्लेटफ़ॉर्म-विशिष्ट फ़ॉर्मेटिंग के साथ schedulePostTool के माध्यम से सोशल मीडिया पोस्ट बनाएं, ड्राफ्ट करें या तुरंत प्रकाशित करें।
  • पोस्ट के लिए AI इमेज जनरेट करें — शेड्यूल किए गए कंटेंट से जोड़ने के लिए generateImageTool के माध्यम से सीधे इमेज तैयार करें।
  • पोस्ट के लिए वीडियो जनरेट करेंgenerateVideoOptions और videoFunctionTool के साथ उपलब्ध वीडियो विकल्पों का अन्वेषण करें, फिर generateVideoTool का उपयोग करके वीडियो बनाएं।

दस्तावेज़

परिचय

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

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

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

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

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

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पोस्ट शेड्यूल करें, ड्राफ़्ट करें, या तुरंत प्रकाशित करें
generateImageToolपोस्ट के लिए AI चित्र उत्पन्न करें
generateVideoOptionsउपलब्ध वीडियो जनरेशन विकल्पों की सूची बनाएं
videoFunctionToolवीडियो जनरेटर सेटिंग्स प्राप्त करें (जैसे, उपलब्ध आवाज़ें)
generateVideoToolपोस्ट के लिए वीडियो उत्पन्न करें

प्रमाणीकरण

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

API कुंजी

Postiz में सेटिंग्स > डेवलपर्स > पब्लिक API से अपनी API कुंजी प्राप्त करें। इसे सीधे MCP एंडपॉइंट URL में या Bearer टोकन के रूप में उपयोग करें।

OAuth टोकन

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

कनेक्ट करना

अपनी API कुंजी या OAuth टोकन के साथ `/mcp` एंडपॉइंट का उपयोग Bearer टोकन के रूप में करें:
```
URL: https://api.postiz.com/mcp
Authorization: Bearer your-api-key
```

यह विधि API कुंजियों और OAuth टोकन (`pos_` से उपसर्गित) दोनों का समर्थन करती है।
URL में अपनी API कुंजी एम्बेड करके `/mcp/:apiKey` एंडपॉइंट का उपयोग करें:
```
URL: https://api.postiz.com/mcp/your-api-key
```
स्व-होस्टेड इंस्टेंस के लिए, `https://api.postiz.com` को अपने `NEXT_PUBLIC_BACKEND_URL` से बदलें।

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

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

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