Issuebage MCP Server
resmiplatform 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) | |
|---|---|---|
| Endpoint | https://issuebadge-mcp.issuebadge.workers.dev/mcp | npx issuebadge-mcp-server |
| Autentikasi | header Authorization: Bearer <API key> | variabel env ISSUEBADGE_API_KEY |
| Alat | validate_key, get_all_badges, issue_badge, list_qr_codes, get_qr_code, get_qr_code_scans, delete_qr_code | sama + create_badge |
| Penyimpanan | tidak ada, stateless | tidak 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
| Alat | Input | Mengembalikan |
|---|---|---|
validate_key | – | { valid, message } |
get_all_badges | limit? | { badges: [{ id, name, description?, created_at? }] } |
issue_badge | badge_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
| Alat | Input | Mengembalikan |
|---|---|---|
list_qr_codes | type?, limit? | { qr_codes: [...], total } |
get_qr_code | code | kode QR + blok gambar PNG |
get_qr_code_scans | code, limit? | { code, scan_count, scans: [{ scanned_at, referer }], total } |
delete_qr_code | code | { 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
Authorizationpada setiap permintaan, diteruskan keapp.issuebadge.com, dan tidak pernah disimpan atau dicatat. Permintaan tanpa kunci akan menerima401. - 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