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アシスタントに以下のように話しかけてください：

• "Create a QR code for https://example.com" （https://example.com のQRコードを作成して）

• "Make a WiFi QR code for network MyWiFi with password guest123" （ネットワーク名MyWiFi、パスワードguest123のWiFi用QRコードを作成して）

• "Show me the analytics for my QR codes" （QRコードの分析結果を見せて）

• "List all my QR codes" （QRコードをすべてリストアップして）

• "Disable QR code abc123" （QRコード abc123 を無効にして）

利用可能なツール

QRコードの種類

動的（印刷後にURL変更可能）: URL、PDF、メニュー、App Store、SNS

静的（データが直接エンコードされる）: WiFi、vCard、メール、電話、SMS、テキスト、イベント

レート制限

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

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

すべてのレスポンスには、利用状況を管理するためのヘッダーが含まれています：

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

セキュリティ

• すべてのリクエストはAPIキー（Bearerトークン）で認証されます

• キーはダッシュボードから即座に失効可能です

• QRコードはアカウントごとにスコープされており、ユーザー間でのアクセスはできません

• 管理、請求、チーム管理操作は公開されていません

• GDPRおよびCCPAに準拠し、Cloudflareのグローバルエッジネットワークでホストされています

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 と互換性があります。