2slides

2slides MCP सर्वर

MCP क्लाइंट्स को 2slides.com टूल्स उपलब्ध कराएं: PowerPoint डेक और कस्टम-डिज़ाइन की गई स्लाइड्स बनाएं, AI वॉइस नैरेशन जोड़ें, और तैयार फ़ाइलें डाउनलोड लिंक के रूप में वापस पाएं।

अपनी API कुंजी प्राप्त करें

कनेक्ट करने से पहले, 2slides.com/api से API कुंजी प्राप्त करें।

कनेक्ट करें

2slides एक होस्टेड Streamable HTTP MCP एंडपॉइंट चलाता है, और यह stdio पैकेज भी भेजता है। दोनों एक ही खाते और एक ही क्रेडिट्स के विरुद्ध समान 7 टूल्स उपलब्ध कराते हैं।

	Streamable HTTP	stdio (यह पैकेज)
सेटअप	एक कमांड, कुछ भी इंस्टॉल करने की आवश्यकता नहीं	Node.js 18+ चाहिए, npx पैकेज लाता है
अपडेट्स	सर्वर-साइड, हमेशा वर्तमान	आपकी मशीन पर फिर से डाउनलोड होता है
चलता है	किसी भी रिमोट-सक्षम MCP क्लाइंट में	किसी भी क्लाइंट में जो स्थानीय प्रक्रिया शुरू कर सकता है

विकल्प 1 — Streamable HTTP (अनुशंसित)

Anthropic के MCP दस्तावेज़ HTTP को "रिमोट MCP सर्वर से कनेक्ट करने के लिए अनुशंसित विकल्प" कहते हैं, और 2slides एक होस्टेड सेवा है जिसमें कोई स्थानीय फ़ाइलें या प्रक्रियाएँ नहीं हैं, इसलिए यहाँ से शुरू करें।

Claude Code

claude mcp add --transport http 2slides "https://2slides.com/api/mcp?apikey=YOUR_2SLIDES_API_KEY"

claude mcp list से सत्यापित करें — सर्वर को ✔ Connected रिपोर्ट करना चाहिए।

प्रोजेक्ट कॉन्फ़िग (.mcp.json, आपकी टीम के साथ साझा)

{
  "mcpServers": {
    "2slides": {
      "type": "http",
      "url": "https://2slides.com/api/mcp?apikey=YOUR_2SLIDES_API_KEY"
    }
  }
}

Claude Desktop / claude.ai: इसे claude.ai/customize/connectors पर उसी URL के साथ कस्टम कनेक्टर के रूप में जोड़ें।

विकल्प 2 — stdio (स्थानीय प्रक्रिया)

इसका उपयोग तब करें जब क्लाइंट केवल स्थानीय प्रक्रियाएँ शुरू कर सकता है, जब मशीन के पास 2slides.com तक सीधा मार्ग नहीं है, या जब आप सर्वर को स्वयं पिन और पैच करना चाहते हैं।

Claude Code

claude mcp add 2slides -e API_KEY=YOUR_2SLIDES_API_KEY -- npx -y 2slides-mcp@latest

Claude Desktop — ~/Library/Application Support/Claude/claude_desktop_config.json संपादित करें (Windows पर %APPDATA%\Claude\claude_desktop_config.json):

{
  "mcpServers": {
    "2slides": {
      "command": "npx",
      "args": ["-y", "2slides-mcp@latest"],
      "env": {
        "API_KEY": "YOUR_2SLIDES_API_KEY"
      }
    }
  }
}

-y फ़्लैग npx को बिना संकेत दिए पैकेज इंस्टॉल करने देता है। बाद में Claude Desktop को पूरी तरह से पुनः आरंभ करें; चैट में, टूल्स पैनल खोलें और आपको नीचे दिए गए टूल्स दिखने चाहिए।

उपलब्ध टूल्स

---

