Issuebage MCP Server

resmi

dijital rozet verme platformu

Issuebage MCP ile neler yapabilirsiniz?

  • API anahtarınızı doğrulayın — Asistanınızdan, validate_key kullanarak 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ç noktahttps://issuebadge-mcp.issuebadge.workers.dev/mcpnpx issuebadge-mcp-server
Kimlik doğrulamaAuthorization: Bearer <API key> başlığıISSUEBADGE_API_KEY ortam değişkeni
Araçlarvalidate_key, get_all_badges, issue_badge, list_qr_codes, get_qr_code, get_qr_code_scans, delete_qr_codeaynı araçlar + create_badge
Depolamayok, durumsuzyok

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çGirdiDöndürülen
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 (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çGirdiDöndürülen
list_qr_codestype?, limit?{ qr_codes: [...], total }
get_qr_codecodeQR kodu + PNG görsel bloğu
get_qr_code_scanscode, limit?{ code, scan_count, scans: [{ scanned_at, referer }], total }
delete_qr_codecode{ 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 Authorization başlığından okunur, app.issuebadge.com adresine iletilir ve hiçbir zaman saklanmaz veya günlüğe kaydedilmez. Anahtar içermeyen istekler 401 alır.
  • İletişim kurulan tek sunucu app.issuebadge.com adresidir. 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