QR Planet QR Code MCP Server

QR Planet QR Code MCP サーバー

Claude Code、ChatGPT Codex、OpenCode、Google Antigravity/Gemini、Mistral Vibe、その他のMCP互換クライアントをQR Planetに接続すると、AIエージェントが動的QRコードの作成、更新、デザイン、振り分け、分析を行えます。

このリポジトリには、QR Planet QR Code MCP サーバーのドキュメント、設定例、プロンプト例が含まれています。MCP サーバーのソースコードは含まれていません。サーバー自体はQR Planetが次の場所でホストし、運用しています。

https://api.qrplanet.com/mcp

これは何ですか？

QR Planet QR Code MCP サーバーは、Model Context Protocol（MCP）を介して、QR PlanetのプラットフォームをAIコーディングエージェントやアシスタントに公開します。

接続すると、MCP互換クライアントから、ダッシュボードを手動で操作することなく、チャットやエージェントのセッションからQR Planetのツールを直接呼び出せるようになります。

QR Planet MCP サーバーでできること

接続したツールを通じて、AIエージェントは次の操作を行えます。

• 動的QRコードの作成、更新、一覧表示、削除
• 色、ロゴ、形状、フレーム、テンプレートを使ったカスタムQRコードのデザイン
• 国、ジオフェンス、地理的地域、言語によるQRコードの振り分け
• フォルダー、タグ、デジタル名刺の管理
• GS1 Digital Linksと振り分けルールの作成、管理
• バウチャーの発行とクーポン統計の確認
• スキャン統計、リード、フォルダーレベルの分析データの取得
• その他、さまざまな操作…

現在のツールの概要については、以下のツールをご覧ください。

クイックスタート

1. APIキーを取得します。 qrplanet.com/premium/loginからQR Planetアカウントにログインし、API settingsに移動して、API v2セクションを開き、Show Secret API Keyをクリックします。

2. APIキーをコピーします。 QR Planetのキーは次のような形式です。

   secret:YOUR_DOMAIN:YOUR_KEY_ID:YOUR_SECRET
   

   読み取り専用の用途によっては、代わりにpublic:キーを使用できます。

3. MCP サーバーをクライアントに追加します。 すべてのクライアントは、同じリモートMCPエンドポイントに接続します。

   https://api.qrplanet.com/mcp
   

4. APIキーで認証します。 ほとんどのクライアントはHTTPヘッダーを使用します。

   Authorization: Bearer YOUR_QR_PLANET_API_KEY
   

5. プロンプトを試します。

   Create a dynamic QR Code that points to https://example.com and put it in a folder called Marketing.
   

MCPクライアントの対応状況が更新されると、正確なコマンドやフラグが変わる場合があります。このドキュメントの記述が古いように見える場合は、クライアントのドキュメントとQR Planetの公式MCPページ（qrplanet.com/qr-code-mcp）でご確認ください。

設定

{
  "mcpServers": {
    "qrplanet-mcp": {
      "type": "http",
      "url": "https://api.qrplanet.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_QR_PLANET_API_KEY"
      }
    }
  }
}

セットアップガイド

各ガイドでは、APIキーの取得方法、そのクライアント用にMCP サーバーを追加する方法、接続の確認方法を説明しています。

クライアント	ガイド
Claude Code	client-setup/claude-code.md
Claude Desktop / Cowork / claude.ai	client-setup/claude-apps.md
ChatGPT web connector	client-setup/chatgpt-web.md
ChatGPT Codex CLI / IDE extension	client-setup/chatgpt-codex.md
OpenCode	client-setup/opencode.md
Google Antigravity / Gemini	client-setup/google-gemini-antigravity.md
Mistral Vibe Code CLI	client-setup/mistral-vibe.md
Mistral Work / Studio connector	client-setup/mistral-work-studio.md

セットアップ手順の確認ができ次第、クライアントガイドを追加します。

プロンプト例

よくあるタスクですぐに使えるプロンプトは、prompts/にあります。

• 動的QRコードを作成する
• ブランドに合わせたQRコードのデザインを作成する
• 静的QRコードを作成する
• キャンペーンの遷移先URLを更新する
• 場所や言語に応じてQRコードの遷移先を振り分ける
• QRコードのタグを管理する
• QRコードのフォルダーを管理する
• スキャン統計を分析する
• QRコードのリードをエクスポートする
• デジタル名刺を作成する
• GS1 Digital Link QRコードを作成する
• クーポンバウチャーを発行する
• App Store QRコードの遷移先を更新する

ツール

QR Planet MCP Server では、現在、以下のツールを公開しています。利用できるツールは、QR Planet API キーの権限によって異なる場合があります。また、今後変更される可能性もあります。唯一の信頼できる情報源は、クライアントからのライブ MCP tools/list レスポンスです。

QR コード

