MCP के ज़रिए अपना Agent जोड़ें

अपनी कनेक्शन विधि चुनें

FreeLipSync, https://freelipsync.com/mcp पर एक दूरस्थ MCP समापन बिंदु को उजागर करता है। यह एक एजेंट को REST API के समान ही वीडियो निर्माण क्षमताएं और खाता क्रेडिट देता है। आपके पास एक पंजीकृत FreeLipSync खाता होना चाहिए; अनाम पहुंच समर्थित नहीं है. staging पर परीक्षण करते समय इसके बजाय अपने staging मूल का उपयोग करें।

API Key कॉन्फ़िगरेशन और OAuth दोनों समर्थित हैं। प्रति सर्वर प्रविष्टि एक क्रेडेंशियल स्रोत चुनें। मौजूदा कॉन्फ़िगरेशन फ़ाइल कनेक्ट करने का एक वैध तरीका बनी हुई है; आपको OAuth का उपयोग करने की आवश्यकता नहीं है।

कुंजी बनाएँ और निर्माण संवाद से उसका पूरा मान कॉपी करें। OAuth में कुंजी कॉपी करने की ज़रूरत नहीं है। हर खाते में अधिकतम 5 API Keys और 5 स्वतंत्र OAuth कनेक्शन हो सकते हैं। API Key का उपयोग कुंजी स्लॉट लेता है, OAuth कनेक्शन स्लॉट नहीं। दोनों तरीके खाते का बैलेंस, मॉडल और सीमाएँ साझा करते हैं।

OAuth प्राधिकरण प्रवाह

1. Authorization हेडर या API Key सेटिंग के बिना, अपने क्लाइंट में रिमोट HTTPS URL जोड़ें।
2. क्लाइंट के लिए उपयुक्त Connect / Authenticate / Sign in चुनें।
3. ब्राउज़र में, अपने FreeLipSync खाते में साइन इन करें और अनुरोध करने वाले क्लाइंट और अनुमतियों की समीक्षा करें।
4. एक नया कनेक्शन बनाएं (डिफ़ॉल्ट), या बदलने के लिए स्पष्ट रूप से मौजूदा कनेक्शन चुनें। किसी अन्य डिवाइस पर एक सफल प्राधिकरण आमतौर पर अलग से गिना जाता है।
5. एजेंट को आपके खरीदे गए एपीआई क्रेडिट खर्च करने की अनुमति दें, फिर अधिकृत करें। क्लाइंट के पास लौटें और नीचे दिए गए टूल को सत्यापित करें।

आप अनुरोध को अस्वीकार कर सकते हैं. यदि सभी 5 कनेक्शन स्लॉट का उपयोग किया जाता है, तो Agent कंसोल में पुराने कनेक्शन को स्पष्ट रूप से बदलें या रद्द करें; नया प्राधिकरण किसी कनेक्शन को चुपचाप बेदखल नहीं करता है। टोकन रीफ्रेश और मौजूदा प्राधिकरण को दोबारा कनेक्ट करने से कोई स्लॉट नहीं जुड़ता है। जेनरेशन सबमिट होने पर एक OAuth कनेक्शन आपके खाते के क्रेडिट को खर्च कर सकता है।

क्लाइंट OAuth संगतता मायने रखती है: FreeLipSync एक खुले डायनामिक-पंजीकरण समापन बिंदु के बजाय प्रकाशित क्लाइंट पहचान मेटाडेटा (CIMD) और पूर्व-पंजीकृत क्लाइंट का समर्थन करता है। जहां समर्थित हो वहां संगत क्लाइंट संस्करण या निर्दिष्ट क्लाइंट आईडी का उपयोग करें। यदि कोई क्लाइंट केवल डायनेमिक पंजीकरण का समर्थन करता है और साइन-इन विफल हो जाता है, तो क्लाइंट पंजीकरण की जांच करने के लिए API Key विधि का उपयोग करें या समर्थन से संपर्क करें।

ग्राहक अनुकूलता और OAuth अंतर

