Issuebage MCP Server

chính thức

nền tảng cấp huy hiệu kỹ thuật số

Bạn có thể làm gì với Issuebage MCP?

  • Xác thực khóa API của bạn — Yêu cầu trợ lý kiểm tra xem thông tin đăng nhập IssueBadge của bạn có hoạt động không bằng cách sử dụng validate_key.
  • Liệt kê các mẫu huy hiệu — Truy xuất các mẫu huy hiệu hiện có của bạn để bạn có thể chọn mẫu phù hợp trước khi cấp phát.
  • Cấp chứng chỉ — Gửi chứng chỉ đến người nhận theo tên và email, trả về URL xác minh công khai.
  • Kiểm tra mã QR — Liệt kê các mã QR động, tải một mã kèm hình ảnh PNG của nó, hoặc xem lại lịch sử quét của mã đó.
  • Xóa mã QR — Xóa một mã QR động hiện có theo mã của nó.

Tài liệu

Máy chủ MCP IssueBadge

Phát hành chứng chỉ và huy hiệu có thể xác minh từ bất kỳ tác nhân AI nào. Máy chủ Model Context Protocol này cho phép Cursor, Claude, VS Code và các ứng dụng khách MCP khác liệt kê các mẫu huy hiệu IssueBadge của bạn và gửi chứng chỉ đến người nhận theo tên và email.

Có hai cách để chạy:

Từ xa (khuyến nghị)Cục bộ (stdio)
Điểm cuốihttps://issuebadge-mcp.issuebadge.workers.dev/mcpnpx issuebadge-mcp-server
Xác thựctiêu đề Authorization: Bearer <API key>biến môi trường ISSUEBADGE_API_KEY
Công cụvalidate_key, get_all_badges, issue_badge, list_qr_codes, get_qr_code, get_qr_code_scans, delete_qr_codetương tự + create_badge
Lưu trữkhông, không trạng tháikhông

Bạn cần khóa API IssueBadge: app.issuebadge.com → Developer → API key (https://app.issuebadge.com/developer/index).

Cài đặt

Cursor

Cài đặt IssueBadge từ Cursor Marketplace và dán khóa API của bạn khi được nhắc. Hoặc thêm thủ công trong 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"

Kho lưu trữ này cũng là một plugin Claude Code (.claude-plugin/plugin.json) và đi kèm một kỹ năng issuebadge dạy cho tác nhân quy trình liệt kê → xác nhận → phát hành. Tệp .mcp.json của plugin đọc khóa từ biến môi trường ISSUEBADGE_API_KEY, vì vậy hãy xuất biến này trước khi khởi động Claude Code.

Claude Desktop / bất kỳ ứng dụng khách stdio nào

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

VS Code (chế độ tác nhân Copilot)

.vscode/mcp.json:

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

Công cụ

Công cụĐầu vàoTrả về
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 (chỉ stdio)name, description, issuing_organization_name, idempotency_key, tùy chọn badge_logo_path, custom_fields, …Phản hồi API IssueBadge

issue_badge gửi chứng chỉ qua email đến người nhận và trả về URL xác minh công khai. Mỗi lần gọi với idempotency_key mới sẽ phát hành một chứng chỉ mới (một chứng chỉ được tạo dưới dạng mcp-<uuid> nếu bạn bỏ qua). API từ chối khóa được sử dụng lại, vì vậy sau một lần gọi thất bại, hãy kiểm tra xem chứng chỉ đã được phát hành chưa trước khi gọi lại với khóa mới.

Câu lệnh ví dụ sau khi cài đặt: "Issue the Course Completion certificate to Jane Doe, jane@example.com."

Mã QR động

Công cụĐầu vàoTrả về
list_qr_codestype?, limit?{ qr_codes: [...], total }
get_qr_codecodemã QR + khối hình ảnh PNG
get_qr_code_scanscode, limit?{ code, scan_count, scans: [{ scanned_at, referer }], total }
delete_qr_codecode{ deleted: true, code }

Các loại: url, vcard, paypal, wifi, email, phone, sms, maps, event, facebook, twitter, youtube, text, mecard. Mã được tạo và đổi đích trong bảng điều khiển IssueBadge; hình ảnh mã hóa một chuyển hướng IssueBadge (scan_url), vì vậy một mã đã in vẫn hoạt động khi đích của nó thay đổi.

Câu lệnh ví dụ: "Create a QR code named Menu that opens https://example.com/menu and show it to me."

ChatGPT và OAuth

Máy chủ từ xa cũng hỗ trợ OAuth 2.1 cho các máy chủ không thể gửi khóa API (ứng dụng ChatGPT, trình kết nối Claude): một yêu cầu không có bearer sẽ nhận 401 + WWW-Authenticate: Bearer resource_metadata=…, /.well-known/oauth-protected-resource trỏ đến https://app.issuebadge.com (PKCE S256, đăng ký ứng dụng khách động), và mã truy cập được cấp sẽ được chuyển tiếp giống hệt như khóa API. issue_badge mang một widget (ui://widget/certificate.html, MCP Apps / ChatGPT Apps SDK) hiển thị thẻ chứng chỉ. Xem CHATGPT.md.

Quyền riêng tư và bảo mật

  • Máy chủ từ xa không lưu trạng thái. Khóa API của bạn được đọc từ tiêu đề Authorization của mỗi yêu cầu, được chuyển tiếp đến app.issuebadge.com, và không bao giờ được lưu trữ hay ghi nhật ký. Yêu cầu không có khóa sẽ nhận 401.
  • Máy chủ duy nhất được liên hệ là app.issuebadge.com. Tên người nhận, email và id huy hiệu được gửi đến đó để tạo chứng chỉ.
  • Chính sách quyền riêng tư: https://issuebadge.com/h/policy · Điều khoản: https://issuebadge.com/h/terms · Hỗ trợ: https://issuebadge.com/h/contact

Tự lưu trữ máy chủ từ xa

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 trả về { ok: true }. Trỏ ISSUEBADGE_BASE_URL đến một máy chủ API khác cho máy chủ stdio nếu bạn chạy IssueBadge ở nơi khác.

Phát triển

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

Bố cục: src/issuebadge.ts (ứng dụng khách API), src/tools.ts (sổ đăng ký công cụ dùng chung cho cả hai máy chủ), src/stdio.ts (npm bin), src/createBadge.ts (công cụ chỉ stdio), 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).

Giấy phép

MIT