slides_generate (POST /api/v1/slides/generate)

पूर्व-निर्मित थीम (Fast PPT) का उपयोग करके PowerPoint प्रस्तुति बनाएं। themeId खोजने के लिए पहले themes_search का उपयोग करें।

• तर्क:
  • userInput (स्ट्रिंग, आवश्यक) — प्रस्तुति सामग्री
  • themeId (स्ट्रिंग, आवश्यक) — themes_search से थीम ID
  • responseLanguage (स्ट्रिंग, वैकल्पिक, डिफ़ॉल्ट: Auto) — आउटपुट भाषा; समर्थित मान: Auto, English, Spanish, Arabic, Portuguese, Indonesian, Japanese, Russian, Hindi, French, German, Greek, Vietnamese, Turkish, Thai, Polish, Italian, Korean, Simplified Chinese, Traditional Chinese
  • mode (वैकल्पिक, डिफ़ॉल्ट: sync) — sync तुरंत downloadUrl लौटाता है; async jobs_get के साथ पोल करने के लिए jobId लौटाता है
• क्रेडिट्स: 1 प्रति पृष्ठ
• उदाहरण:

  {
    "themeId": "st-1756528793701-fcg5fblt2",
    "userInput": "Generate a 5-slide intro to machine learning",
    "responseLanguage": "English",
    "mode": "sync"
  }
  

---

themes_search (GET /api/v1/themes/search)

slides_generate के साथ उपयोग करने के लिए पूर्व-निर्मित थीम खोजें।

• तर्क:
  • query (स्ट्रिंग, आवश्यक) — खोज कीवर्ड (जैसे business, minimal, dark)
  • limit (संख्या, वैकल्पिक, डिफ़ॉल्ट: 10, सीमा: 1–100)
• रिटर्न: id, name, description, previewUrl, tags के साथ थीम की सरणी
• क्रेडिट्स: मुफ़्त
• उदाहरण:

  { "query": "business", "limit": 5 }
  

---

jobs_get (GET /api/v1/jobs/{jobId})

किसी कार्य की स्थिति पोल करें और तैयार होने पर परिणाम प्राप्त करें।

• तर्क:
  • jobId (स्ट्रिंग, आवश्यक)
• रिटर्न: jobId, status (pending / processing / success / failed), message, downloadUrl (सफलता पर), slidePageCount, createdAt, updatedAt, duration (ms), jobUrl (केवल Nano Banana कार्य)
• क्रेडिट्स: मुफ़्त
• नोट: status के success या failed होने तक हर 20 सेकंड में पोल करें।
• उदाहरण:

  { "jobId": "D8h9VYDGdTlZ6wWSEoctF" }
  

---

slides_create_like_this (POST /api/v1/slides/create-like-this)

संदर्भ छवि की शैली से मेल खाती स्लाइड्स (Nano Banana) बनाएं।

• तर्क:
  • userInput (स्ट्रिंग, आवश्यक) — प्रस्तुति सामग्री
  • referenceImageUrl (स्ट्रिंग, आवश्यक) — शैली संदर्भ छवि का URL
  • responseLanguage (स्ट्रिंग, वैकल्पिक, डिफ़ॉल्ट: Auto)
  • aspectRatio (स्ट्रिंग, वैकल्पिक, डिफ़ॉल्ट: 16:9) — मान्य मान: 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9
  • resolution (स्ट्रिंग, वैकल्पिक, डिफ़ॉल्ट: 2K) — 1K, 2K, 4K
  • page (संख्या, वैकल्पिक, डिफ़ॉल्ट: 0) — 0 = स्वतः-पहचान, 1–100 = सटीक पृष्ठ संख्या
  • contentDetail (स्ट्रिंग, वैकल्पिक, डिफ़ॉल्ट: standard) — concise या standard
  • mode (स्ट्रिंग, वैकल्पिक, डिफ़ॉल्ट: async) — async jobId लौटाता है; sync तुरंत downloadUrl लौटाता है
