Issuebage MCP Server

आधिकारिक

डिजिटल बैज जारी करने का प्लेटफॉर्म

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

  • अपनी API कुंजी सत्यापित करें — अपने सहायक से कहें कि वह validate_key का उपयोग करके जाँच करे कि आपके IssueBadge क्रेडेंशियल काम कर रहे हैं।
  • बैज टेम्पलेट की सूची बनाएँ — अपने उपलब्ध बैज टेम्पलेट प्राप्त करें ताकि जारी करने से पहले आप सही टेम्पलेट चुन सकें।
  • प्रमाणपत्र जारी करें — नाम और ईमेल द्वारा प्राप्तकर्ता को प्रमाणपत्र भेजें, जो एक सार्वजनिक सत्यापन URL लौटाता है।
  • QR कोड जाँचें — डायनामिक QR कोड की सूची बनाएँ, किसी एक को उसकी PNG छवि के साथ प्राप्त करें, या उसका स्कैन इतिहास देखें।
  • QR कोड हटाएँ — किसी मौजूदा डायनामिक QR कोड को उसके कोड द्वारा हटाएँ।

दस्तावेज़

IssueBadge MCP सर्वर

किसी भी AI एजेंट से सत्यापन-योग्य प्रमाणपत्र और बैज जारी करें। यह Model Context Protocol सर्वर Cursor, Claude, VS Code और अन्य MCP क्लाइंट्स को आपके IssueBadge बैज टेम्पलेट्स की सूची देखने और प्राप्तकर्ता के नाम और ईमेल से उसे प्रमाणपत्र भेजने की सुविधा देता है।

इसे चलाने के दो तरीके हैं:

रिमोट (अनुशंसित)लोकल (stdio)
एंडपॉइंटhttps://issuebadge-mcp.issuebadge.workers.dev/mcpnpx issuebadge-mcp-server
प्रमाणीकरणAuthorization: Bearer <API key> हेडरISSUEBADGE_API_KEY env वेरिएबल
टूल्सvalidate_key, get_all_badges, issue_badge, list_qr_codes, get_qr_code, get_qr_code_scans, delete_qr_codeवही + create_badge
स्टोरेजकोई नहीं, स्टेटलेसकोई नहीं

