TemplateFox

आधिकारिक

TemplateFox के साथ PDF दस्तावेज़ जनरेट करें

TemplateFox MCP के साथ आप क्या कर सकते हैं?

  • टेम्पलेट से PDF बनाएँ — अपने असिस्टेंट से डायनामिक डेटा, जैसे इनवॉइस या प्रमाणपत्र, के साथ टेम्पलेट से PDF बनाने को कहें।
  • असिंक्रोनस PDF जॉब कतार में डालें — बड़े या बैच जॉब के लिए बैकग्राउंड में जनरेशन का अनुरोध करें; पूरा होने पर वैकल्पिक वेबहुक कॉलबैक भी सेट कर सकते हैं।
  • टेम्पलेट और फ़ील्ड देखें — उपलब्ध टेम्पलेट की सूची देखें और जनरेट करने से पहले पता करें कि किसी खास टेम्पलेट में कौन-से फ़ील्ड अपेक्षित हैं।
  • PDF जॉब ट्रैक करें — किसी असिंक्रोनस जॉब की स्थिति देखें या हाल के PDF जॉब और उनकी स्थितियों की सूची पाएँ।
  • क्रेडिट और लेन-देन की जानकारी देखें — बचे हुए क्रेडिट, खाते की जानकारी या क्रेडिट लेन-देन के इतिहास के बारे में पूछें।

दस्तावेज़

MCP (Model Context Protocol) एक खुला मानक है, जो AI सहायकों को बाहरी टूल खोजने और उनका उपयोग करने देता है। TemplateFox MCP सर्वर आपके AI सहायक को PDF बनाने, टेम्पलेट प्रबंधित करने और क्रेडिट जाँचने के लिए प्राकृतिक भाषा से 8 टूल देता है।

आवश्यकताएँ

  1. आपकी मशीन पर Node.js 18+ इंस्टॉल होना चाहिए (npx के लिए)
  2. एक TemplateFox API key — इसे अपने Dashboard से प्राप्त करें (इसकी शुरुआत sk_ से होती है)

इंस्टॉलेशन

Claude Desktop

अपने Claude Desktop कॉन्फ़िगरेशन में जोड़ें (macOS पर ~/Library/Application Support/Claude/claude_desktop_config.json, Windows पर %APPDATA%\Claude\claude_desktop_config.json):

{
  "mcpServers": {
    "templatefox": {
      "command": "npx",
      "args": ["-y", "@templatefox/mcp-server"],
      "env": {
        "TEMPLATEFOX_API_KEY": "sk_your_api_key_here"
      }
    }
  }
}

फ़ाइल सेव करने के बाद Claude Desktop को रीस्टार्ट करें।

Claude Code

claude mcp add templatefox -- npx -y @templatefox/mcp-server

फिर अपने shell में TEMPLATEFOX_API_KEY environment variable सेट करें:

export TEMPLATEFOX_API_KEY="sk_your_api_key_here"

Cursor / Windsurf

अपने MCP सर्वर कॉन्फ़िगरेशन में वही npx कमांड इस्तेमाल करें:

npx -y @templatefox/mcp-server

environment variables में TEMPLATEFOX_API_KEY सेट करें।

Global install (वैकल्पिक)

npm install -g @templatefox/mcp-server

फिर कमांड के रूप में npx की जगह templatefox-mcp-server इस्तेमाल करें।

सेटअप की पुष्टि करें

इंस्टॉलेशन के बाद अपने AI सहायक से पूछें:

“मेरे TemplateFox टेम्पलेट की सूची दिखाएँ”

अगर MCP सर्वर सही ढंग से कॉन्फ़िगर किया गया है, तो सहायक list_templates को कॉल करेगा और आपके टेम्पलेट की सूची लौटाएगा। अगर कोई त्रुटि दिखे, तो नीचे दिया गया समस्या निवारण अनुभाग देखें।

कॉन्फ़िगरेशन

