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)
Endpointhttps://issuebadge-mcp.issuebadge.workers.dev/mcpnpx 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_badgeslimit?{ badges: [{ id, name, description?, created_at? }] }
issue_badgebadge_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_codestype?, limit?{ qr_codes: [...], total }
get_qr_codecodeQR code + บล็อกรูปภาพ PNG
get_qr_code_scanscode, limit?{ code, scan_count, scans: [{ scanned_at, referer }], total }
delete_qr_codecode{ 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