Issuebage MCP Server
officielplateforme 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 terminaison | https://issuebadge-mcp.issuebadge.workers.dev/mcp | npx issuebadge-mcp-server |
| Authentification | en-tête Authorization: Bearer <API key> | variable d'environnement ISSUEBADGE_API_KEY |
| Outils | validate_key, get_all_badges, issue_badge, list_qr_codes, get_qr_code, get_qr_code_scans, delete_qr_code | les mêmes + create_badge |
| Stockage | aucun, sans état | aucun |
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
| Outil | Entrée | Retourne |
|---|---|---|
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 (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
| Outil | Entrée | Retourne |
|---|---|---|
list_qr_codes | type?, limit? | { qr_codes: [...], total } |
get_qr_code | code | le code QR + bloc d'image PNG |
get_qr_code_scans | code, limit? | { code, scan_count, scans: [{ scanned_at, referer }], total } |
delete_qr_code | code | { 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
Authorizationde chaque requête, transmise àapp.issuebadge.com, et jamais stockée ni journalisée. Les requêtes sans clé reçoivent401. - 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