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/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 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_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, …ответ API IssueBadge

issue_badge отправляет сертификат получателю по электронной почте и возвращает публичный URL для проверки. Каждый вызов с новым idempotency_key выпускает новый сертификат (если его не указать, он генерируется как mcp-<uuid>). API отклоняет повторно использованный ключ, поэтому после неудачного вызова проверьте, был ли сертификат выпущен, прежде чем вызывать снова с новым ключом.

Пример запроса после установки: «Выпусти сертификат Course Completion на имя Jane Doe, jane@example.com.»

Динамические QR-коды

ИнструментВходВозвращает
list_qr_codestype?, limit?{ qr_codes: [...], total }
get_qr_codecodeQR-код + блок изображения 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-код с именем 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