Postiz MCP

परिचय

मॉडल कॉन्टेक्स्ट प्रोटोकॉल (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 के माध्यम से ट्रिगर किए जाने चाहिए।