Postiz MCP

परिचय

Model Context Protocol (MCP) का उपयोग करके AI एजेंटों को Postiz से कनेक्ट करें

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

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

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

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

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	पोस्ट के लिए वीडियो जेनरेट करें

प्रमाणीकरण

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

API कुंजी

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

OAuth टोकन

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

कनेक्ट करना

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

```
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
```

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

जब कोई 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 के माध्यम से ट्रिगर किए जाने चाहिए।