OAuth पंजीकरण और टोकन प्रमाणीकरण अलग हैं। FreeLipSync CIMD या none + PKCE या private_key_jwt के साथ पूर्व-पंजीकृत क्लाइंट आईडी का समर्थन करता है। यह समर्थित विधियों की नई CIMD सरणी के साथ-साथ पुराने एकल-विधि फ़ील्ड को समझता है। हस्ताक्षरित ग्राहक अपनी प्रकाशित सार्वजनिक कुंजियों का स्वचालित रूप से उपयोग करते हैं; उपयोगकर्ता निजी कुंजी अपलोड नहीं करते हैं.

FreeLipSync ओपन डायनेमिक रजिस्ट्रेशन (DCR), क्लाइंट-सीक्रेट प्रमाणीकरण, या client_credentials अनुदान की पेशकश नहीं करता है। यदि किसी क्लाइंट को DCR की आवश्यकता है, तो जहां उपलब्ध हो, उसके पूर्व-पंजीकृत सार्वजनिक-क्लाइंट विकल्प का उपयोग करें, या कस्टम Bearer हेडर का समर्थन करने वाले क्लाइंट में API Key कॉन्फ़िगरेशन का उपयोग करें। एक निर्दिष्ट आईडी प्राप्त करें और इसे कॉन्फ़िगर करने से पहले वास्तविक कॉलबैक पंजीकृत करें। एक API Key और एक OAuth क्लाइंट आईडी अलग-अलग क्रेडेंशियल हैं।

Codex: कॉन्फ़िग फ़ाइल या OAuth

Codex में Plugins → MCPs के अंतर्गत एक दूरस्थ HTTP सर्वर जोड़ें या संपादित करें; कुछ संस्करण Settings → MCP सर्वर का उपयोग करते हैं। यह स्थानीय MCP प्रविष्टि API Key कॉन्फ़िगरेशन का समर्थन करती है और ऊपर वर्णित होस्ट-प्लगइन OAuth प्रविष्टि से अलग है।

एक क्रेडेंशियल स्रोत चुनें। उदाहरण https://freelipsync.com/mcp का उपयोग करते हैं। staging के लिए, इसे https://staging.freelipsync.com/mcp से बदलें और अपने staging खाते में कुंजी बनाएं। उत्पादन और staging कुंजियाँ विनिमेय नहीं हैं।

विकल्प ए: डेस्कटॉप सेटिंग्स में एक API Key पेस्ट करें

जब आप पर्यावरण चर को कॉन्फ़िगर नहीं करना चाहते हैं तो इस विकल्प का उपयोग करें। Agent कंसोल में एक कुंजी बनाएं, पूरा रहस्य कॉपी करें, फिर भरें:

Bearer के बाद एक स्थान का उपयोग करें; कुंजी में स्वयं कोई Bearer उपसर्ग नहीं है। हेडर को FLS_API_KEY नाम न दें या गुप्त को Bearer token env var में पेस्ट न करें। सहेजें और पुनः कनेक्ट करें; यदि क्लाइंट अभी भी पुराने कॉन्फ़िगरेशन का उपयोग करता है, तो उसे पुनरारंभ करें या एक नया सत्र खोलें।

समतुल्य व्यक्तिगत ~/.codex/config.toml प्रविष्टि है:

[mcp_servers.freelipsync]
url = "https://freelipsync.com/mcp"
http_headers = { Authorization = "Bearer YOUR_API_KEY" }

विकल्प बी: एक पर्यावरण चर के माध्यम से API Key की आपूर्ति करें

Bearer token env var एक वैरिएबल नाम लेता है, कोई रहस्य नहीं। इसे FLS_API_KEY पर सेट करें। वह चर Codex चलाने वाली प्रक्रिया के वातावरण में मौजूद होना चाहिए। इसका मूल्य Bearer के बिना पूर्ण कुंजी है; Codex उपसर्ग जोड़ता है।

संबंधित व्यक्तिगत कॉन्फ़िगरेशन फ़ाइल है:

[mcp_servers.freelipsync]
url = "https://freelipsync.com/mcp"
bearer_token_env_var = "FLS_API_KEY"

Codex CLI के लिए एक टर्मिनल से लॉन्च किया गया:

export FLS_API_KEY='YOUR_API_KEY'
codex mcp list
codex
# Inspect /mcp in the new session.

