Issuebage MCP Server
ทางการแพลตฟอร์มออกใบประกาศดิจิทัล
คุณทำอะไรได้บ้างด้วย Issuebage MCP?
- ตรวจสอบคีย์ API ของคุณ — ขอให้ผู้ช่วยตรวจสอบว่าข้อมูลรับรอง IssueBadge ของคุณใช้งานได้ด้วย
validate_key - แสดงรายการเทมเพลตแบดจ์ — เรียกดูเทมเพลตแบดจ์ที่คุณมี เพื่อเลือกเทมเพลตที่เหมาะสมก่อนออกแบดจ์
- ออกใบรับรอง — ส่งใบรับรองให้ผู้รับโดยระบุชื่อและอีเมล พร้อมรับ URL สำหรับตรวจสอบสาธารณะ
- ตรวจสอบ QR code — แสดงรายการ QR code แบบไดนามิก ดึง QR code พร้อมรูปภาพ PNG หรือดูประวัติการสแกน
- ลบ QR code — ลบ QR code แบบไดนามิกที่มีอยู่โดยใช้รหัสของ QR codeนั้น
เอกสาร
IssueBadge MCP server
ออกใบรับรองและแบดจ์ที่ตรวจสอบยืนยันได้จาก AI agent ทุกตัว เซิร์ฟเวอร์ Model Context Protocol นี้ช่วยให้ Cursor, Claude, VS Code และ MCP client อื่น ๆ แสดงรายการเทมเพลตแบดจ์ IssueBadge ของคุณ และส่งใบรับรองให้ผู้รับโดยใช้ชื่อและอีเมลได้
วิธีใช้งานมีสองแบบ:
| ระยะไกล (แนะนำ) | ภายในเครื่อง (stdio) | |
|---|---|---|
| Endpoint | https://issuebadge-mcp.issuebadge.workers.dev/mcp | npx issuebadge-mcp-server |
| การยืนยันตัวตน | ส่วนหัว Authorization: Bearer <API key> | ตัวแปรสภาพแวดล้อม ISSUEBADGE_API_KEY |
| เครื่องมือ | validate_key, get_all_badges, issue_badge, list_qr_codes, get_qr_code, get_qr_code_scans, delete_qr_code | เหมือนกัน + create_badge |
| การจัดเก็บ | ไม่มี, ไม่มีสถานะ | ไม่มี |
คุณต้องมี API key ของ IssueBadge: app.issuebadge.com → Developer → API key (https://app.issuebadge.com/developer/index).
ติดตั้ง
Cursor
ติดตั้ง IssueBadge จาก Cursor Marketplace แล้ววาง API key เมื่อระบบแจ้ง หรือเพิ่มด้วยตนเองใน 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"
repo นี้ยังเป็นปลั๊กอิน Claude Code (.claude-plugin/plugin.json) และมาพร้อมกับสกิล issuebadge ที่สอน agent เกี่ยวกับเวิร์กโฟลว์ list → confirm → issue ส่วน .mcp.json ของปลั๊กอินจะอ่านคีย์จากตัวแปรสภาพแวดล้อม ISSUEBADGE_API_KEY ดังนั้นให้ export คีย์ก่อนเริ่ม Claude Code
Claude Desktop / stdio client ใดก็ได้
{
"mcpServers": {
"issuebadge": {
"command": "npx",
"args": ["-y", "issuebadge-mcp-server"],
"env": { "ISSUEBADGE_API_KEY": "YOUR_ISSUEBADGE_API_KEY" }
}
}
}
VS Code (โหมด agent ของ Copilot)
.vscode/mcp.json:
{
"servers": {
"issuebadge": {
"type": "http",
"url": "https://issuebadge-mcp.issuebadge.workers.dev/mcp",
"headers": { "Authorization": "Bearer YOUR_ISSUEBADGE_API_KEY" }
}
}
}
เครื่องมือ
| เครื่องมือ | อินพุต | ผลลัพธ์ |
|---|---|---|
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 เท่านั้น) | name, description, issuing_organization_name, idempotency_key, badge_logo_path (ไม่บังคับ), custom_fields, … | การตอบกลับจาก IssueBadge API |
issue_badge จะส่งอีเมลใบรับรองให้ผู้รับและส่งคืน URL สำหรับตรวจสอบยืนยันแบบสาธารณะ การเรียกแต่ละครั้งด้วย idempotency_key ใหม่จะออกใบรับรองใหม่ (หากไม่ระบุ ระบบจะสร้างค่าเป็น mcp-<uuid>) API จะปฏิเสธคีย์ที่ใช้ซ้ำ ดังนั้นหลังจากเรียกไม่สำเร็จ ให้ตรวจสอบก่อนว่าออกใบรับรองไปแล้วหรือไม่ ก่อนเรียกอีกครั้งด้วยคีย์ใหม่
ตัวอย่างพรอมป์ต์หลังติดตั้ง: "ออกใบรับรอง Course Completion ให้ Jane Doe, jane@example.com"
QR code แบบไดนามิก
| เครื่องมือ | อินพุต | ผลลัพธ์ |
|---|---|---|
list_qr_codes | type?, limit? | { qr_codes: [...], total } |
get_qr_code | code | QR code + บล็อกรูปภาพ PNG |
get_qr_code_scans | code, limit? | { code, scan_count, scans: [{ scanned_at, referer }], total } |
delete_qr_code | code | { deleted: true, code } |
ประเภท: url, vcard, paypal, wifi, email, phone, sms, maps, event, facebook, twitter, youtube, text, mecard สร้างและเปลี่ยนปลายทางของโค้ดได้ในแดชบอร์ด IssueBadge; รูปภาพจะเข้ารหัสการเปลี่ยนเส้นทางของ IssueBadge (scan_url) ดังนั้นโค้ดที่พิมพ์ออกมายังคงใช้งานได้เมื่อมีการเปลี่ยนปลายทาง
ตัวอย่างพรอมป์ต์: "สร้าง QR code ชื่อ Menu ที่เปิด https://example.com/menu แล้วแสดงให้ฉันดู"
ChatGPT และ OAuth
เซิร์ฟเวอร์ระยะไกลยังรองรับ OAuth 2.1 สำหรับโฮสต์ที่ส่ง API key ไม่ได้ (แอป ChatGPT, ตัวเชื่อมต่อ Claude): คำขอที่ไม่มี bearer จะได้รับ 401 + WWW-Authenticate: Bearer resource_metadata=…, /.well-known/oauth-protected-resource
ชี้ไปที่ https://app.issuebadge.com (PKCE S256, การลงทะเบียน client แบบไดนามิก) และ access token ที่ออกให้จะถูกส่งต่อ
เช่นเดียวกับ API key ทุกประการ issue_badge มี widget (ui://widget/certificate.html, MCP Apps / ChatGPT Apps SDK)
ที่แสดงการ์ดใบรับรอง ดู CHATGPT.md
ความเป็นส่วนตัวและความปลอดภัย
- เซิร์ฟเวอร์ระยะไกลไม่มีสถานะ ระบบจะอ่าน API key จากส่วนหัว
Authorizationของแต่ละคำขอ ส่งต่อไปยังapp.issuebadge.comและไม่จัดเก็บหรือบันทึกลง log คำขอที่ไม่มีคีย์จะได้รับ401 - โฮสต์เดียวที่มีการติดต่อคือ
app.issuebadge.comโดยจะส่งชื่อผู้รับ อีเมล และ badge id ไปที่นั่นเพื่อสร้างใบรับรอง - นโยบายความเป็นส่วนตัว: https://issuebadge.com/h/policy · ข้อกำหนด: https://issuebadge.com/h/terms · การสนับสนุน: https://issuebadge.com/h/contact
โฮสต์เซิร์ฟเวอร์ระยะไกลด้วยตนเอง
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 } หากคุณใช้งาน IssueBadge บน API host อื่น ให้ตั้งค่า ISSUEBADGE_BASE_URL เป็น host นั้นสำหรับเซิร์ฟเวอร์ stdio
การพัฒนา
npm install
npm test # vitest: client, tools, worker (mocked IssueBadge API)
npm run build # tsc → dist/ (stdio bin)
npm run dev:worker
โครงสร้าง: src/issuebadge.ts (API client), src/tools.ts (รีจิสทรีเครื่องมือที่ใช้ร่วมกันโดยทั้งสอง host), src/stdio.ts (npm bin), src/createBadge.ts (เครื่องมือสำหรับ stdio เท่านั้น), worker/index.ts (Cloudflare Worker), .cursor-plugin/ + mcp.json (ปลั๊กอิน Cursor), .claude-plugin/ + .mcp.json (ปลั๊กอิน Claude Code), skills/issuebadge/SKILL.md, server.json (MCP Registry)
ใบอนุญาต
MIT