QRSalt

QRSalt MCP サーバー

AI アシスタントを QRSalt に接続すると、QR コードや短縮リンクを作成したり、リンク先を変更したり、スキャンされた回数を確認したり、送信した QR 画像を読み取ったりできます。

サーバーはリモートです。インストールや実行は不要です。アシスタントは Streamable HTTP 経由で次に接続します。

https://app.qrsalt.com/api/mcp

初めて接続すると、ブラウザーで QRSalt のページが開きます。そこでサインインし、ワークスペースを選択して、アシスタントに許可する操作にチェックを入れます。クライアントがサインインできない場合は、代わりに API キーを送信できます。

このリポジトリには、プラグインマニフェスト（plugin.json、mcp.json、および Cursor と Claude Code 用のコピー）と、公式 MCP Registry にサーバーを io.github.QRSalt/qrsalt-mcp として登録する server.json が含まれています。サーバーのコードはここにはありません。

依頼できること

• 「明日のオープンデー用の QR コードを作成して、画像を見せて。」
• 「このリンクを短縮して、Spring flyer と名付けて。」
• 「古いドメインを参照したままのコードはどれ？」
• 「テーブルテントのコードを新しいメニューにリンクして。」印刷済みのコードはそのままで、リンク先だけが変わります。
• 「先月、最も多くスキャンされたコードはどれ？」
• 「3 月まで展示会のバナーコードを一時停止して。」
• 画像を添付して「この QR には何が入ってる？」

13 個のツール

アシスタントに表示される内容は、サインイン時に許可した内容（またはキーで許可されている内容）とプランによって異なります。Free ワークスペースでは画像ツール 2 つを利用できます。その他の 11 個は Pro プランで利用できます。

画像（スコープ render、すべてのプラン）

ツール	機能
render_qr_code	テキストまたはリンクを QR 画像に変換します。何も保存されません。
read_qr_image	ファイルとして送信した QR 画像からテキストを読み取ります。URL を取得することはありません。

アカウントの読み取り（スコープ read）

ツール	機能
list_codes	QR コードと短縮リンクをスキャン数とともに、新しいものから順に一覧表示します。
get_code	1 つのコードに記録されたすべての情報を表示します。リンク先、短縮リンク、スキャン数、最終スキャン日時が含まれます。
list_folders	フォルダーと各フォルダー内のコード数を表示します。
get_scan_analytics	1 つのコードまたはワークスペース全体について、スキャン総数と日別の推移を表示します。
get_code_image	保存済みコードの画像を、色、形状、ロゴとともに表示します。

変更（スコープ write）

ツール	機能
create_code	リンク、テキスト、メールアドレス、電話番号、またはテキストメッセージ用の新しいコードを作成します。
update_code	動的コードのリンク先、名前、保存先、タグを変更したり、一時停止または再開したりします。
create_short_link	リンクを短縮します。クリック数を計測でき、後からリンク先を変更できます。
set_gs1_link	商品パッケージ用に、動的コードに GS1 Digital Link アドレスを設定します。

削除（スコープ delete、初期状態では許可されません）

ツール	機能
remove_gs1_link	コードの GS1 Digital Link アドレスを削除します。
delete_code	コードまたは短縮リンクを完全に削除します。

削除ツールはどちらも、確認のためにコードの正確な名前または短縮リンクの末尾部分が必要です。そのため、「削除して」のような曖昧な指示では何も削除されません。

インストール

Cursor

cursor.directory からプラグインをインストールするか、サーバーを .cursor/mcp.json（1 つのプロジェクト）または ~/.cursor/mcp.json（すべてのプロジェクト）に追加します。

{
  "mcpServers": {
    "qrsalt": {
      "url": "https://app.qrsalt.com/api/mcp"
    }
  }
}

「Settings」を開き、「MCP」を選択して接続します。Cursor に QRSalt のサインインページが表示されます。

Claude Code

claude mcp add --transport http qrsalt https://app.qrsalt.com/api/mcp