• क्रेडिट्स: 100 प्रति पृष्ठ (1K/2K) या 200 प्रति पृष्ठ (4K)
• उदाहरण:

  {
    "userInput": "Create a presentation about AI trends",
    "referenceImageUrl": "https://example.com/style-reference.jpg",
    "aspectRatio": "16:9",
    "resolution": "2K",
    "page": 5,
    "contentDetail": "standard",
    "mode": "async"
  }
  

---

slides_create_pdf_slides (POST /api/v1/slides/create-pdf-slides)

संदर्भ छवि के बिना पाठ सामग्री से कस्टम-डिज़ाइन की गई स्लाइड्स (Nano Banana) बनाएं।

• तर्क:
  • userInput (स्ट्रिंग, आवश्यक) — प्रस्तुति सामग्री
  • designStyle (स्ट्रिंग, वैकल्पिक) — दृश्य शैली का मुक्त-पाठ विवरण; डिफ़ॉल्ट स्टाइलिंग के लिए खाली छोड़ें
  • responseLanguage (स्ट्रिंग, वैकल्पिक, डिफ़ॉल्ट: Auto)
  • aspectRatio (स्ट्रिंग, वैकल्पिक, डिफ़ॉल्ट: 16:9) — मान्य मान: 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9
  • resolution (स्ट्रिंग, वैकल्पिक, डिफ़ॉल्ट: 2K) — 1K, 2K, 4K
  • page (संख्या, वैकल्पिक, डिफ़ॉल्ट: 0) — 0 = स्वतः-पहचान, 1–100 = सटीक पृष्ठ संख्या
  • contentDetail (स्ट्रिंग, वैकल्पिक, डिफ़ॉल्ट: standard) — concise या standard
  • mode (स्ट्रिंग, वैकल्पिक, डिफ़ॉल्ट: async) — async jobId लौटाता है; sync तुरंत downloadUrl लौटाता है
• क्रेडिट्स: 100 प्रति पृष्ठ (1K/2K) या 200 प्रति पृष्ठ (4K)
• उदाहरण:

  {
    "userInput": "Quarterly business review for Q3 2025",
    "designStyle": "modern, dark background, bold typography",
    "aspectRatio": "16:9",
    "resolution": "2K",
    "page": 8,
    "mode": "async"
  }
  

---

slides_generate_narration (POST /api/v1/slides/generate-narration)

पूर्ण Nano Banana कार्य में AI वॉइस नैरेशन जोड़ें (केवल slides_create_like_this या slides_create_pdf_slides; Fast PPT समर्थित नहीं)। हमेशा async — jobs_get के साथ परिणाम पोल करें।

• तर्क (एक वक्ता, mode: "single" डिफ़ॉल्ट):

  • jobId (स्ट्रिंग, आवश्यक) — पूर्ण Nano Banana कार्य का UUID
  • mode (स्ट्रिंग, वैकल्पिक, डिफ़ॉल्ट: single) — single या multi
  • speakerName (स्ट्रिंग, वैकल्पिक) — वक्ता का नाम
  • voice (स्ट्रिंग, वैकल्पिक) — 30 आवाज़ों में से एक (नीचे सूची देखें)
  • contentMode (स्ट्रिंग, वैकल्पिक, डिफ़ॉल्ट: standard) — concise या standard
  • includeIntro (बूलियन, वैकल्पिक, डिफ़ॉल्ट: true)

• तर्क (दो वक्ता, mode: "multi"):

  • jobId (स्ट्रिंग, आवश्यक)
  • mode (स्ट्रिंग, आवश्यक) — multi
  • speaker1Name (स्ट्रिंग, आवश्यक)
  • speaker2Name (स्ट्रिंग, आवश्यक)
  • speaker1Voice (स्ट्रिंग, वैकल्पिक) — वक्ता 1 के लिए आवाज़
  • speaker2Voice (स्ट्रिंग, वैकल्पिक) — वक्ता 2 के लिए आवाज़
  • contentMode (स्ट्रिंग, वैकल्पिक, डिफ़ॉल्ट: standard) — concise या standard

