Postiz MCP

आधिकारिक

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

postiz.pro पर देखें

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

List connected social accounts — Ask the agent to retrieve all your linked platforms with integrationList, optionally filtered by customer group.
Check platform posting rules — Use integrationSchema to get character limits, supported media types, and settings for a specific platform before posting.
Schedule or publish posts — Create, draft, or immediately publish social media posts via schedulePostTool with platform-specific formatting.
Generate AI images for posts — Produce images directly through generateImageTool to attach to scheduled content.
Generate videos for posts — Explore available video options with generateVideoOptions and videoFunctionTool, then create videos using 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 का उपयोग करता है:

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