Qrblox

Qrblox MCP

Qrblox の Model Context Protocol サーバー — MCP 対応 AI エージェントなら誰でも、QR コード、オーディオコード、メニュー、ロイヤルティキャンペーンを生成、管理できます。

📚 完全なリファレンス： docs.qrblox.com/mcp.html 🌐 エンドポイント： https://app.qrblox.com/api/mcp 🔑 キーを発行： create.qrblox.com/settings/api-keys 🟢 キー不要のサンドボックス： POST https://app.qrblox.com/api/generate-qr-code

これは README のみを掲載した公開リポジトリです。MCP サーバー自体は上記のエンドポイントにデプロイされています。正式なドキュメントは docs.qrblox.com/mcp.html にあります。

---

これは何ですか？

qrblox-mcp は JSON-RPC 2.0 MCP サーバーです。Claude Desktop、 Cursor、Codex、または任意の MCP クライアントを https://app.qrblox.com/api/mcp に接続し、 sk-qrblox- キーを貼り付けると、アシスタントはすぐに QR コード（オーディオコード、メニュー、ロイヤルティキャンペーンも）を下書きし、加盟店ワークスペースのスキャン分析を確認できます。

MCP 経由で作成されたコードはすべて、iOS、Android、Canva、Web の各サービスから作成したコードとともに、呼び出し元の Qrblox アカウントに保存されます。

---

クイックスタート

1. 無料で試す（登録、OAuth 不要）

curl -X POST https://app.qrblox.com/api/generate-qr-code \
  -H 'content-type: application/json' \
  -d '{"url":"https://example.com"}'

戻り値：

{
  "ok": true,
  "code": {
    "codeId": "…",
    "destinationUrl": "https://example.com",
    "qrImage":    "data:image/png;base64,…",            // inline PNG
    "qrImageUrl": "https://storage.googleapis.com/…",    // hosted PNG
    "claimToken": "…",
    "expiresAt":  "…"
  },
  "upgrade": { "signup": "https://app.qrblox.com", "apiKeys": "https://create.qrblox.com/settings/api-keys" }
}

サンドボックスの制限：IP あたり 1 日 3 コード、コードの有効期限は 7 日間です。

2. API キーを発行する

create.qrblox.com にサインイン → Settings → API keys → New API key。キーは sk-qrblox-<64 hex chars> 形式で、一度だけ表示され、いつでも無効化できます。

3. Claude Desktop に接続する

// ~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "qrblox": {
      "url": "https://app.qrblox.com/api/mcp",
      "headers": {
        "Authorization": "Bearer sk-qrblox-..."
      }
    }
  }
}

Claude Desktop を再起動します。次に、"https://my-spring-menu.com の QR コードを生成して" と尋ねてください。

4. Cursor / Codex / curl を使う場合

同じ URL、同じ Authorization ヘッダーを使用します。

# tools/list — no auth required
curl -X POST https://app.qrblox.com/api/mcp \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

# tools/call — create a code on your account
curl -X POST https://app.qrblox.com/api/mcp \
  -H 'authorization: Bearer sk-qrblox-...' \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
       "params":{"name":"qrblox.qr.create",
                 "arguments":{"title":"Spring menu",
                              "destinationUrl":"https://qrblox.com/menu/spring"}}}'

---

ツール

すべてのツールは加盟店単位で、下書き優先です。エージェントが提案し、公開前に加盟店が承認します。

ツール	説明
qrblox.ping	接続可能かどうかと ID を確認します。
qrblox.merchant.get_profile	キーに関連付けられた加盟店ワークスペースを取得します。
qrblox.qr.list	最近の QR コードを一覧表示します。
qrblox.qr.create	QR コードの下書きを作成します（URL、メニュー、特典、キャンペーン）。
qrblox.audio.create	オーディオコード（準超音波ペイロード）の下書きを作成します。
qrblox.menu.create / .list / .add_item	加盟店のメニューを作成、拡張します。
qrblox.challenge.create	スキャン連続記録、スキャン回数ゲーム、来店期間、ロイヤルティキャンペーンを作成します。
qrblox.analytics.scan_summary	スキャン総数と日別の推移を取得します。

MCP を使用しない呼び出し元向けに、REST エンドポイントが 2 つあります。

エンドポイント	認証	備考
POST /api/generate-qr-code	なし	IP あたり 1 日 3 回、サンドボックス、有効期限 7 日間。
POST /api/bulk-qr-codes	Bearer sk-qrblox-...	1 回の呼び出しで最大 50 個の永続コードを作成し、加盟店ワークスペースに保存します。

---

ディスカバリー

URL	返される内容
GET https://app.qrblox.com/api/mcp	サーバー情報と全ツールの一覧（認証不要）。
POST https://app.qrblox.com/api/mcp tools/list	JSON-RPC によるツールの検出（認証不要）。
GET https://app.qrblox.com/api/generate-qr-code	公開マニフェスト：エンドポイントの形式、制限、アップグレード方法。

完全なリファレンスと接続例は docs.qrblox.com/mcp.html をご覧ください。

---

エラー

HTTP / JSON-RPC	意味
400 / -32600	JSON-RPC 2.0 リクエストが無効です。
401 / -32001	キーがないか、無効です。data.code = NO_AUTH / INVALID_API_KEY / INVALID_TOKEN。
403 / -32001	キーが無効化されています（data.code = REVOKED）。
200 / -32601	サポートされていないメソッドです。
200 / -32602	不明なツールです。
200 / -32000	ツールハンドラーで例外が発生しました — error.message を確認してください。

---

セキュリティモデル

• 加盟店単位 — すべての API キーは、1 つの加盟店 ワークスペースと 1 つのオーナー uid に紐付けられており、ツールが他の加盟店の データにアクセスすることはできません。
• キーのハッシュ化 — 平文での表示は一度限りです。Firestore には SHA-256 ハッシュと短いプレフィックスのみが保存されます。
• 監査対応 — すべてのツール呼び出しで、呼び出し元、 ツール名、ステータスを記録した監査エントリーが作成されます。引数と結果は保存されません。
• 下書き優先 — 作成ツールは下書きを生成します。公開、請求、 破壊的な変更は加盟店側で行います。

---

関連リンク

• 🌐 qrblox.com — マーケティングサイト
• 🖥️ app.qrblox.com — Web ダッシュボード
• 📱 iOS · Android · Canva
• 📚 Qrblox の全ドキュメント
• 🐙 Terahertz-Inc/qrblox-com — Qrblox の概要リポジトリ

---

ライセンス

© Qrblox / Terahertz Inc.