• समर्थित आवाज़ें (30): Puck, Aoede, Charon, Kore, Fenrir, Zephyr, Leda, Orus, Callirrhoe, Autonoe, Enceladus, Iapetus, Umbriel, Algieba, Despina, Erinome, Algenib, Rasalgethi, Laomedeia, Achernar, Alnilam, Schedar, Gacrux, Pulcherrima, Achird, Zubenelgenubi, Vindemiatrix, Sadachbia, Sadaltager, Sulafat

• क्रेडिट्स: 210 प्रति पृष्ठ (10 पाठ + 200 ऑडियो)

• उदाहरण:

  {
    "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "mode": "multi",
    "speaker1Name": "Alice",
    "speaker2Name": "Bob",
    "speaker1Voice": "Aoede",
    "speaker2Voice": "Puck",
    "contentMode": "standard"
  }
  

---

slides_download_slides_pages_voices (POST /api/v1/slides/download-slides-pages-voices)

स्लाइड पृष्ठों और ऑडियो नैरेशन को ZIP फ़ाइल के रूप में निर्यात करें। कार्य पूर्ण होना चाहिए और नैरेशन उत्पन्न होना चाहिए।

• तर्क:
  • jobId (स्ट्रिंग, आवश्यक) — पूर्ण नैरेशन वाले कार्य का UUID
• रिटर्न: downloadUrl (1 घंटे में समाप्त होता है), fileName, expiresIn (3600 सेकंड)
• ZIP सामग्री:

  pages/
    page_01.png, page_02.png, …
  voices/
    page_01.wav, page_02.wav, …
  transcript.txt
  

• क्रेडिट्स: मुफ़्त
• उदाहरण:

  { "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890" }
  

---

विशिष्ट वर्कफ़्लो

Fast PPT (थीम-आधारित PowerPoint):

1. themes_search → themeId प्राप्त करें
2. slides_generate (sync) → downloadUrl सीधे प्राप्त करें

Nano Banana (कस्टम-डिज़ाइन की गई स्लाइड्स):

1. slides_create_like_this या slides_create_pdf_slides (async) → jobId प्राप्त करें
2. jobs_get (हर 20 सेकंड पोल करें) → status: "success" होने पर downloadUrl प्राप्त करें

नैरेशन के साथ Nano Banana:

1. slides_create_like_this या slides_create_pdf_slides → jobId प्राप्त करें
2. jobs_get → स्लाइड्स पूर्ण होने की प्रतीक्षा करें
3. slides_generate_narration → नैरेशन jobId प्राप्त करें
4. jobs_get → नैरेशन पूर्ण होने की प्रतीक्षा करें
5. slides_download_slides_pages_voices → ZIP डाउनलोड लिंक प्राप्त करें

---

समस्या निवारण (Claude Desktop)

• यदि टूल्स Claude में दिखाई नहीं देते हैं, तो कॉन्फ़िग पथ निरपेक्ष है यह सत्यापित करें और ऐप को पुनः आरंभ करें।
• Claude MCP लॉग जांचें:

tail -n 50 -f ~/Library/Logs/Claude/mcp*.log

• stdio MCP सर्वर के लिए, stdout पर लॉगिंग से बचें; यह सर्वर केवल stderr पर त्रुटियाँ लॉग करता है।

संदर्भ

• MCP सर्वर बनाएं (आधिकारिक दस्तावेज़): https://modelcontextprotocol.io/docs/develop/build-server
• 2slides API दस्तावेज़: https://2slides.com/api
• 2slides: https://2slides.com
• 2slides टेम्पलेट्स: https://2slides.com/templates