किसी अन्य टर्मिनल में एक वेरिएबल निर्यात करने से पहले से चल रहे डेस्कटॉप ऐप अपडेट नहीं होता है। डॉक या स्टार्ट मेनू से लॉन्च किया गया ऐप टर्मिनल वेरिएबल्स को इनहेरिट नहीं कर सकता है। यदि आप अनिश्चित हैं कि डेस्कटॉप प्रक्रिया वातावरण कैसे प्रदान किया जाए, तो विकल्प ए का उपयोग करें।

Headers HTTP अनुरोध हेडर बनाता है। Headers from environment variables मौजूदा पर्यावरण चर से हेडर मान पढ़ता है। कोई भी फ़ील्ड सिस्टम वातावरण चर नहीं बनाता है। FLS_API_KEY नामक हेडर Bearer सेटिंग को पॉप्युलेट नहीं करता है, और MCP_BEARER_TOKEN जैसे ग्रे प्लेसहोल्डर का मतलब यह नहीं है कि वेरिएबल कॉन्फ़िगर किया गया है।

विकल्प C: ब्राउज़र में OAuth के साथ अधिकृत करें

केवल URL दर्ज करें। Bearer token env var, Headers और Headers from environment variables को खाली छोड़ दें, जिसमें किसी भी पिछली Authorization पंक्ति को हटाना शामिल है। सहेजें, जहां प्रस्तावित हो वहां Authenticate / Sign in चुनें, FreeLipSync में साइन इन करें और कनेक्शन स्वीकृत करें। कोई API Key बनाने या चिपकाने की आवश्यकता नहीं है।

कॉन्फ़िगरेशन फ़ाइल के लिए, केवल रखें:

[mcp_servers.freelipsync]
url = "https://freelipsync.com/mcp"

सीएलआई आदेश:

# Run the next line only if this server name does not exist; otherwise edit it.
codex mcp add freelipsync --url https://freelipsync.com/mcp
codex mcp login freelipsync
codex mcp list

कमांड में freelipsync को अपने सहेजे गए सर्वर नाम से बदलें। उपरोक्त तीन TOML ब्लॉक विकल्प हैं; सर्वर के लिए एक प्रविष्टि रखें. OAuth पर स्विच करने से पहले कुंजीबद्ध कॉन्फ़िगरेशन को हटा दें: लॉग इन करने से गलत Authorization हेडर की मरम्मत नहीं होती है जो अभी भी कॉन्फ़िगर किया गया है।

सहेजने के बाद कनेक्शन जांचें

एक नए सत्र में, पूछें: "मेरे मॉडल और क्रेडिट की जांच करने के लिए FreeLipSync get_capabilitys और get_usage पर कॉल करें। वीडियो न बनाएं।" एक सफल खाता प्रतिक्रिया कनेक्शन की पुष्टि करती है; अकेले सूची में प्रदर्शित होने वाला सर्वर नाम ऐसा नहीं करता।

HTTP 401, के लिए जांचें कि URL और कुंजी एक ही वातावरण से संबंधित हैं, कुंजी पूर्ण है, स्थिर हेडर Authorization: Bearer YOUR_API_KEY है, और कोई पुराना Bearer-वेरिएबल या डुप्लिकेट Authorization सेटिंग नहीं है। विकल्प बी के साथ, उस प्रक्रिया के वातावरण की भी जांच करें जो वास्तव में क्लाइंट को लॉन्च करता है।

फ़ील्ड परिभाषाओं के लिए आधिकारिक OpenAI MCP गाइड और कॉन्फ़िगरेशन संदर्भ देखें।

Claude Code: कॉन्फ़िग फ़ाइल या OAuth

API Key एक्सेस के लिए, इस प्रविष्टि को व्यक्तिगत/स्थानीय MCP कॉन्फ़िगरेशन में रखें या प्रोजेक्ट के लिए इसे .mcp.json में मर्ज करें। पर्यावरण चर को Claude Code द्वारा विस्तारित किया गया है। वास्तविक कुंजी को साझा कॉन्फ़िगरेशन से बाहर रखें और वेरिएबल सेट के साथ Claude Code प्रारंभ करें।

{
  "mcpServers": {
    "freelipsync": {
      "type": "http",
      "url": "https://freelipsync.com/mcp",
      "headers": {"Authorization": "Bearer ${FLS_API_KEY}"}
    }
  }
}

export FLS_API_KEY='YOUR_API_KEY'
claude mcp list