次に、Claude Code 内で /mcp を実行し、qrsalt を選択してサインインします。

または、プラグインとしてインストールします。

/plugin marketplace add QRSalt/qrsalt-mcp
/plugin install qrsalt@qrsalt

Claude アプリ（ウェブ版およびデスクトップ版）

1. 「Settings」を開き、「Connectors」を選択して、カスタムコネクターを追加します。
2. サーバー URL として https://app.qrsalt.com/api/mcp を貼り付けます。
3. OAuth のクライアント ID とシークレットは空欄のままにします。
4. 接続し、開いた QRSalt のページでサインインします。

VS Code

.vscode/mcp.json に以下を追加し、エントリーの上にある「Start」を押してサインインします。

{
  "servers": {
    "qrsalt": {
      "type": "http",
      "url": "https://app.qrsalt.com/api/mcp"
    }
  }
}

その他のクライアント

Streamable HTTP 経由で MCP と通信するクライアントなら、サーバー URL を使って接続できます。MCP サインインに対応したクライアントは、それ以外に必要な情報をすべて自動で見つけます。古いプロトコルリビジョン向けに構築されたクライアントも引き続き動作します。サーバーは、現在の 2026-07-28 に加え、2025-06-18、2025-03-26、2024-11-05 の initialize に応答します。

サインイン

クライアントが初めて接続すると、サーバーはサインインが必要であることと、手順を確認できる場所を知らせます。クライアントはブラウザーで QRSalt のページを開きます。そこで、次の操作を行います。

1. QRSalt にサインインします。
2. ワークスペースを選択します。
3. アシスタントに許可する操作にチェックを入れます。「削除」は自動でチェックされることはありません。

アシスタントを接続できるのは、ワークスペースのオーナーまたは管理者のみです。アシスタントは、接続した人として操作します。アクセスを停止するには、ダッシュボードの「API」から「接続済みアプリ」を開き、取り消してください。

クライアント開発者向け：検出は https://app.qrsalt.com/.well-known/oauth-protected-resource/api/mcp から始まります。認可サーバーは、PKCE（S256）を使用する OAuth 2.1、動的クライアント登録、クライアント ID メタデータドキュメントに対応しています。

スコープ

スコープ	サインインページの項目	許可される操作
render	画像をレンダリング	QR 画像の描画と読み取り。アカウントに情報が保存されたり、アカウントから情報が読み取られたりすることはありません。
read	読み取り	コード、リンク、フォルダーの一覧表示と、スキャン結果の読み取り。
write	作成と変更	コードとリンクの作成および変更。
delete	削除	コードの削除と GS1 アドレスの削除。チェックを入れない限り無効です。

代わりに API キーを使用する

クライアントがヘッダーを設定できてもサインインには対応していない場合は、QRSalt ダッシュボードの「API」からキーを作成し、すべてのリクエストに付けて送信します。

Authorization: Bearer qr_live_YOUR_KEY

Claude Code の場合：

claude mcp add --transport http qrsalt https://app.qrsalt.com/api/mcp --header "Authorization: Bearer qr_live_YOUR_KEY"

qr_live_YOUR_KEY を自分のキーに置き換えてください。アシスタント専用のキーを作成し、必要な権限だけにチェックを入れてください。そうすれば、ほかのものを停止することなくキーを取り消せます。コミットするファイルにはキーを記載しないでください。

このツールが行わないこと

• どのツールも、指定されたウェブアドレスを開くことはありません。
• デザイン、カスタムドメイン、チームメンバー、請求には一切触れません。
• すべての呼び出しは、接続したワークスペースに対して実行されます。別のワークスペースを指定できるツールはありません。

リンク

• セットアップガイドとツールリファレンス：https://qrsalt.com/qr-code-mcp-server
• QRSalt：https://qrsalt.com
• MCP Registry のエントリー：io.github.QRSalt/qrsalt-mcp

ライセンス

MIT。LICENSE を参照してください。