Issuebage MCP Server
chính thứcnề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ối | https://issuebadge-mcp.issuebadge.workers.dev/mcp | npx issuebadge-mcp-server |
| Xác thực | tiê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_code | tương tự + create_badge |
| Lưu trữ | không, không trạng thái | khô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ào | Trả về |
|---|---|---|
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 (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ào | Trả về |
|---|---|---|
list_qr_codes | type?, limit? | { qr_codes: [...], total } |
get_qr_code | code | mã QR + khối hình ảnh PNG |
get_qr_code_scans | code, limit? | { code, scan_count, scans: [{ scanned_at, referer }], total } |
delete_qr_code | code | { 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 đề
Authorizationcủa mỗi yêu cầu, được chuyển tiếp đếnapp.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ận401. - 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