OAuth के लिए, पहले कुंजी वाली प्रविष्टि या उसके Authorization हेडर को हटाएं, एक URL-केवल HTTP सर्वर जोड़ें, और एक इंटरैक्टिव Claude Code सत्र में /mcp के माध्यम से प्रमाणित करें:

claude mcp add --transport http --scope user freelipsync https://freelipsync.com/mcp
claude
# In Claude Code, run /mcp and choose Authenticate for freelipsync.

एक समय में एक ही विधि का प्रयोग करें. एक कॉन्फ़िगर किया गया अमान्य Bearer हेडर किसी भिन्न प्रवाह के माध्यम से साइन इन करके ठीक नहीं किया जाएगा। Claude Code की आधिकारिक MCP गाइड देखें।

Claude Desktop और Claude web

OAuth के लिए, क्लाउड का Connectors प्रबंधन पृष्ठ खोलें, FreeLipSync नामक एक कस्टम वेब/रिमोट कनेक्टर जोड़ें, और https://freelipsync.com/mcp दर्ज करें। साइन-इन चुनें और जहां उपलब्ध हो वहां क्लाउड की प्रकाशित ग्राहक पहचान का उपयोग करें; FreeLipSync प्राधिकरण पृष्ठ को पूरा करें। किसी संगठन को अपने मालिक से पहले कनेक्टर को सक्षम करने की आवश्यकता हो सकती है। दूरस्थ कनेक्टर्स को सार्वजनिक HTTPS समापन बिंदु तक पहुंचना चाहिए; लोकलहोस्ट क्लाउड के क्लाउड से उपलब्ध नहीं है। क्लाउड का रिमोट कनेक्टर गाइड देखें।

पुराने Claude Desktop कॉन्फ़िगरेशन-फ़ाइल रूट के लिए, एक stdio-केवल क्लाइंट को दूरस्थ समापन बिंदु तक एक स्थानीय पुल की आवश्यकता होती है; रिमोट url को stdio कॉन्फ़िगरेशन में चिपकाना पर्याप्त नहीं है। Node.js / npx स्थापित होने पर, इस प्रविष्टि को claude_desktop_config.json में मर्ज करें (इसे डेस्कटॉप की डेवलपर सेटिंग्स से खोलें) और डेस्कटॉप को पुनरारंभ करें। प्लेसहोल्डर को स्थानीय रूप से बदलें और इस व्यक्तिगत फ़ाइल को निजी रखें।

{
  "mcpServers": {
    "freelipsync": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote", "https://freelipsync.com/mcp",
        "--header", "Authorization:${FLS_AUTH_HEADER}"
      ],
      "env": {"FLS_AUTH_HEADER": "Bearer YOUR_API_KEY"}
    }
  }
}

mcp-remote एक तृतीय-पक्ष संगतता ब्रिज है, FreeLipSync पैकेज नहीं। इसके मेंटेनर के निर्देश और अपने स्थापित संस्करण की समीक्षा करें। इसका हेडर तर्क पर्यावरण विस्तार का समर्थन करता है; उपरोक्त प्रारूप तर्क के अंदर रिक्त स्थान से भी बचाता है। उपलब्ध होने पर ग्राहक के मूल HTTP समर्थन को प्राथमिकता दें। यह डेस्कटॉप फ़ाइल Claude web के लिए कॉन्फ़िगरेशन तंत्र नहीं है।

Cursor: कॉन्फ़िग फ़ाइल या OAuth

API Key एक्सेस के लिए, अपने व्यक्तिगत ~/.cursor/mcp.json (या एक प्रोजेक्ट .cursor/mcp.json को स्रोत नियंत्रण से बाहर रखा जाता है जब इसमें एक कुंजी होती है) का उपयोग करें। प्लेसहोल्डर को स्थानीय रूप से बदलें. यह न मानें कि किसी अन्य क्लाइंट के प्रारूप से पर्यावरण विस्तार आपके स्थापित Cursor संस्करण में काम करता है।

{
  "mcpServers": {
    "freelipsync": {
      "url": "https://freelipsync.com/mcp",
      "headers": {"Authorization": "Bearer YOUR_API_KEY"}
    }
  }
}

