Issuebage MCP Server

officiel

plateforme d'émission de badges numériques

Que pouvez-vous faire avec Issuebage MCP ?

  • Validez votre clé API — Demandez à votre assistant de vérifier que vos identifiants IssueBadge fonctionnent à l'aide de validate_key.
  • Listez les modèles de badges — Récupérez vos modèles de badges disponibles afin de choisir le bon avant l'émission.
  • Émettez un certificat — Envoyez un certificat à un destinataire par nom et e-mail, en renvoyant une URL de vérification publique.
  • Inspectez les QR codes — Listez les QR codes dynamiques, récupérez-en un avec son image PNG, ou consultez son historique de scans.
  • Supprimez un QR code — Supprimez un QR code dynamique existant par son code.

Documentation

Serveur MCP IssueBadge

Émettez des certificats et des badges vérifiables depuis n'importe quel agent IA. Ce serveur Model Context Protocol permet à Cursor, Claude, VS Code et d'autres clients MCP de lister vos modèles de badges IssueBadge et d'envoyer un certificat à un destinataire par nom et e-mail.

Deux façons de l'exécuter :

Distant (recommandé)Local (stdio)
Point de terminaisonhttps://issuebadge-mcp.issuebadge.workers.dev/mcpnpx issuebadge-mcp-server
Authentificationen-tête Authorization: Bearer <API key>variable d'environnement ISSUEBADGE_API_KEY
Outilsvalidate_key, get_all_badges, issue_badge, list_qr_codes, get_qr_code, get_qr_code_scans, delete_qr_codeles mêmes + create_badge
Stockageaucun, sans étataucun

Vous avez besoin d'une clé API IssueBadge : app.issuebadge.com → Developer → API key (https://app.issuebadge.com/developer/index).

Installation

Cursor

Installez IssueBadge depuis le Cursor Marketplace et collez votre clé API lorsque vous y êtes invité. Ou ajoutez-le manuellement dans 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"

Ce dépôt est également un plugin Claude Code (.claude-plugin/plugin.json) et fournit une compétence issuebadge qui enseigne à l'agent le flux de travail lister → confirmer → émettre. Le fichier .mcp.json du plugin lit la clé depuis la variable d'environnement ISSUEBADGE_API_KEY, donc exportez-la avant de démarrer Claude Code.

Claude Desktop / tout client stdio

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

VS Code (mode agent Copilot)

.vscode/mcp.json :

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

Outils

OutilEntréeRetourne
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 uniquement)name, description, issuing_organization_name, idempotency_key, badge_logo_path facultatif, custom_fields, …Réponse de l'API IssueBadge

issue_badge envoie le certificat par e-mail au destinataire et renvoie une URL de vérification publique. Chaque appel avec une nouvelle idempotency_key émet un nouveau certificat (un est généré sous la forme mcp-<uuid> si vous l'omettez). L'API rejette une clé réutilisée, donc après un appel échoué, vérifiez si le certificat a été émis avant de rappeler avec une nouvelle clé.

Exemple d'invite une fois installé : « Émets le certificat Course Completion à Jane Doe, jane@example.com. »

Codes QR dynamiques

OutilEntréeRetourne
list_qr_codestype?, limit?{ qr_codes: [...], total }
get_qr_codecodele code QR + bloc d'image PNG
get_qr_code_scanscode, limit?{ code, scan_count, scans: [{ scanned_at, referer }], total }
delete_qr_codecode{ deleted: true, code }

Types : url, vcard, paypal, wifi, email, phone, sms, maps, event, facebook, twitter, youtube, text, mecard. Les codes sont créés et reciblés dans le tableau de bord IssueBadge ; l'image encode une redirection IssueBadge (scan_url), de sorte qu'un code imprimé continue de fonctionner lorsque sa destination change.

Exemple d'invite : « Crée un code QR nommé Menu qui ouvre https://example.com/menu et montre-le-moi. »

ChatGPT et OAuth

Le serveur distant prend également en charge OAuth 2.1 pour les hôtes qui ne peuvent pas envoyer de clé API (applications ChatGPT, connecteurs Claude) : une requête sans jeton bearer reçoit 401 + WWW-Authenticate: Bearer resource_metadata=…, /.well-known/oauth-protected-resource pointe vers https://app.issuebadge.com (PKCE S256, enregistrement dynamique du client), et le jeton d'accès émis est transmis exactement comme une clé API. issue_badge transporte un widget (ui://widget/certificate.html, MCP Apps / ChatGPT Apps SDK) qui affiche la carte du certificat. Voir CHATGPT.md.

Confidentialité et sécurité

  • Le serveur distant est sans état. Votre clé API est lue depuis l'en-tête Authorization de chaque requête, transmise à app.issuebadge.com, et jamais stockée ni journalisée. Les requêtes sans clé reçoivent 401.
  • Le seul hôte contacté est app.issuebadge.com. Le nom du destinataire, l'e-mail et l'identifiant du badge y sont envoyés pour créer le certificat.
  • Politique de confidentialité : https://issuebadge.com/h/policy · Conditions : https://issuebadge.com/h/terms · Assistance : https://issuebadge.com/h/contact

Auto-héberger le serveur distant

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 renvoie { ok: true }. Pointez ISSUEBADGE_BASE_URL vers un autre hôte d'API pour le serveur stdio si vous exécutez IssueBadge ailleurs.

Développement

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

Organisation : src/issuebadge.ts (client API), src/tools.ts (registre d'outils partagé par les deux hôtes), src/stdio.ts (bin npm), src/createBadge.ts (outil stdio uniquement), 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).

Licence

MIT