समीक्षा 2026-11-10 · API संस्करण 2026-11-09 · Markdown पढ़ें
MCP सेटअप
लोकल stdio MCP सर्वर जो UI और REST API के समान साझा सेवाओं को /api/v1 के
माध्यम से रैप करता है। एडाप्टर आपकी प्रोडक्ट की केवल कॉन्फ़िगर किए गए AiVideoEditor API को भेजता है।
कोई Supabase या प्रोवाइडर क्रेडेंशियल उपयोग नहीं होते।
पूर्वापेक्षाएँ
यह सोर्स-चेकआउट एडाप्टर है, प्रकाशित पैकेज या होस्टेड कनेक्शन नहीं।
AiVideoEditor रिपॉज़िटरी तक अधिकृत एक्सेस प्राप्त करें, Node 22+ इंस्टॉल करें, और
रिपॉज़िटरी रूट पर npm ci चलाएँ। /app/developers में केवल आवश्यक स्कोप और
गंतव्य एक्सेस वाली वर्कस्पेस प्रोडक्ट की बनाएँ। ड्राफ़्ट-ओनली की
प्रकाशित या शेड्यूल नहीं कर सकती। की कभी चैट प्रॉम्प्ट में पेस्ट न करें।
चलाएँ
export PUBLISHER_API_URL=https://app.example.com # HTTPS; http://localhost is allowed for dev
export PUBLISHER_API_KEY=pk_v1_… # create in /app/developers
node packages/mcp/bin/publisher-mcp.mjs # or: npm start --workspace packages/mcp
बिन वास्तविक एक्ज़ीक्यूटेबल लॉन्चर है (TypeScript + एक्सटेंशनलेस इंपोर्ट tsx से
रिज़ॉल्व होते हैं)। सारे डायग्नोस्टिक्स stderr पर जाते हैं; stdout केवल
प्रोटोकॉल ट्रैफ़िक रखता है। PUBLISHER_API_URL HTTPS होना चाहिए (प्लेन HTTP केवल
लूपबैक देव के लिए) और उसमें क्रेडेंशियल, क्वेरी या फ़्रैगमेंट नहीं होने चाहिए।
जेनेरिक क्लाइंट कॉन्फ़िगरेशन
{
"mcpServers": {
"autoposted": {
"command": "node",
"args": ["/absolute/path/to/packages/mcp/bin/publisher-mcp.mjs"],
"env": {
"PUBLISHER_API_URL": "https://app.example.com",
"PUBLISHER_API_KEY": "pk_v1_…"
}
}
}
}
लॉन्चर को Node 22+ और वर्कस्पेस डिपेंडेंसी (tsx,
@modelcontextprotocol/sdk) चाहिए। OAuth के साथ होस्टेड MCP ट्रांसपोर्ट भविष्य का काम है;
यह न मानें कि हर डेस्कटॉप या होस्टेड क्लाइंट पेस्ट की गई बियरर की समर्थन करता है।
टूल
| टूल | रीड/म्यूटेट | नोट्स |
|---|---|---|
list_accounts | read | की की अकाउंट एलाउलिस्ट का सम्मान करता है |
get_capabilities | read | फ़ॉर्मैट, सीमाएँ, सहमति आवश्यकताएँ |
create_upload_intent | mutate | डायरेक्ट अपलोड निर्देश लौटाता है; मीडिया बाइट टूल से कभी नहीं गुजरते |
finalize_upload | mutate | सेशन आईडी (+ multipart पार्ट रसीदें); सर्वर बाइट/MIME स्वयं देखता है |
create_draft | mutate | सोर्स + गंतव्य वेरिएंट |
validate_post | read | संरचित प्रति-गंतव्य समस्याएँ |
schedule_post | mutate | एक क्षण, ≤90 दिन आगे, expectedVersion आवश्यक |
publish_post | mutate | 202 सिमेंटिक्स; प्रकाशन का प्रमाण नहीं |
get_post_status | read | प्रति-गंतव्य स्थितियाँ और नेटिव लिंक |
list_posts | read | कर्सर पेजिनेशन |
cancel_delivery | mutate | केवल सुरक्षित रूप से अनक्लेम्ड रहते |
retry_delivery | mutate | केवल ज्ञात विफलताएँ; कभी डुप्लिकेट नहीं |
get_usage | read | कोई रिमेनिंग-पोस्ट काउंटर नहीं |
आवश्यक टूल आर्ग्युमेंट
| टूल | आवश्यक आर्ग्युमेंट |
|---|---|
list_accounts | कोई नहीं |
get_capabilities | कोई नहीं |
create_upload_intent | filename, declaredMime, declaredBytes |
finalize_upload | assetId, sessionId |
create_draft | caption, destinations |
validate_post | postId |
schedule_post | postId, scheduledAt, timezone, expectedVersion |
publish_post | postId |
get_post_status | postId |
list_posts | कोई नहीं |
cancel_delivery | deliveryId |
retry_delivery | deliveryId |
get_usage | कोई नहीं |
वैकल्पिक आर्ग्युमेंट में लिस्ट टूल पर पेजिनेशन, म्यूटेशन पर idempotencyKey,
multipart फ़ाइनलाइज़ेशन के लिए multipart.parts, और ड्राफ़्ट मीडिया तथा
गंतव्य वेरिएंट शामिल हैं। tools/list से रिटर्न किया रनटाइम टूल स्कीमा
वैकल्पिक फ़ील्ड, नेस्टेड आकार और वैलिडेशन सीमाओं के लिए प्रामाणिक है।
म्यूटिंग टूल वैकल्पिक idempotencyKey आर्ग्युमेंट स्वीकार करते हैं। छोड़ने पर
सर्वर एक बनाता है और हर परिणाम में उसे इको करता है: ट्रांसपोर्ट
विफलताओं सहित, जहाँ ऑपरेशन पहले ही API तक पहुँच सकता है (एरर में
transport_outcome_unknown और की होती है)। टूल म्यूटेशन कभी ऑटो-रिट्राइ नहीं करते;
डुप्लिकेट ऑपरेशन बनने से बचने के लिए समान आइडेंपोटेंसी की से रिट्राइ करें।
एजेंट वर्कफ़्लो उदाहरण
list_accounts+get_capabilities→ मान्य गंतव्य चुनें।create_upload_intent→ बाइट सीधे अपलोड करें →finalize_upload।create_draft→validate_post→ अमान्य गंतव्य ठीक करें या डिसेलेक्ट करें।publish_post(याschedule_post) → डिलीवरी ID नोट करें।get_post_status(बाउंडेड पोलिंग या ग्राहक वेबहुक):requires_actionप्रतिक्रियाओं को कार्रवाई योग्य निर्देश मानें, जैसे TikTok सहमति।
टेस्ट किए गए क्लाइंट
- ऑफ़िशियल
@modelcontextprotocol/sdkTypeScript क्लाइंट, वास्तविक subprocess stdio डॉक्यूमेंट किए बिन के विरुद्ध (initialize → tools/list → tools/call):packages/mcp/tests/stdio.test.tsमें टेस्ट किया गया, जिसमें क्लीन-stdout और स्टार्टअप-विफलता जाँचें शामिल हैं। - इन-मेमोरी ट्रांसपोर्ट पर ऑफ़िशियल SDK क्लाइंट: यह भी कवर।
- डेस्कटॉप क्लाइंट (Claude Desktop, Cursor आदि): अभी टेस्ट नहीं: ऊपर के जेनेरिक स्निपेट के अनुसार कॉन्फ़िगर करें और समर्थन का दावा करने से पहले परिणाम रिपोर्ट करें।
क्लाइंट संगतता
| क्लाइंट या ट्रांसपोर्ट | स्थिति | सेटअप |
|---|---|---|
| ऑफ़िशियल TypeScript SDK subprocess stdio | ऑटोमेटेड टेस्ट कवरेज | ऊपर दिखाया गया रिपॉज़िटरी लॉन्चर |
| ऑफ़िशियल SDK इन-मेमोरी ट्रांसपोर्ट | ऑटोमेटेड टेस्ट कवरेज | केवल टेस्ट हार्नेस |
| Claude Desktop / अन्य डेस्कटॉप क्लाइंट | मैन्युअल रूप से सत्यापित नहीं | लोकल stdio-सक्षम क्लाइंट; एब्सोल्यूट लॉन्चर पथ का उपयोग करें |
| ChatGPT होस्टेड कनेक्शन | इस एडाप्टर द्वारा प्रदान नहीं | होस्टेड ट्रांसपोर्ट चाहिए; लोकल stdio JSON होस्टेड कनेक्टर नहीं है |
| OAuth के साथ होस्टेड MCP | लागू नहीं | अलग प्रोडक्ट काम |
ट्रबलशूटिंग
- लॉन्चर डिपेंडेंसी रिज़ॉल्व नहीं कर पाता: अधिकृत सोर्स
चेकआउट में
npm ciचलाएँ और Node वर्ज़न जाँचें। असंबंधित सार्वजनिक पैकेज विकल्प न बनाएँ। - क्लाइंट कभी इनिशियलाइज़ नहीं होता: एब्सोल्यूट लॉन्चर पथ का उपयोग करें और stderr देखें। डिबगिंग आउटपुट stdout पर न लिखें।
401: सत्यापित करें कि कॉन्फ़िगर की गई प्रोडक्ट की वर्तमान है; रद्द होने पर UI में प्रतिस्थापन बनाएँ।403: स्कोप और अकाउंट प्रतिबंध जाँचें।transport_outcome_unknown: रिटर्न की गई आइडेंपोटेंसी की सुरक्षित रखें और पहचान योग्य ऑपरेशन उसी की से रिट्राइ करें, नई की से नहीं।requires_action: दिए गए निर्देश अधिकृत व्यक्ति को सौंपें; एजेंट TikTok मानवीय सहमति नहीं दे सकता।
क्रेडेंशियल हैंडलिंग
प्रोडक्ट की केवल आपके कॉन्फ़िगर किए AiVideoEditor API को भेजी जाती है
(Authorization: Bearer)। वह मॉडल प्रोवाइडर या सोशल
नेटवर्क को कभी नहीं भेजी जाती, कभी लॉग नहीं होती, और URL सत्यापित होते हैं ताकि की
रीडायरेक्ट फ़ॉलो न कर सके या कॉन्फ़िगर किए ओरिजिन से बाहर न निकल सके।