Issuebage MCP Server

resmi

platform penerbitan lencana digital

Apa yang bisa Anda lakukan dengan Issuebage MCP?

  • Validasi kunci API Anda — Minta asisten Anda untuk memeriksa bahwa kredensial IssueBadge Anda berfungsi menggunakan validate_key.
  • Daftar templat badge — Ambil templat badge yang tersedia agar Anda dapat memilih yang tepat sebelum menerbitkan.
  • Terbitkan sertifikat — Kirim sertifikat kepada penerima berdasarkan nama dan email, yang mengembalikan URL verifikasi publik.
  • Periksa kode QR — Daftar kode QR dinamis, ambil satu beserta gambar PNG-nya, atau tinjau riwayat pemindaiannya.
  • Hapus kode QR — Hapus kode QR dinamis yang ada berdasarkan kodenya.

Dokumentasi

Server MCP IssueBadge

Terbitkan sertifikat dan badge yang dapat diverifikasi dari agen AI mana pun. Server Model Context Protocol ini memungkinkan Cursor, Claude, VS Code, dan klien MCP lainnya untuk menampilkan daftar templat badge IssueBadge Anda dan mengirim sertifikat kepada penerima berdasarkan nama dan email.

Ada dua cara menjalankannya:

Remote (disarankan)Lokal (stdio)
Endpointhttps://issuebadge-mcp.issuebadge.workers.dev/mcpnpx issuebadge-mcp-server
Autentikasiheader Authorization: Bearer <API key>variabel env ISSUEBADGE_API_KEY
Alatvalidate_key, get_all_badges, issue_badge, list_qr_codes, get_qr_code, get_qr_code_scans, delete_qr_codesama + create_badge
Penyimpanantidak ada, statelesstidak ada

Anda memerlukan kunci API IssueBadge: app.issuebadge.com → Developer → API key (https://app.issuebadge.com/developer/index).

Instalasi

Cursor

Instal IssueBadge dari Cursor Marketplace dan tempelkan kunci API Anda saat diminta. Atau tambahkan secara manual di 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"

Repositori ini juga merupakan plugin Claude Code (.claude-plugin/plugin.json) dan menyertakan skill issuebadge yang mengajarkan agen alur kerja daftar → konfirmasi → terbitkan. Berkas .mcp.json milik plugin membaca kunci dari variabel lingkungan ISSUEBADGE_API_KEY, jadi ekspor variabel tersebut sebelum memulai Claude Code.

Claude Desktop / klien stdio mana pun

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

VS Code (mode agen Copilot)

.vscode/mcp.json:

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

Alat

AlatInputMengembalikan
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 (hanya stdio)name, description, issuing_organization_name, idempotency_key, opsional badge_logo_path, custom_fields, …Respons API IssueBadge

issue_badge mengirimkan sertifikat melalui email kepada penerima dan mengembalikan URL verifikasi publik. Setiap panggilan dengan idempotency_key baru akan menerbitkan sertifikat baru (satu dibuat sebagai mcp-<uuid> jika Anda menghilangkannya). API menolak kunci yang digunakan ulang, jadi setelah panggilan gagal, periksa apakah sertifikat sudah diterbitkan sebelum memanggil lagi dengan kunci baru.

Contoh prompt setelah terpasang: "Terbitkan sertifikat Course Completion kepada Jane Doe, jane@example.com."

Kode QR dinamis

AlatInputMengembalikan
list_qr_codestype?, limit?{ qr_codes: [...], total }
get_qr_codecodekode QR + blok gambar PNG
get_qr_code_scanscode, limit?{ code, scan_count, scans: [{ scanned_at, referer }], total }
delete_qr_codecode{ deleted: true, code }

Jenis: url, vcard, paypal, wifi, email, phone, sms, maps, event, facebook, twitter, youtube, text, mecard. Kode dibuat dan diubah tujuannya di dasbor IssueBadge; gambar menyandikan pengalihan IssueBadge (scan_url), sehingga kode yang sudah dicetak tetap berfungsi saat tujuannya berubah.

Contoh prompt: "Buat kode QR bernama Menu yang membuka https://example.com/menu dan tampilkan kepada saya."

ChatGPT dan OAuth

Server remote juga mendukung OAuth 2.1 untuk host yang tidak dapat mengirim kunci API (aplikasi ChatGPT, konektor Claude): permintaan tanpa bearer akan menerima 401 + WWW-Authenticate: Bearer resource_metadata=…, /.well-known/oauth-protected-resource mengarah ke https://app.issuebadge.com (PKCE S256, pendaftaran klien dinamis), dan token akses yang diterbitkan diteruskan persis seperti kunci API. issue_badge membawa widget (ui://widget/certificate.html, MCP Apps / ChatGPT Apps SDK) yang merender kartu sertifikat. Lihat CHATGPT.md.

Privasi dan keamanan

  • Server remote bersifat stateless. Kunci API Anda dibaca dari header Authorization pada setiap permintaan, diteruskan ke app.issuebadge.com, dan tidak pernah disimpan atau dicatat. Permintaan tanpa kunci akan menerima 401.
  • Satu-satunya host yang dihubungi adalah app.issuebadge.com. Nama penerima, email, dan id badge dikirim ke sana untuk membuat sertifikat.
  • Kebijakan privasi: https://issuebadge.com/h/policy · Ketentuan: https://issuebadge.com/h/terms · Dukungan: https://issuebadge.com/h/contact

Hosting sendiri server remote

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 mengembalikan { ok: true }. Arahkan ISSUEBADGE_BASE_URL ke host API lain untuk server stdio jika Anda menjalankan IssueBadge di tempat lain.

Pengembangan

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

Tata letak: src/issuebadge.ts (klien API), src/tools.ts (registri alat yang digunakan bersama oleh kedua host), src/stdio.ts (bin npm), src/createBadge.ts (alat khusus stdio), worker/index.ts (Cloudflare Worker), .cursor-plugin/ + mcp.json (plugin Cursor), .claude-plugin/ + .mcp.json (plugin Claude Code), skills/issuebadge/SKILL.md, server.json (MCP Registry).

Lisensi

MIT