• create_qr_code — 動的 QR コードを作成します
• list_qr_codes — QR コードの一覧を取得します
• get_qr_code — コードを指定して QR コードを取得します
• update_qr_code — ターゲット URL、タイトル、メタデータ、フォルダー、設定などの QR コードのフィールドを更新します
• delete_qr_code — QR コードを削除します
• get_qr_code_stats — QR コードのスキャン統計を取得します
• reset_qr_code_stats — QR コードのスキャン統計をリセットします
• get_qr_code_leads — QR コードのランディングページを通じて収集したリードを取得します

QR コードのタグ

• get_qr_code_tags — QR コードに割り当てられたタグを取得します
• update_qr_code_tags — QR コードのタグを置き換えるか、更新します
• delete_qr_code_tags — すべてのタグを QR コードから削除します

QR コードのターゲティング

• add_qr_code_country_target — 国別のターゲット URL を追加します
• delete_qr_code_country_target — 国別のターゲットを削除します
• add_qr_code_language_target — 言語別のターゲット URL を追加します
• delete_qr_code_language_target — 言語別のターゲットを削除します
• add_qr_code_geofence_target — ジオフェンス別のターゲット URL を追加します
• delete_qr_code_geofence_target — ジオフェンス別のターゲットを削除します
• add_qr_code_georegion_target — 地域別のターゲット URL を追加します
• delete_qr_code_georegion_target — 地域別のターゲットを削除します

QR コードのデザイン

• design_qr_code — 既存の動的 QR コードにカスタムデザインを適用します
• design_static_qr_code — 静的コンテンツからデザイン済みの静的 QR コードを作成します
• create_designer_template — 再利用可能な QR コードデザイナーテンプレートを作成します
• get_designer_template — ID を指定してデザイナーテンプレートを取得します
• list_designer_templates — デザイナーテンプレートの一覧を取得します

App Store QR コード

• update_app_store_qr_code_targets — App Store QR コードのターゲット URL を更新します

デジタル名刺

• create_digital_business_card — デジタル名刺を作成します
• list_digital_business_cards — デジタル名刺の一覧を取得します
• get_digital_business_card — コードを指定してデジタル名刺を取得します
• update_digital_business_card — デジタル名刺のフィールドを更新します
• delete_digital_business_card — デジタル名刺を削除します
• upload_digital_business_card_image — デジタル名刺のプロフィール画像、ロゴ、または背景画像をアップロードします

フォルダー

• create_folder — フォルダーを作成します
• list_folders — フォルダーの一覧を取得します
• get_folder — ID を指定してフォルダーを取得します
• delete_folder — フォルダーを削除します
• get_folder_stats — フォルダーレベルのスキャン統計を取得します
• reset_folder_stats — フォルダーレベルのスキャン統計をリセットします

GS1 Digital Link

• create_gs1_digital_link — GS1 Digital Link の QR コードを作成します
• create_gs1_digital_link_rule — GS1 Digital Link の QR コードのルーティングルールを作成します
• list_gs1_digital_link_rules — GS1 Digital Link の QR コードのルール一覧を取得します
• delete_gs1_digital_link_rules — GS1 Digital Link の QR コードのすべてのルールを削除します

クーポンとバウチャー

• list_coupons — クーポンの一覧を取得します
• issue_coupon_voucher — クーポンのバウチャーを発行します
• get_coupon_issue_stats — クーポンの発行統計を取得します
• get_coupon_redemptions — クーポンの利用統計を取得します

API キーとセキュリティ

QR Planet API キーはパスワードと同様に扱ってください。

• リポジトリにコミットしないでください
• 共有チャットに貼り付けないでください
• 公開設定の例にハードコードしないでください
• 環境変数またはクライアントのシークレットストレージを使用してください
• 読み取りアクセスで十分な場合にのみ、public: キーを使用してください
• リソースの作成、更新、削除を行う処理には secret: キーを使用してください
• キーが漏えいした場合は、ただちにローテーションしてください

環境変数の例：

export QR_PLANET_API_KEY="secret:YOUR_DOMAIN:YOUR_KEY_ID:YOUR_SECRET"

トラブルシューティング

MCP クライアントが接続できない場合：

• サーバー URL が正確に https://api.qrplanet.com/mcp であることを確認してください
• クライアントでそのモードが正しい場合は、Authorization ヘッダーが Bearer で始まっていることを確認してください（セットアップガイドを参照）
• QR Planet API の設定で API キーが有効であることを確認してください
• クライアントがリモート MCP サーバーに対応していることを確認してください
• クライアントの MCP ツール検出コマンドを実行し、tools/list が QR Planet のツールを返すことを確認してください

認証に失敗する場合は、新しい API キーを生成し、クライアントの設定を更新してください。

公式ドキュメント

このリポジトリは、QR Planet の公式 MCP ドキュメントを補完するものです。

qrplanet.com/qr-code-mcp

ライセンス

このリポジトリは MIT License の下でライセンスされています。ライセンスの条件に従い、ドキュメント、設定例、プロンプト例を自由に使用、複製、変更、共有できます。