Issuebage MCP Server
offizielldigitale Badge-Ausstellungsplattform
Was kann man mit Issuebage MCP machen?
- API-Schlüssel validieren — Bitten Sie Ihren Assistenten, mit
validate_keyzu prüfen, ob Ihre IssueBadge-Anmeldedaten funktionieren. - Badge-Vorlagen auflisten — Rufen Sie Ihre verfügbaren Badge-Vorlagen ab, damit Sie vor der Ausstellung die richtige auswählen können.
- Zertifikat ausstellen — Senden Sie ein Zertifikat per Name und E-Mail an einen Empfänger und erhalten Sie eine öffentliche Verifizierungs-URL.
- QR-Codes prüfen — Listen Sie dynamische QR-Codes auf, rufen Sie einen mit seinem PNG-Bild ab oder sehen Sie sich seinen Scan-Verlauf an.
- QR-Code löschen — Entfernen Sie einen vorhandenen dynamischen QR-Code anhand seines Codes.
Dokumentation
IssueBadge MCP-Server
Ausstellen verifizierbarer Zertifikate und Badges aus jedem KI-Agenten heraus. Dieser Model Context Protocol-Server ermöglicht es Cursor, Claude, VS Code und anderen MCP-Clients, deine IssueBadge-Badge-Vorlagen aufzulisten und ein Zertifikat per Name und E-Mail an einen Empfänger zu senden.
Zwei Möglichkeiten, ihn auszuführen:
| Remote (empfohlen) | Lokal (stdio) | |
|---|---|---|
| Endpunkt | https://issuebadge-mcp.issuebadge.workers.dev/mcp | npx issuebadge-mcp-server |
| Authentifizierung | Authorization: Bearer <API key>-Header | ISSUEBADGE_API_KEY-Umgebungsvariable |
| Tools | validate_key, get_all_badges, issue_badge, list_qr_codes, get_qr_code, get_qr_code_scans, delete_qr_code | dieselben + create_badge |
| Speicher | keiner, zustandslos | keiner |
Du benötigst einen IssueBadge-API-Schlüssel: app.issuebadge.com → Developer → API key (https://app.issuebadge.com/developer/index).
Installation
Cursor
Installiere IssueBadge aus dem Cursor Marketplace und füge deinen API-Schlüssel ein, wenn du dazu aufgefordert wirst. Oder füge ihn manuell unter Settings → MCP hinzu:
{
"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"
Dieses Repository ist außerdem ein Claude-Code-Plugin (.claude-plugin/plugin.json) und enthält einen issuebadge-Skill, der dem Agenten den Workflow Auflisten → Bestätigen → Ausstellen vermittelt. Die .mcp.json des Plugins liest den Schlüssel aus der Umgebungsvariable ISSUEBADGE_API_KEY, exportiere sie daher, bevor du Claude Code startest.
Claude Desktop / beliebiger stdio-Client
{
"mcpServers": {
"issuebadge": {
"command": "npx",
"args": ["-y", "issuebadge-mcp-server"],
"env": { "ISSUEBADGE_API_KEY": "YOUR_ISSUEBADGE_API_KEY" }
}
}
}
VS Code (Copilot-Agent-Modus)
.vscode/mcp.json:
{
"servers": {
"issuebadge": {
"type": "http",
"url": "https://issuebadge-mcp.issuebadge.workers.dev/mcp",
"headers": { "Authorization": "Bearer YOUR_ISSUEBADGE_API_KEY" }
}
}
}
Tools
| Tool | Eingabe | Gibt zurück |
|---|---|---|
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 (nur stdio) | name, description, issuing_organization_name, idempotency_key, optional badge_logo_path, custom_fields, … | IssueBadge-API-Antwort |
issue_badge sendet das Zertifikat per E-Mail an den Empfänger und gibt eine öffentliche Verifizierungs-URL zurück. Jeder Aufruf mit einem neuen idempotency_key stellt ein neues Zertifikat aus (eines wird als mcp-<uuid> generiert, wenn du es weglässt). Die API lehnt einen wiederverwendeten Schlüssel ab, prüfe daher nach einem fehlgeschlagenen Aufruf, ob das Zertifikat ausgestellt wurde, bevor du erneut mit einem neuen Schlüssel aufrufst.
Beispiel-Prompt nach der Installation: „Stelle das Zertifikat Course Completion für Jane Doe, jane@example.com, aus."
Dynamische QR-Codes
| Tool | Eingabe | Gibt zurück |
|---|---|---|
list_qr_codes | type?, limit? | { qr_codes: [...], total } |
get_qr_code | code | den QR-Code + PNG-Bildblock |
get_qr_code_scans | code, limit? | { code, scan_count, scans: [{ scanned_at, referer }], total } |
delete_qr_code | code | { deleted: true, code } |
Typen: url, vcard, paypal, wifi, email, phone, sms, maps, event, facebook, twitter, youtube, text, mecard. Codes werden im IssueBadge-Dashboard erstellt und neu ausgerichtet; das Bild kodiert eine IssueBadge-Weiterleitung (scan_url), sodass ein gedruckter Code weiterhin funktioniert, wenn sich sein Ziel ändert.
Beispiel-Prompt: „Erstelle einen QR-Code namens Menu, der https://example.com/menu öffnet, und zeige ihn mir."
ChatGPT und OAuth
Der Remote-Server spricht außerdem OAuth 2.1 für Hosts, die keinen API-Schlüssel senden können (ChatGPT-Apps, Claude-Connectoren): Eine
Anfrage ohne Bearer erhält 401 + WWW-Authenticate: Bearer resource_metadata=…, /.well-known/oauth-protected-resource
verweist auf https://app.issuebadge.com (PKCE S256, dynamische Client-Registrierung), und das ausgestellte Zugriffstoken wird
genau wie ein API-Schlüssel weitergeleitet. issue_badge enthält ein Widget (ui://widget/certificate.html, MCP Apps / ChatGPT Apps SDK),
das die Zertifikatskarte rendert. Siehe CHATGPT.md.
Datenschutz und Sicherheit
- Der Remote-Server ist zustandslos. Dein API-Schlüssel wird aus dem
Authorization-Header jeder Anfrage gelesen, anapp.issuebadge.comweitergeleitet und niemals gespeichert oder protokolliert. Anfragen ohne Schlüssel erhalten401. - Der einzige kontaktierte Host ist
app.issuebadge.com. Empfängername, E-Mail und die Badge-ID werden dorthin gesendet, um das Zertifikat zu erstellen. - Datenschutzerklärung: https://issuebadge.com/h/policy · Nutzungsbedingungen: https://issuebadge.com/h/terms · Support: https://issuebadge.com/h/contact
Remote-Server selbst hosten
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 gibt { ok: true } zurück. Richte ISSUEBADGE_BASE_URL auf einen anderen API-Host für den stdio-Server, wenn du IssueBadge anderswo betreibst.
Entwicklung
npm install
npm test # vitest: client, tools, worker (mocked IssueBadge API)
npm run build # tsc → dist/ (stdio bin)
npm run dev:worker
Struktur: src/issuebadge.ts (API-Client), src/tools.ts (Tool-Registry, gemeinsam von beiden Hosts genutzt), src/stdio.ts (npm-Bin), src/createBadge.ts (nur-stdio-Tool), worker/index.ts (Cloudflare Worker), .cursor-plugin/ + mcp.json (Cursor-Plugin), .claude-plugin/ + .mcp.json (Claude-Code-Plugin), skills/issuebadge/SKILL.md, server.json (MCP Registry).
Lizenz
MIT