Issuebage MCP Server
официальныйплатформа для выдачи цифровых значков
Что можно делать с Issuebage MCP?
- Проверьте свой API-ключ — Попросите ассистента проверить, что ваши учётные данные IssueBadge работают, с помощью
validate_key. - Просмотрите шаблоны бейджей — Получите список доступных шаблонов бейджей, чтобы выбрать подходящий перед выпуском.
- Выпустите сертификат — Отправьте сертификат получателю по имени и электронной почте, получив публичный URL для проверки.
- Изучите QR-коды — Просмотрите список динамических QR-кодов, получите один из них вместе с PNG-изображением или ознакомьтесь с историей его сканирований.
- Удалите QR-код — Удалите существующий динамический QR-код по его коду.
Документация
MCP-сервер IssueBadge
Выпускайте проверяемые сертификаты и значки из любого ИИ-агента. Этот сервер Model Context Protocol позволяет Cursor, Claude, VS Code и другим MCP-клиентам просматривать ваши шаблоны значков IssueBadge и отправлять сертификат получателю по имени и электронной почте.
Два способа запуска:
| Удалённый (рекомендуется) | Локальный (stdio) | |
|---|---|---|
| Конечная точка | 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 IssueBadge: app.issuebadge.com → Developer → API key (https://app.issuebadge.com/developer/index).
Установка
Cursor
Установите IssueBadge из Cursor Marketplace и вставьте свой ключ API, когда появится запрос. Или добавьте вручную в 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"
Этот репозиторий также является плагином Claude Code (.claude-plugin/plugin.json) и содержит навык issuebadge, который обучает агента рабочему процессу «список → подтверждение → выпуск». Файл .mcp.json плагина читает ключ из переменной окружения ISSUEBADGE_API_KEY, поэтому экспортируйте её перед запуском Claude Code.
Claude Desktop / любой stdio-клиент
{
"mcpServers": {
"issuebadge": {
"command": "npx",
"args": ["-y", "issuebadge-mcp-server"],
"env": { "ISSUEBADGE_API_KEY": "YOUR_ISSUEBADGE_API_KEY" }
}
}
}
VS Code (режим агента 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, … | ответ API IssueBadge |
issue_badge отправляет сертификат получателю по электронной почте и возвращает публичный URL для проверки. Каждый вызов с новым idempotency_key выпускает новый сертификат (если его не указать, он генерируется как mcp-<uuid>). API отклоняет повторно использованный ключ, поэтому после неудачного вызова проверьте, был ли сертификат выпущен, прежде чем вызывать снова с новым ключом.
Пример запроса после установки: «Выпусти сертификат Course Completion на имя Jane Doe, jane@example.com.»
Динамические QR-коды
| Инструмент | Вход | Возвращает |
|---|---|---|
list_qr_codes | type?, limit? | { qr_codes: [...], total } |
get_qr_code | code | QR-код + блок изображения 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-код с именем Menu, который открывает https://example.com/menu, и покажи его мне.»
ChatGPT и OAuth
Удалённый сервер также поддерживает OAuth 2.1 для хостов, которые не могут отправлять ключ API (приложения ChatGPT, коннекторы Claude): запрос
без bearer-токена получает 401 + WWW-Authenticate: Bearer resource_metadata=…, /.well-known/oauth-protected-resource
указывает на https://app.issuebadge.com (PKCE S256, динамическая регистрация клиента), а выданный токен доступа передаётся
точно так же, как ключ API. issue_badge содержит виджет (ui://widget/certificate.html, MCP Apps / ChatGPT Apps SDK),
который отображает карточку сертификата. См. CHATGPT.md.
Конфиденциальность и безопасность
- Удалённый сервер не сохраняет состояние. Ваш ключ API читается из заголовка
Authorizationкаждого запроса, передаётся вapp.issuebadge.comи никогда не сохраняется и не логируется. Запросы без ключа получают401. - Единственный хост, с которым устанавливается связь, —
app.issuebadge.com. Имя получателя, электронная почта и идентификатор значка отправляются туда для создания сертификата. - Политика конфиденциальности: 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_BASE_URL на другой хост API для stdio-сервера, если вы запускаете IssueBadge в другом месте.
Разработка
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), src/tools.ts (реестр инструментов, общий для обоих хостов), 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