AiVideoEditor
मुफ़्त शुरू करें
मेन्यू

समीक्षा 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_accountsreadकी की अकाउंट एलाउलिस्ट का सम्मान करता है
get_capabilitiesreadफ़ॉर्मैट, सीमाएँ, सहमति आवश्यकताएँ
create_upload_intentmutateडायरेक्ट अपलोड निर्देश लौटाता है; मीडिया बाइट टूल से कभी नहीं गुजरते
finalize_uploadmutateसेशन आईडी (+ multipart पार्ट रसीदें); सर्वर बाइट/MIME स्वयं देखता है
create_draftmutateसोर्स + गंतव्य वेरिएंट
validate_postreadसंरचित प्रति-गंतव्य समस्याएँ
schedule_postmutateएक क्षण, ≤90 दिन आगे, expectedVersion आवश्यक
publish_postmutate202 सिमेंटिक्स; प्रकाशन का प्रमाण नहीं
get_post_statusreadप्रति-गंतव्य स्थितियाँ और नेटिव लिंक
list_postsreadकर्सर पेजिनेशन
cancel_deliverymutateकेवल सुरक्षित रूप से अनक्लेम्ड रहते
retry_deliverymutateकेवल ज्ञात विफलताएँ; कभी डुप्लिकेट नहीं
get_usagereadकोई रिमेनिंग-पोस्ट काउंटर नहीं

आवश्यक टूल आर्ग्युमेंट

टूलआवश्यक आर्ग्युमेंट
list_accountsकोई नहीं
get_capabilitiesकोई नहीं
create_upload_intentfilename, declaredMime, declaredBytes
finalize_uploadassetId, sessionId
create_draftcaption, destinations
validate_postpostId
schedule_postpostId, scheduledAt, timezone, expectedVersion
publish_postpostId
get_post_statuspostId
list_postsकोई नहीं
cancel_deliverydeliveryId
retry_deliverydeliveryId
get_usageकोई नहीं

वैकल्पिक आर्ग्युमेंट में लिस्ट टूल पर पेजिनेशन, म्यूटेशन पर idempotencyKey, multipart फ़ाइनलाइज़ेशन के लिए multipart.parts, और ड्राफ़्ट मीडिया तथा गंतव्य वेरिएंट शामिल हैं। tools/list से रिटर्न किया रनटाइम टूल स्कीमा वैकल्पिक फ़ील्ड, नेस्टेड आकार और वैलिडेशन सीमाओं के लिए प्रामाणिक है।

म्यूटिंग टूल वैकल्पिक idempotencyKey आर्ग्युमेंट स्वीकार करते हैं। छोड़ने पर सर्वर एक बनाता है और हर परिणाम में उसे इको करता है: ट्रांसपोर्ट विफलताओं सहित, जहाँ ऑपरेशन पहले ही API तक पहुँच सकता है (एरर में transport_outcome_unknown और की होती है)। टूल म्यूटेशन कभी ऑटो-रिट्राइ नहीं करते; डुप्लिकेट ऑपरेशन बनने से बचने के लिए समान आइडेंपोटेंसी की से रिट्राइ करें।

एजेंट वर्कफ़्लो उदाहरण

  1. list_accounts + get_capabilities → मान्य गंतव्य चुनें।
  2. create_upload_intent → बाइट सीधे अपलोड करें → finalize_upload।
  3. create_draft → validate_post → अमान्य गंतव्य ठीक करें या डिसेलेक्ट करें।
  4. publish_post (या schedule_post) → डिलीवरी ID नोट करें।
  5. get_post_status (बाउंडेड पोलिंग या ग्राहक वेबहुक): requires_action प्रतिक्रियाओं को कार्रवाई योग्य निर्देश मानें, जैसे TikTok सहमति।

टेस्ट किए गए क्लाइंट

  • ऑफ़िशियल @modelcontextprotocol/sdk TypeScript क्लाइंट, वास्तविक 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 सत्यापित होते हैं ताकि की रीडायरेक्ट फ़ॉलो न कर सके या कॉन्फ़िगर किए ओरिजिन से बाहर न निकल सके।