Environment Variableआवश्यकविवरण
TEMPLATEFOX_API_KEYहाँआपकी API key (इसकी शुरुआत sk_ से होती है)। इसे अपने Dashboard से प्राप्त करें
TEMPLATEFOX_BASE_URLनहींAPI base URL को ओवरराइड करें (डिफ़ॉल्ट: https://api.templatefox.com)

उपलब्ध टूल

MCP सर्वर 8 टूल उपलब्ध कराता है, जिन्हें आपका AI सहायक कॉल कर सकता है:

generate_pdf

डायनामिक डेटा के साथ टेम्पलेट से PDF बनाएँ। हर PDF के लिए 1 क्रेडिट लगता है।

आप क्या पूछ सकते हैं:

“मेरे Invoice टेम्पलेट का इस्तेमाल करके John Doe के लिए $250 कुल राशि वाला इनवॉइस बनाएँ”

“Jane Smith के लिए Advanced React कोर्स का completion certificate बनाएँ”

generate_pdf_async

वैकल्पिक webhook callback के साथ async PDF जनरेशन को कतार में डालें। बड़े या बैच जॉब के लिए उपयोगी। हर PDF के लिए 1 क्रेडिट लगता है।

आप क्या पूछ सकते हैं:

“बैकग्राउंड में 10 प्रमाणपत्र बनाएँ और पूरा होने पर मुझे सूचित करें”

list_templates

अपने खाते में उपलब्ध सभी PDF टेम्पलेट खोजें।

आप क्या पूछ सकते हैं:

“मेरे पास कौन-कौन से टेम्पलेट हैं?”

“मेरे सभी PDF टेम्पलेट दिखाएँ”

get_template_fields

किसी खास टेम्पलेट के फ़ील्ड और वेरिएबल प्राप्त करें। PDF बनाने से पहले यह समझने के लिए उपयोगी है कि टेम्पलेट को कौन-सा डेटा चाहिए।

आप क्या पूछ सकते हैं:

“मेरे Invoice टेम्पलेट के लिए कौन-से फ़ील्ड चाहिए?”

get_pdf_job_status

किसी async PDF जनरेशन जॉब की स्थिति जाँचें।

आप क्या पूछ सकते हैं:

“क्या मेरा PDF जॉब पूरा हो गया?”

list_pdf_jobs

सभी async PDF जनरेशन जॉब और उनकी स्थितियों की सूची देखें।

आप क्या पूछ सकते हैं:

“मेरे हाल के PDF जॉब दिखाएँ”

get_account_info

बचे हुए क्रेडिट और खाते की जानकारी देखें।

आप क्या पूछ सकते हैं:

“मेरे कितने क्रेडिट बचे हैं?”

list_transactions

क्रेडिट लेन-देन का इतिहास देखें।

आप क्या पूछ सकते हैं:

“इस महीने का मेरा क्रेडिट उपयोग दिखाएँ”

उपयोग के उदाहरण

एक दस्तावेज़ बनाएँ

अपने AI सहायक से खास डेटा के साथ एक PDF बनाने को कहें। सहायक टेम्पलेट खोजता है, आवश्यक फ़ील्ड जाँचता है और एक ही प्रक्रिया में PDF बनाता है:

“ऑर्डर #1234 के लिए पैकिंग स्लिप बनाएँ: ग्राहक John Doe, 3x Widget Blue और 1x Gadget Pro”

बनाने से पहले टेम्पलेट देखें

पहले अपने टेम्पलेट के बारे में पूछें, फिर उपलब्ध विकल्प जानने के बाद दस्तावेज़ बनाएँ:

“मेरे टेम्पलेट की सूची दिखाएँ, फिर Receipt टेम्पलेट के फ़ील्ड दिखाएँ”

खाते की स्थिति जाँचें

अपने AI सहायक को छोड़े बिना अपने उपयोग पर नज़र रखें:

“मेरे कितने क्रेडिट बचे हैं? मेरे हाल के लेन-देन दिखाएँ”

Remote server (जल्द आ रहा है)

https://api.templatefox.com/mcp पर होस्ट किया गया HTTP MCP endpoint जल्द आ रहा है। इससे आप स्थानीय रूप से कुछ भी इंस्टॉल किए बिना कनेक्ट कर सकेंगे — बस अपने MCP client को URL पर निर्देशित करें।

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

“MCP server not found” या कनेक्शन संबंधी त्रुटियाँ

  • सुनिश्चित करें कि Node.js 18+ इंस्टॉल है: node --version चलाएँ
  • जाँचें कि npx कमांड काम करती है: npx -y @templatefox/mcp-server --help चलाएँ
  • कॉन्फ़िगरेशन अपडेट करने के बाद अपने AI सहायक को रीस्टार्ट करें

“Invalid API key” या प्रमाणीकरण संबंधी त्रुटियाँ

  • पुष्टि करें कि आपकी API key की शुरुआत sk_ से होती है और उसकी समय-सीमा समाप्त नहीं हुई है
  • अपने Dashboard में key जाँचें
  • सुनिश्चित करें कि TEMPLATEFOX_API_KEY सही environment में सेट है (सिर्फ़ आपके shell में नहीं, बल्कि MCP सर्वर कॉन्फ़िगरेशन में भी)

टूल दिखाई नहीं दे रहे

  • कुछ client MCP टूल की सूची कैश करते हैं — client को रीस्टार्ट करें
  • client-स्तर की समस्या की संभावना को हटाने के लिए जाँचें कि दूसरे MCP सर्वर काम कर रहे हैं या नहीं

अगले चरण