> ## Documentation Index
> Fetch the complete documentation index at: https://docs.youka.io/llms.txt
> Use this file to discover all available pages before exploring further.

# AI assistants (MCP) से Youka इस्तेमाल करें

> Claude Code, Cursor, Codex, या किसी भी MCP client को Youka से कनेक्ट करें और चैट करके कराओके और लिरिक वीडियो बनाएं।

Youka के पास एक MCP server है। [MCP](https://modelcontextprotocol.io) (Model Context Protocol) वह मानक तरीका है जिससे AI assistants बाहरी tools से कनेक्ट होते हैं। एक बार कनेक्ट करने के बाद, आप अपने assistant से “\~/Music/song.mp3 का एक karaoke video बनाओ” जैसी बातें कह सकते हैं और यह आपके Youka account में project बना देता है, उसके पूरा होने का इंतज़ार करता है, और आपको editor link या download link दे देता है।

यह server किसी भी ऐसे MCP client के साथ काम करता है जो custom header के साथ remote (Streamable HTTP) servers को सपोर्ट करता हो, जैसे Claude Code, Cursor, और Codex।

> [!NOTE]
>
> ChatGPT और Claude के लिए Official Youka apps जल्द आ रहे हैं। तब तक, इस पेज से
> किसी client का उपयोग Youka API key के साथ करें।

## आपको क्या चाहिए

* Credits वाला Youka account। MCP server वही credits उपयोग करता है जो web app करती है। देखें [Understanding credits](https://docs.youka.io/hi/web/understanding-credits.md)।
* एक Youka API key। इसे [online.youka.io/account](https://online.youka.io/account) पर **API keys** के तहत बनाएं। देखें [Authentication](https://docs.youka.io/hi/api/authentication.md)।

Server details:

| Setting | Value |
| - | - |
| URL | `https://mcp.youka.io/mcp` |
| Transport | Streamable HTTP |
| Auth | `Authorization: Bearer YOUR_API_KEY` |

> [!WARNING]
>
> आपकी API key आपके Youka account और उसके credits तक full access देती है। इसे
> shared files और repositories से बाहर रखें। अगर key leak हो जाए, तो अपने
> account page पर उसे delete करें और नई key बनाएं।

## अपने assistant को कनेक्ट करें

> [tab] Claude Code
>
> अपने terminal में यह चलाएं, और `YOUR_API_KEY` को अपनी key से बदल दें:
>
> ```bash theme={null}
> claude mcp add --transport http youka https://mcp.youka.io/mcp \
>   --header "Authorization: Bearer YOUR_API_KEY"
> ```
>
> जांचें कि यह कनेक्ट हो गया:
>
> ```bash theme={null}
> claude mcp list
> ```
>
> आपको `youka: https://mcp.youka.io/mcp (HTTP) - ✔ Connected` दिखना चाहिए।
>
> By default server केवल current folder के लिए add होता है। हर folder में Youka उपयोग करने के लिए `--scope user` जोड़ें।

> [tab] Cursor
>
> `~/.cursor/mcp.json` (हर project के लिए) या अपने project folder में `.cursor/mcp.json` खोलें, और `youka` server जोड़ें:
>
> ```json theme={null}
> {
>   "mcpServers": {
>     "youka": {
>       "url": "https://mcp.youka.io/mcp",
>       "headers": {
>         "Authorization": "Bearer ${env:YOUKA_API_KEY}"
>       }
>     }
>   }
> }
> ```
>
> `YOUKA_API_KEY` को उस environment में सेट करें जिससे Cursor start होता है, या `${env:YOUKA_API_KEY}` को अपनी key से replace कर दें। फिर Cursor की settings के MCP section में जाएँ और जांचें कि `youka` enabled है।

> [tab] Codex
>
> चलाएँ:
>
> ```bash theme={null}
> codex mcp add youka --url https://mcp.youka.io/mcp \
>   --bearer-token-env-var YOUKA_API_KEY
> ```
>
> या इसे खुद `~/.codex/config.toml` में जोड़ें:
>
> ```toml theme={null}
> [mcp_servers.youka]
> url = "https://mcp.youka.io/mcp"
> bearer_token_env_var = "YOUKA_API_KEY"
> ```
>
> Codex, `YOUKA_API_KEY` environment variable से key पढ़ता है, इसलिए Codex start करने से पहले इसे सेट करें:
>
> ```bash theme={null}
> export YOUKA_API_KEY="YOUR_API_KEY"
> ```
>
> `youka` enabled है या नहीं, यह देखने के लिए `codex mcp list` चलाएँ।

> [tab] Other clients
>
> कोई भी MCP client जो custom headers के साथ remote servers को सपोर्ट करता है, काम करेगा। उपयोग करें:
>
> * **URL:** `https://mcp.youka.io/mcp`
> * **Transport:** Streamable HTTP (कभी-कभी "HTTP" कहा जाता है)
> * **Header:** `Authorization: Bearer YOUR_API_KEY`
>
> यह server sessions का उपयोग नहीं करता, इसलिए अन्य settings की जरूरत नहीं है।

## इसे आज़माएँ

अपने assistant से plain language में पूछें। उदाहरण के लिए:

```text theme={null}
मेरे पास कितने Youka credits हैं?
```

```text theme={null}
~/Music/song.mp3 का एक karaoke video बनाओ। Lyrics को automatically transcribe करो।
```

```text theme={null}
./demo.wav का एक lyric video मेरे "Neon" preset के साथ बनाओ, फिर उसे 1080p में export करो और मुझे download link दो।
```

```text theme={null}
मेरे latest Youka project में, second verse "..." की जगह "..." होना चाहिए। Lyrics ठीक करो और उन्हें फिर से sync करो।
```

एक typical karaoke request कुछ इस तरह होती है:

**1. Upload**

Assistant, Youka से upload link मांगता है और आपकी file upload करता है। Uploading
free है।

**2. Check the cost**

यह जांचता है कि project कितने credits उपयोग करेगा और उसे आपके
balance से compare करता है।

**3. Create the project**

Youka vocals हटाता है और lyrics sync करता है। इसमें कुछ मिनट लगते हैं। Project ready होने तक
assistant status check करता रहता है।

**4. Edit or export**

आपको Youka editor में project खोलने के लिए link मिलता है। अगर आप
video file मांगते हैं, तो assistant उसे export करता है और आपको download link देता है।

Project बनाना अपने आप कभी video render नहीं करता। Export कब करना है यह आप तय करते हैं, ताकि आप पहले lyrics या style ठीक कर सकें—या तो chat में, या [Youka editor](https://docs.youka.io/hi/web/using-studio.md) में।

## Assistant क्या कर सकता है

| Tool | What it does | Uses credits |
| - | - | - |
| `get_account` | आपका account, credit balance, और upload limits दिखाता है। | No |
| `list_presets` | आपके saved style [presets](https://docs.youka.io/hi/web/presets.md) की list दिखाता है। | No |
| `prepare_upload` | आपके computer पर मौजूद एक audio या video file के लिए upload link बनाता है। | No |
| `quote_project` | नया project कितना cost करेगा, यह दिखाता है। | No |
| `create_karaoke_video` | एक file से editable karaoke project बनाता है (vocals removed, synced lyrics)। | Yes |
| `create_lyric_video` | एक file से editable lyric-video project बनाता है (original audio, synced lyrics)। | Yes |
| `list_projects` | आपके projects की list दिखाता है, newest पहले। | No |
| `get_project` | project का status (processing, ready, या failed), lyrics, stems, exports, और editor link दिखाता है। | No |
| `sync_lyrics` | corrected lyrics को फिर से sync करता है, या song को फिर से transcribe करता है। | Yes |
| `get_task` | lyrics sync का status दिखाता है। | No |
| `quote_export` | export कितना cost करेगा, यह दिखाता है। | No |
| `export_video` | project को अभी saved state के अनुसार render करता है, editor में किए गए edits सहित। | Yes |
| `get_export` | export का status दिखाता है और ready होने पर download link देता है। | No |

## Credits और safety

* **Web app जैसे ही credits.** Project बनाना, lyrics को फिर से sync करना, और export का cost वही है जो [online.youka.io](https://online.youka.io) पर है।
* **पहले cost check होता है.** अगर आपके पास पर्याप्त credits नहीं हैं, तो Youka request refuse कर देता है और बता देता है। कुछ भी charge नहीं होता।
* **Double charges नहीं.** अगर timeout के बाद assistant request retry करे, तो Youka retry पहचान लेता है और फिर से charge करने की जगह original result लौटाता है।
* **Credits Youka पर खरीदे जाते हैं.** Assistant credits नहीं खरीद सकता। और जोड़ने के लिए देखें [Buy more credits](https://docs.youka.io/hi/web/buy-credits.md)।
* **Paid tools सिर्फ आपके कहने पर चलते हैं.** Assistant को project बनाना, lyrics sync करना, या export करना केवल तब करने के लिए कहा गया है जब आप मांगें।

## Troubleshooting

> [accordion] 401 Unauthorized, or the server shows as failed
>
> API key missing या invalid है। जांचें कि header बिल्कुल ऐसा ही है
> `Authorization: Bearer yk_...`, जिसमें `Bearer` के बाद एक space हो और key के अंदर कोई extra
> spaces या quotes न हों। अगर आपने account page पर key delete कर दी है, तो नई
> key बनाएं और अपने client में update करें। Codex और Cursor setups जो
> `YOUKA_API_KEY` पढ़ते हैं, उनके लिए सुनिश्चित करें कि variable उस environment में set है जिससे app
> start होती है।

> [accordion] Not enough credits
>
> Assistant से अपना balance पूछें, या इसे
> [online.youka.io](https://online.youka.io) पर check करें। फिर [buy more
> credits](https://docs.youka.io/hi/web/buy-credits.md) करें और फिर से पूछें।

> [accordion] The project failed
>
> Assistant से project दिखाने को कहें। उसमें error शामिल होगा। सुनिश्चित करें कि
> file एक supported audio या video file है और आपकी account द्वारा दिखाए गए upload limits के भीतर है।

> [accordion] The lyrics are wrong
>
> Assistant को सही lyrics बताएं और उनसे फिर से sync करने को कहें, या
> editor link खोलकर खुद [edit the lyrics](https://docs.youka.io/hi/web/edit-lyrics.md) करें। फिर
> दोबारा export करें।

## Related docs

* [AI agents](https://docs.youka.io/hi/agents.md) — एक agent से Youka CLI और skill का उपयोग करें
* [Authentication](https://docs.youka.io/hi/api/authentication.md) — API keys बनाएं और उपयोग करें
* [Understanding credits](https://docs.youka.io/hi/web/understanding-credits.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.