OAuth के लिए, हेडर ऑब्जेक्ट को हटाते हुए, केवल url के साथ समान प्रविष्टि का उपयोग करें। Cursor की MCP सेटिंग्स में, कनेक्ट/प्रमाणित करें और यदि प्रस्तावित हो तो ब्राउज़र प्राधिकरण को पूरा करें। क्लाइंट का कॉन्फ़िगरेशन बदलने के बाद उसे पुनः लोड करें या पुनरारंभ करें, फिर Agent मोड में टूल को सत्यापित करें। यदि उस संस्करण का पंजीकरण प्रवाह असंगत है, तो ऊपर दिए गए कुंजी कॉन्फ़िगरेशन का उपयोग करें। Cursor के आधिकारिक MCP निर्देश देखें।

VS Code और GitHub Copilot

मूल VS Code MCP कॉन्फ़िगरेशन के लिए, फ़ाइल में वास्तविक कुंजी के बजाय पासवर्ड इनपुट के साथ .vscode/mcp.json बनाएं:

{
  "inputs": [
    {"type":"promptString","id":"fls-key","description":"FreeLipSync API Key","password":true}
  ],
  "servers": {
    "freelipsync": {
      "type":"http",
      "url":"https://freelipsync.com/mcp",
      "headers":{"Authorization":"Bearer ${input:fls-key}"}
    }
  }
}

OAuth के लिए, सर्वर के प्रकार और URL को बरकरार रखते हुए, inputs और headers को हटा दें। सर्वर प्रारंभ/कनेक्ट करें और प्रमाणीकरण संकेत का पालन करें; ग्राहक पंजीकरण ऊपर वर्णित अनुसार संगत होना चाहिए। Copilot के Agent मोड में इसके टूल का चयन करें और नीचे सत्यापन संकेत का प्रयास करें। VS Code प्रारूप servers का उपयोग करता है, किसी अन्य क्लाइंट के mcpServers का नहीं; इंटरैक्टिव इनपुट प्रत्येक Copilot हार्नेस या पोर्टेबल कॉन्फ़िगरेशन द्वारा समर्थित नहीं हैं। VS Code MCP संदर्भ देखें।

उपकरण सत्यापित करें और संकेत देने का प्रयास करें

पहले अपने एजेंट से पूछें: "मेरे उपलब्ध मॉडल और क्रेडिट बैलेंस की जांच करने के लिए FreeLipSync का उपयोग करें। अभी तक एक वीडियो न बनाएं।" इसे क्रेडिट खर्च किए बिना, get_capabilities और get_usage पर कॉल करना चाहिए। कॉन्फ़िगरेशन फ़ाइल में सूचीबद्ध सर्वर पर्याप्त सबूत नहीं है कि प्रमाणीकरण काम करता है।

फिर प्रयास करें: "मेरी छवि और ऑडियो से एक छोटी Image Fast बात करने वाली तस्वीर बनाएं। पहले एक उद्धरण प्राप्त करें और मुझे क्रेडिट बताएं। सबमिट करने से पहले मेरी पुष्टि की प्रतीक्षा करें। यदि आप मेरी स्थानीय फ़ाइलें अपलोड नहीं कर सकते हैं, तो मुझे ब्राउज़र अपलोड लिंक दें।" खर्च करने वाले टूल के लिए ग्राहक की स्वीकृति सक्षम रखें।

किसी एजेंट से स्थानीय फ़ाइलें अपलोड करना

दो स्थानीय फ़ाइल पथ हैं, साथ ही HTTPS आयात भी है। किसी स्थानीय पथ को import_asset URL के रूप में न पार करें।

• जो क्लाइंट फ़ाइलें पढ़ सकता है और HTTP PUT भेज सकता है, वह kind, filename, content_type, size_bytes और idempotency_key के साथ create_asset_upload कॉल करता है। वह मिले URL पर बताए गए हेडर के साथ असली फ़ाइल बाइट अपलोड करता है, फिर confirm_asset_upload कॉल करता है। हस्ताक्षरित स्टोरेज URL पर API Key कभी न भेजें।
• स्थानीय फ़ाइल/HTTP एक्सेस के बिना एक क्लाइंट प्रत्येक छवि/वीडियो/ऑडियो के लिए create_asset_upload_session पर कॉल करता है। आप browser_upload_url खोलें, उसी FreeLipSync खाते में साइन इन करें और ब्राउज़र में अपलोड करें। एजेंट asset_id को बरकरार रखता है और get_asset को पोल करता है; आपको आईडी को वापस कॉपी करने की ज़रूरत नहीं है. अपलोड टिकट को सार्वजनिक रूप से साझा न करें।
• मौजूदा सार्वजनिक HTTPS फ़ाइल के लिए, kind, url, idempotency_key के साथ import_asset आयात शुरू करता है। उद्धृत करने से पहले तैयार होने तक प्रतीक्षा करें।

