Issuebage MCP Server
resmidijital rozet verme platformu
Issuebage MCP ile neler yapabilirsiniz?
- API anahtarınızı doğrulayın — Asistanınızdan,
validate_keykullanarak IssueBadge kimlik bilgilerinizin çalışıp çalışmadığını kontrol etmesini isteyin. - Rozet şablonlarını listeleyin — Sertifika göndermeden önce doğru şablonu seçebilmeniz için kullanabileceğiniz rozet şablonlarını alın.
- Sertifika gönderin — Bir alıcıya adı ve e-posta adresiyle sertifika gönderin; herkese açık bir doğrulama URL'si döndürülür.
- QR kodlarını inceleyin — Dinamik QR kodlarını listeleyin, PNG görseliyle birlikte bir kod alın veya tarama geçmişini inceleyin.
- QR kodunu silin — Mevcut bir dinamik QR kodunu koduyla silin.
Dokümantasyon
IssueBadge MCP sunucusu
Herhangi bir yapay zekâ ajanından doğrulanabilir sertifikalar ve rozetler verin. Bu Model Context Protocol sunucusu, Cursor, Claude, VS Code ve diğer MCP istemcilerinin IssueBadge rozet şablonlarınızı listelemesine ve alıcıya adı ve e-posta adresiyle sertifika göndermesine olanak tanır.
Çalıştırmanın iki yolu:
| Uzak (önerilen) | Yerel (stdio) | |
|---|---|---|
| Uç nokta | https://issuebadge-mcp.issuebadge.workers.dev/mcp | npx issuebadge-mcp-server |
| Kimlik doğrulama | Authorization: Bearer <API key> başlığı | ISSUEBADGE_API_KEY ortam değişkeni |
| Araçlar | validate_key, get_all_badges, issue_badge, list_qr_codes, get_qr_code, get_qr_code_scans, delete_qr_code | aynı araçlar + create_badge |
| Depolama | yok, durumsuz | yok |
Bir IssueBadge API anahtarına ihtiyacınız var: app.issuebadge.com → Developer → API key (https://app.issuebadge.com/developer/index).
Kurulum
Cursor
Cursor Marketplace üzerinden IssueBadge'i yükleyin ve istendiğinde API anahtarınızı yapıştırın. Ya da Settings → MCP bölümünden elle ekleyin:
{
"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"
Bu depo aynı zamanda bir Claude Code eklentisidir (.claude-plugin/plugin.json) ve ajana listele → onayla → ver iş akışını öğreten bir issuebadge becerisi içerir. Eklentinin .mcp.json bileşeni anahtarı ISSUEBADGE_API_KEY ortam değişkeninden okur; bu nedenle Claude Code'u başlatmadan önce bu değişkeni dışa aktarın.
Claude Desktop / herhangi bir stdio istemcisi
{
"mcpServers": {
"issuebadge": {
"command": "npx",
"args": ["-y", "issuebadge-mcp-server"],
"env": { "ISSUEBADGE_API_KEY": "YOUR_ISSUEBADGE_API_KEY" }
}
}
}
VS Code (Copilot ajan modu)
.vscode/mcp.json:
{
"servers": {
"issuebadge": {
"type": "http",
"url": "https://issuebadge-mcp.issuebadge.workers.dev/mcp",
"headers": { "Authorization": "Bearer YOUR_ISSUEBADGE_API_KEY" }
}
}
}
Araçlar
| Araç | Girdi | Döndürülen |
|---|---|---|
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 (yalnızca stdio) | name, description, issuing_organization_name, idempotency_key, isteğe bağlı badge_logo_path, custom_fields, … | IssueBadge API yanıtı |
issue_badge, sertifikayı alıcıya e-postayla gönderir ve herkese açık bir doğrulama URL'si döndürür. Yeni bir idempotency_key ile yapılan her çağrı yeni bir sertifika verir (belirtmezseniz mcp-<uuid> olarak bir tane oluşturulur). API, daha önce kullanılmış bir anahtarı reddeder; bu nedenle başarısız bir çağrıdan sonra yeni bir anahtarla tekrar çağrı yapmadan önce sertifikanın verilip verilmediğini kontrol edin.
Yüklendikten sonra kullanılabilecek örnek istem: "Jane Doe'ya jane@example.com adresinden Course Completion sertifikasını ver."
Dinamik QR kodları
| Araç | Girdi | Döndürülen |
|---|---|---|
list_qr_codes | type?, limit? | { qr_codes: [...], total } |
get_qr_code | code | QR kodu + PNG görsel bloğu |
get_qr_code_scans | code, limit? | { code, scan_count, scans: [{ scanned_at, referer }], total } |
delete_qr_code | code | { deleted: true, code } |
Türler: url, vcard, paypal, wifi, email, phone, sms, maps, event, facebook, twitter, youtube, text, mecard. Kodlar IssueBadge panosunda oluşturulur ve hedefleri değiştirilir; görsel, bir IssueBadge yönlendirmesini (scan_url) kodlar. Böylece hedefi değişse bile basılı kod çalışmaya devam eder.
Örnek istem: "Menu adlı, https://example.com/menu adresini açan bir QR kodu oluştur ve bana göster."
ChatGPT ve OAuth
Uzak sunucu, API anahtarı gönderemeyen istemciler (ChatGPT uygulamaları, Claude bağlayıcıları) için OAuth 2.1'i de destekler: bearer içermeyen bir
istek 401 + WWW-Authenticate: Bearer resource_metadata=… alır; /.well-known/oauth-protected-resource
https://app.issuebadge.com adresini gösterir (PKCE S256, dinamik istemci kaydı) ve verilen erişim belirteci
tıpkı bir API anahtarı gibi iletilir. issue_badge, sertifika kartını görüntüleyen bir widget (ui://widget/certificate.html, MCP Apps / ChatGPT Apps SDK)
içerir. Bkz. CHATGPT.md.
Gizlilik ve güvenlik
- Uzak sunucu durumsuzdur. API anahtarınız her isteğin
Authorizationbaşlığından okunur,app.issuebadge.comadresine iletilir ve hiçbir zaman saklanmaz veya günlüğe kaydedilmez. Anahtar içermeyen istekler401alır. - İletişim kurulan tek sunucu
app.issuebadge.comadresidir. Sertifikayı oluşturmak için alıcının adı, e-posta adresi ve rozet kimliği buraya gönderilir. - Gizlilik politikası: https://issuebadge.com/h/policy · Kullanım koşulları: https://issuebadge.com/h/terms · Destek: https://issuebadge.com/h/contact
Uzak sunucuyu kendi sunucunuzda barındırın
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, { ok: true } döndürür. IssueBadge'i başka bir yerde çalıştırıyorsanız stdio sunucusu için ISSUEBADGE_BASE_URL değişkenini farklı bir API ana bilgisayarına yönlendirin.
Geliştirme
npm install
npm test # vitest: client, tools, worker (mocked IssueBadge API)
npm run build # tsc → dist/ (stdio bin)
npm run dev:worker
Dizin yapısı: src/issuebadge.ts (API istemcisi), src/tools.ts (her iki ana bilgisayarın paylaştığı araç kayıt defteri), src/stdio.ts (npm ikilisi), src/createBadge.ts (yalnızca stdio aracı), worker/index.ts (Cloudflare Worker), .cursor-plugin/ + mcp.json (Cursor eklentisi), .claude-plugin/ + .mcp.json (Claude Code eklentisi), skills/issuebadge/SKILL.md, server.json (MCP Registry).
Lisans
MIT