आपको एक IssueBadge API कुंजी चाहिए: app.issuebadge.com → Developer → API key (https://app.issuebadge.com/developer/index)।

इंस्टॉल करें

Cursor

Cursor Marketplace से IssueBadge इंस्टॉल करें और संकेत मिलने पर अपनी API कुंजी पेस्ट करें। या Settings → MCP में इसे मैन्युअली जोड़ें:

{
  "mcpServers": {
    "issuebadge": {
      "type": "streamable-http",
      "url": "https://issuebadge-mcp.issuebadge.workers.dev/mcp",
      "headers": { "Authorization": "Bearer YOUR_ISSUEBADGE_API_KEY" }
    }
  }
}

Claude Code

claude mcp add --transport http issuebadge https://issuebadge-mcp.issuebadge.workers.dev/mcp \
  --header "Authorization: Bearer YOUR_ISSUEBADGE_API_KEY"

यह रेपो एक Claude Code प्लगइन (.claude-plugin/plugin.json) भी है और इसमें एक issuebadge स्किल शामिल है जो एजेंट को सूची → पुष्टि → जारी करें वर्कफ़्लो सिखाती है। प्लगइन का .mcp.json कुंजी को ISSUEBADGE_API_KEY एनवायरनमेंट वेरिएबल से पढ़ता है, इसलिए Claude Code शुरू करने से पहले इसे एक्सपोर्ट करें।

Claude Desktop / कोई भी stdio क्लाइंट

{
  "mcpServers": {
    "issuebadge": {
      "command": "npx",
      "args": ["-y", "issuebadge-mcp-server"],
      "env": { "ISSUEBADGE_API_KEY": "YOUR_ISSUEBADGE_API_KEY" }
    }
  }
}

VS Code (Copilot एजेंट मोड)

.vscode/mcp.json:

{
  "servers": {
    "issuebadge": {
      "type": "http",
      "url": "https://issuebadge-mcp.issuebadge.workers.dev/mcp",
      "headers": { "Authorization": "Bearer YOUR_ISSUEBADGE_API_KEY" }
    }
  }
}

टूल्स

टूलइनपुटरिटर्न करता है
validate_key–{ valid, message }
get_all_badgeslimit?{ badges: [{ id, name, description?, created_at? }] }
issue_badgebadge_id, name, email?, phone?, idempotency_key?, metadata?{ issue_id, certificate_url, idempotency_key }
create_badge (केवल stdio)name, description, issuing_organization_name, idempotency_key, वैकल्पिक badge_logo_path, custom_fields, …IssueBadge API प्रतिक्रिया

issue_badge प्रमाणपत्र को प्राप्तकर्ता को ईमेल करता है और एक सार्वजनिक सत्यापन URL लौटाता है। नई idempotency_key के साथ हर कॉल एक नया प्रमाणपत्र जारी करती है (यदि आप इसे छोड़ देते हैं तो एक mcp-<uuid> के रूप में जनरेट होता है)। API पुनः उपयोग की गई कुंजी को अस्वीकार करता है, इसलिए विफल कॉल के बाद नई कुंजी के साथ फिर से कॉल करने से पहले जाँच लें कि प्रमाणपत्र जारी हुआ था या नहीं।

इंस्टॉल होने के बाद उदाहरण प्रॉम्प्ट: "Course Completion प्रमाणपत्र Jane Doe, jane@example.com को जारी करें।"

डायनामिक QR कोड

टूलइनपुटरिटर्न करता है
list_qr_codestype?, limit?{ qr_codes: [...], total }
get_qr_codecodeQR कोड + PNG इमेज ब्लॉक
get_qr_code_scanscode, limit?{ code, scan_count, scans: [{ scanned_at, referer }], total }
delete_qr_codecode{ deleted: true, code }

प्रकार: url, vcard, paypal, wifi, email, phone, sms, maps, event, facebook, twitter, youtube, text, mecard। कोड IssueBadge डैशबोर्ड में बनाए और रीटार्गेट किए जाते हैं; इमेज एक IssueBadge रीडायरेक्ट (scan_url) एनकोड करती है, इसलिए प्रिंट किया गया कोड तब भी काम करता रहता है जब उसका गंतव्य बदल जाए।

उदाहरण प्रॉम्प्ट: "Menu नाम का एक QR कोड बनाएं जो https://example.com/menu खोलता है और मुझे दिखाएं।"

ChatGPT और OAuth

रिमोट सर्वर उन होस्ट्स के लिए OAuth 2.1 भी बोलता है जो API कुंजी नहीं भेज सकते (ChatGPT ऐप्स, Claude कनेक्टर्स): बिना बियरर वाला अनुरोध 401 + WWW-Authenticate: Bearer resource_metadata=… प्राप्त करता है, /.well-known/oauth-protected-resource https://app.issuebadge.com की ओर इंगित करता है (PKCE S256, डायनामिक क्लाइंट रजिस्ट्रेशन), और जारी किया गया एक्सेस टोकन ठीक वैसे ही फ़ॉरवर्ड किया जाता है जैसे API कुंजी। issue_badge में एक विजेट (ui://widget/certificate.html, MCP Apps / ChatGPT Apps SDK) होता है जो प्रमाणपत्र कार्ड रेंडर करता है। देखें CHATGPT.md।

गोपनीयता और सुरक्षा

  • रिमोट सर्वर स्टेटलेस है। आपकी API कुंजी प्रत्येक अनुरोध के Authorization हेडर से पढ़ी जाती है, app.issuebadge.com को फ़ॉरवर्ड की जाती है, और कभी संग्रहीत या लॉग नहीं की जाती। बिना कुंजी वाले अनुरोधों को 401 मिलता है।
  • संपर्क किया जाने वाला एकमात्र होस्ट app.issuebadge.com है। प्रमाणपत्र बनाने के लिए प्राप्तकर्ता का नाम, ईमेल और बैज आईडी वहाँ भेजे जाते हैं।
  • गोपनीयता नीति: https://issuebadge.com/h/policy · शर्तें: https://issuebadge.com/h/terms · सहायता: https://issuebadge.com/h/contact

रिमोट सर्वर को स्वयं होस्ट करें

git clone https://github.com/issuebadge/mcp-server && cd mcp-server
npm install
npm test
npx wrangler deploy --config worker/wrangler.toml   # needs a Cloudflare account

GET /health { ok: true } लौटाता है। यदि आप IssueBadge को कहीं और चलाते हैं तो stdio सर्वर के लिए ISSUEBADGE_BASE_URL को किसी भिन्न API होस्ट पर इंगित करें।

विकास

npm install
npm test          # vitest: client, tools, worker (mocked IssueBadge API)
npm run build     # tsc → dist/ (stdio bin)
npm run dev:worker

लेआउट: src/issuebadge.ts (API क्लाइंट), src/tools.ts (दोनों होस्ट्स द्वारा साझा टूल रजिस्ट्री), src/stdio.ts (npm bin), src/createBadge.ts (केवल stdio टूल), worker/index.ts (Cloudflare Worker), .cursor-plugin/ + mcp.json (Cursor प्लगइन), .claude-plugin/ + .mcp.json (Claude Code प्लगइन), skills/issuebadge/SKILL.md, server.json (MCP Registry)।

लाइसेंस

MIT