Issuebage MCP Server

offiziell

digitale Badge-Ausstellungsplattform

Was kann man mit Issuebage MCP machen?

  • API-Schlüssel validieren — Bitten Sie Ihren Assistenten, mit validate_key zu 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)
Endpunkthttps://issuebadge-mcp.issuebadge.workers.dev/mcpnpx issuebadge-mcp-server
AuthentifizierungAuthorization: Bearer <API key>-HeaderISSUEBADGE_API_KEY-Umgebungsvariable
Toolsvalidate_key, get_all_badges, issue_badge, list_qr_codes, get_qr_code, get_qr_code_scans, delete_qr_codedieselben + create_badge
Speicherkeiner, zustandsloskeiner

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

ToolEingabeGibt zurück
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 (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

ToolEingabeGibt zurück
list_qr_codestype?, limit?{ qr_codes: [...], total }
get_qr_codecodeden QR-Code + PNG-Bildblock
get_qr_code_scanscode, limit?{ code, scan_count, scans: [{ scanned_at, referer }], total }
delete_qr_codecode{ 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, an app.issuebadge.com weitergeleitet und niemals gespeichert oder protokolliert. Anfragen ohne Schlüssel erhalten 401.
  • 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