एक URL-केवल/क्लाउड कनेक्टर केवल MCP का उपयोग करके आपकी डेस्कटॉप फ़ाइलों तक पहुंच प्राप्त नहीं करता है। उदाहरण के लिए, क्लाउड के रिमोट कनेक्टर उसके क्लाउड से चलते हैं, इसलिए जब क्लाइंट आपके अटैचमेंट को हस्ताक्षरित URL पर स्थानांतरित नहीं कर सकता है तो ब्राउज़र अपलोड लिंक का उपयोग करें।

क्रेडिट, पुनः प्रयास और कनेक्शन प्रबंधन

API और MCP की दरें समान हैं: Video Lip Sync / Image Fast के लिए 1 क्रेडिट/सेकंड, Image Max के लिए 2 और Image Super / Music Video के लिए 3। सत्यापित ऑडियो अवधि अगले पूरे सेकंड तक ऊपर की ओर पूर्णांकित होती है, न्यूनतम 5 सेकंड। estimate_generation से total_points और कोटेशन ID मिलता है; create_generation उस quote_id और idempotency_key को लेता है। अपलोड, उपयोग जाँच और अनुमान में क्रेडिट नहीं लगते। स्वीकार किया गया निर्माण रद्द नहीं किया जा सकता; केवल प्रोसेसिंग विफल होने पर मूल आरक्षित राशि वापस मिलती है। API बिलिंग और रिकवरी देखें।

अनिश्चित प्रस्तुतिकरण के बाद वही उद्धरण और आइडेम्पोटेंसी कुंजी रखें। लौटाई गई जॉब आईडी सहेजें और उससे पूछताछ करें; एजेंट को कोई अन्य कार्य करके "पुनः प्रयास करने" के लिए न कहें। poll_after_seconds का उपयोग करके स्थिति जाँचें, Retry-After पर वापस जाएं, और कई सक्रिय कार्यों को एक साथ क्वेरी करने के लिए list_generations का उपयोग करें। एपीआई और MCP अकाउंट रीड बकेट साझा करते हैं, जबकि सभी तीन वेबसाइट/एपीआई/MCP प्रवेश बिंदु सबमिशन आवृत्ति और वीडियो निष्पादन क्षमता साझा करते हैं। वेबसाइट और API/MCP में अलग-अलग अधूरे कार्य भत्ते हैं: प्रत्येक पूल में Free 1, Starter 3, Pro 10। सभी REST/MCP क्रेडेंशियल API/MCP पूल साझा करते हैं। उदाहरण के लिए API/MCP का उपयोग क्यों करें देखें।

Agent कंसोल से एक कुंजी या OAuth कनेक्शन रद्द करें। किसी कुंजी को रद्द करने से REST सहित इसे साझा करने वाले प्रत्येक ग्राहक में इसका भविष्य में उपयोग बंद हो जाता है; OAuth कनेक्शन को रद्द करने से केवल वह कनेक्शन प्रभावित होता है। कोई भी ऑपरेशन पहले से स्वीकृत कार्यों को रद्द नहीं करता है। अकेले स्थानीय क्लाइंट प्रविष्टि को हटाने से FreeLipSync पर क्रेडेंशियल रद्द नहीं होता है। जब आपको अलग-अलग निरस्तीकरण की आवश्यकता हो तो अलग-अलग कुंजियों या स्वतंत्र प्राधिकरणों का उपयोग करें, न कि समवर्तीता बढ़ाने के लिए।

समस्या निवारण

संस्करणों के बीच क्लाइंट सेटिंग्स बदल सकती हैं। वर्तमान निर्देशों के लिए प्रत्येक ग्राहक से जुड़े आधिकारिक दस्तावेज़ देखें। प्रत्यक्ष HTTP एकीकरण की आवश्यकता है? एपीआई दस्तावेज़ पढ़ें।