Quality QR

Quality QR MCP サーバー

Claude、Cursor、および MCP 互換ツールなどの AI アシスタントを通じて、追跡可能な QR コードを作成・管理できます。

一般的な QR コード生成ツールとは異なり、Quality QR コードはアカウントに保存され、スキャンの追跡や分析ができるほか、再印刷せずにリンク先を変更できます。

エンドポイント： https://quality-qr.app/api/mcp

セットアップ

1. API キーを取得する

quality-qr.app に登録し、Dashboard > Settings > API Keys で API キーを生成します。

2. MCP クライアントを設定する

Smithery ユーザーの方へ： Smithery 経由でインストールすると、apiKey の入力を求められます。Smithery が Authorization ヘッダーを設定します。以下の設定は手動セットアップ用です。

Claude Desktop

Claude Desktop の設定ファイル（Mac の場合は ~/Library/Application Support/Claude/claude_desktop_config.json）に追加します：

{
  "mcpServers": {
    "quality-qr": {
      "url": "https://quality-qr.app/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Cursor

Cursor の MCP 設定に追加します：

{
  "mcpServers": {
    "quality-qr": {
      "url": "https://quality-qr.app/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Claude Code

claude mcp add quality-qr --transport http https://quality-qr.app/api/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

3. 使い始める

AI アシスタントに次のように依頼します：

• 「https://example.com の QR コードを作成して」
• 「ネットワーク名 MyWiFi、パスワード guest123 の WiFi QR コードを作成して」
• 「自分の QR コードの分析結果を見せて」
• 「自分の QR コードをすべて一覧表示して」
• 「QR コード abc123 を無効にして」

利用可能なツール

ツール	説明
quality_qr_create	追跡可能な QR コードを作成します。12 種類に対応：URL、PDF、メニュー、App Store、ソーシャル、WiFi、vCard、メール、電話、SMS、テキスト、イベント。インライン SVG を返します。
quality_qr_list	任意の種類フィルターとページネーションを指定して、QR コードを一覧表示します。
quality_qr_get	ID で QR コードの詳細を取得します。
quality_qr_update	リンク先 URL の更新（動的タイプ）、名前の変更、有効化／無効化を行います。
quality_qr_delete	QR コードを完全に削除します。プランの割り当て枠が解放されます。
quality_qr_analytics	スキャン分析：合計数、日別推移、デバイスの内訳、上位の国。

QR コードの種類

動的（印刷後に URL を変更可能）： URL、PDF、メニュー、App Store、ソーシャル

静的（データを直接エンコード）： WiFi、vCard、メール、電話、SMS、テキスト、イベント

レート制限

MCP ツールの呼び出しは API のレート制限の対象です。プロトコルメッセージ（initialize、tools/list）は無料です。

プラン	月間ツール呼び出し回数	分析履歴	料金
Free	100	7 日	無料
Pro	1,000	30 日	€10/mo
Business	10,000	1 年	€30/mo

レート制限レスポンスヘッダー

すべてのレスポンスには、利用状況の管理に役立つヘッダーが含まれています：

ヘッダー	説明
X-RateLimit-Limit	プランで月間に許可されるツール呼び出しの上限
X-RateLimit-Remaining	現在の請求期間に残っているツール呼び出し回数
X-RateLimit-Reset	制限がリセットされる UTC タイムスタンプ（ISO 8601）
Retry-After	再試行までの待機秒数（429 レスポンスにのみ含まれます）

429 Too Many Requests レスポンスを受け取った場合は、Retry-After で指定された秒数だけ待ってから再試行してください。

セキュリティ

• すべてのリクエストは API キー（Bearer トークン）で認証されます
• キーはダッシュボードからすぐに失効させることができます
• QR コードはアカウントに紐づいており、他のユーザーからアクセスされることはありません
• 管理者、請求、チーム管理の操作は公開されていません
• GDPR および CCPA に準拠し、Cloudflare のグローバルエッジネットワークでホストされています
• 脆弱性の報告については SECURITY.md、データの取り扱いについては PRIVACY.md をご覧ください

API キーの管理

API キーを使うと、QR コードと分析データに全面的にアクセスできます。パスワードと同様に取り扱ってください。

• 定期的にローテーションしてください。 Dashboard > Settings > API Keys で新しいキーを生成し、MCP クライアントの設定を更新してから、古いキーを失効させてください。複数の有効なキーを保持できるため、ダウンタイムなしでローテーションできます。
• 侵害されたキーは直ちに失効させてください。 失効はすぐに反映されるため、古いキーを使用した処理中のリクエストはすべて失敗します。
• 設定ファイルへのアクセスを制限してください。 MCP クライアントの設定にはキーが平文で保存されます。macOS/Linux では、自分だけが読み取れるようにしてください（例：chmod 600）。実際のキーを含む設定ファイルをバージョン管理にコミットしないでください。

リンク

• Quality QR
• エージェントのオンボーディング（SKILL.md） — AI エージェントが Quality QR を自律的に使用するための手順ガイド（ソース）
• MCP ドキュメント
• API ドキュメント
• 料金

プロトコル

これは、Streamable HTTP トランスポート（HTTP POST 上の JSON-RPC 2.0）を使用するリモート MCP サーバーです。ローカルへのインストールは不要です。MCP プロトコルバージョン 2025-03-26 と互換性があります。