QRX

オプション A：プラグイン（MCP サーバー、QRX スキル、コードカード）

/plugin marketplace add qrxcodes/qrx-mcp
/plugin install qrx@qrx

次に /mcp を実行し、qrx を選択して QRX にサインインします。このプラグインは qrx スキルも追加します。このスキルでは、Claude が適切なアートプロンプトを作成し、コードの生成を待ち、印刷用に準備する方法を学びます。

このプラグインは、完成したコードをトランスクリプトの QRX ツール呼び出しの下にも表示します。画像、読み取り先の短縮リンク、QRX ページへのリンクが表示され、コードを描画中は進行状況を示す行も表示されます。これは mod なので、ターミナル（Claude Code 2.1.287 以降）とデスクトップアプリの「Code」タブに描画され、画像は curl で取得されます。kitty グラフィックスに対応したターミナル（kitty、Ghostty）では画像全体が表示されます。それ以外のターミナルでは色付きの文字セルで表示され、リンクから高画質の画像を開けます。

オプション B：MCP サーバーのみ

claude mcp add --transport http qrx https://qrx.codes/mcp --scope user

次に /mcp を実行し、qrx を選択してサインインします。または、プロジェクトの .mcp.json に設定をコミットすれば、チーム全体で利用できます（各自が自分のアカウントにサインインします）。

{
  "mcpServers": {
    "qrx": {
      "type": "http",
      "url": "https://qrx.codes/mcp"
    }
  }
}

代わりに API キーを使用する場合（たとえば claude -p や CI で使用する場合）：

claude mcp add --transport http qrx https://qrx.codes/mcp \
  --header "Authorization: Bearer $QRX_API_KEY" --scope user

Authorization ヘッダーを設定するとサインインの代わりになります。サインインする場合は、このヘッダーを削除してください。

Claude Desktop は claude.ai と同じコネクター設定を使用します。リモートサーバーの場合、claude_desktop_config.json は編集しません。

1. Customize → Connectors を開き、+ Add、次に Add custom connector を選択します。 Team プランと Enterprise プランでは、まずオーナーが Organization settings → Connectors で追加し、その後、各メンバーが Connect を選択します。
2. 名前：QRX。URL：https://qrx.codes/mcp。
3. 認証：Sign in now を選択し、Claude に求められたら QRX にサインインします。
4. 保存したら、チャットのコネクターメニューから QRX を有効にします。

代わりに API キーを使用する場合は、No sign-in を選び、Request headers の下に Authorization と値 Bearer qrx_live_… を追加します（組織でリクエストヘッダーが利用できる場合）。保存後に認証方法は変更できません。変更するには、コネクターを削除して追加し直してください。

Claude の無料プランでは、カスタムコネクターを 1 つ追加できます。

1. ウェブで chatgpt.com/plugins を開き、+、次に Add custom MCP server を選択します。
2. 名前：QRX。サーバー URL：https://qrx.codes/mcp。
3. 認証：OAuth。リスクに関する警告に同意し、Create as a plugin を選択します。
4. ChatGPT に求められたら QRX にサインインします。

ChatGPT のカスタム MCP サーバーでは API キーを使用できません。Business プランと Enterprise プランでは、ワークスペース管理者がカスタム MCP サーバーを制限できます。

上の Install in Cursor ボタンを使用するか、次の設定を ~/.cursor/mcp.json（すべてのプロジェクト）または .cursor/mcp.json（1 つのプロジェクト）に追加します。

{
  "mcpServers": {
    "qrx": {
      "url": "https://qrx.codes/mcp"
    }
  }
}

接続時に Cursor がブラウザーを開き、QRX へのサインインを求めます。

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

{
  "mcpServers": {
    "qrx": {
      "url": "https://qrx.codes/mcp",
      "headers": { "Authorization": "Bearer ${env:QRX_API_KEY}" }
    }
  }
}

上の Install in VS Code ボタンを使用するか、次の設定を .vscode/mcp.json に追加します。

{
  "servers": {
    "qrx": {
      "type": "http",
      "url": "https://qrx.codes/mcp"
    }
  }
}

ターミナルから：

code --add-mcp '{"name":"qrx","type":"http","url":"https://qrx.codes/mcp"}'

接続時に VS Code がブラウザーを開き、QRX へのサインインを求めます。

代わりに API キーを使用する場合（VS Code がキーの入力を求め、安全に保存します）：

{
  "inputs": [
    {
      "type": "promptString",
      "id": "qrx-api-key",
      "description": "QRX API key (starts with qrx_)",
      "password": true
    }
  ],
  "servers": {
    "qrx": {
      "type": "http",
      "url": "https://qrx.codes/mcp",
      "headers": { "Authorization": "Bearer ${input:qrx-api-key}" }
    }
  }
}

mcp_config.json を編集します（macOS/Linux の場合は ~/.config/devin/mcp_config.json、Windows の場合は %APPDATA%\devin\mcp_config.json。以前の Windsurf インストールでは ~/.codeium/windsurf/mcp_config.json を使用します）。

{
  "mcpServers": {
    "qrx": {
      "serverUrl": "https://qrx.codes/mcp"
    }
  }
}

キーは url ではなく serverUrl であることに注意してください。接続時に Windsurf が QRX へのサインインを求めます。代わりに API キーを使用する場合は、"headers": { "Authorization": "Bearer ${env:QRX_API_KEY}" } を追加します。

MCP Servers → Configure MCP Servers を開き、cline_mcp_settings.json に次の設定を追加します。

{
  "mcpServers": {
    "qrx": {
      "type": "streamableHttp",
      "url": "https://qrx.codes/mcp",
      "disabled": false,
      "autoApprove": ["list_styles", "get_qr_code", "list_qr_codes", "get_account", "get_profile"]
    }
  }
}

settings.json に追加します。

{
  "context_servers": {
    "qrx": {
      "url": "https://qrx.codes/mcp"
    }
  }
}

Zed は接続時に QRX へのサインインを求めます。代わりに API キーを使う場合は、"headers": { "Authorization": "Bearer qrx_live_…" } を追加すると、Zed はサインインをスキップします。

goose configure → Add Extension → Remote Extension (Streamable HTTP) を実行し、https://qrx.codes/mcp を入力します。または、config.yaml（macOS/Linux の場合は ~/.config/goose/config.yaml、Windows の場合は %APPDATA%\Block\goose\config\config.yaml）を編集します。

extensions:
  qrx:
    name: qrx
    type: streamable_http
    enabled: true
    uri: https://qrx.codes/mcp
    timeout: 300

Goose は接続時にブラウザーを開き、QRX へのサインインを求めます。代わりに API キーを使う場合は、ヘッダー Authorization: Bearer qrx_live_…（config.yaml の headers:）を追加します。

codex mcp add qrx --url https://qrx.codes/mcp

Codex は QRX のサインインを検出し、ブラウザーを開きます。後で再度サインインするには、codex mcp login qrx を実行します。~/.codex/config.toml のエントリーは次のとおりです。

[mcp_servers.qrx]
url = "https://qrx.codes/mcp"

代わりに API キーを使う場合は、そのエントリーに bearer_token_env_var = "QRX_API_KEY" を追加します。

gemini mcp add --transport http -s user qrx https://qrx.codes/mcp

Gemini CLI は接続時にブラウザーを開き、QRX へのサインインを求めます。後で再度サインインするには、/mcp auth qrx を実行します。または、~/.gemini/settings.json で設定します（Streamable HTTP を選択する httpUrl に注目してください）。

{
  "mcpServers": {
    "qrx": {
      "httpUrl": "https://qrx.codes/mcp"
    }
  }
}

代わりに API キーを使う場合：

gemini mcp add --transport http -s user --header "Authorization: Bearer $QRX_API_KEY" qrx https://qrx.codes/mcp

Program タブで Install → Edit mcp.json を選択し、次を追加します。

{
  "mcpServers": {
    "qrx": {
      "url": "https://qrx.codes/mcp"
    }
  }
}

LM Studio は接続時に QRX へのサインインを求めます。代わりに API キーを使う場合は、"headers": { "Authorization": "Bearer qrx_live_…" } を追加します。

skills/qrx フォルダーは Agent Skills 標準に準拠しているため、同じスキルを Codex、Gemini CLI、GitHub Copilot、Cursor、Goose などで使えます。複数エージェント対応のインストーラーでインストールします。

npx skills add qrxcodes/qrx-mcp

このスキルを使うには、QRX MCP サーバーに接続するか（上記のクライアントを参照）、REST API 用の QRX_API_KEY を設定してください。

gemini extensions install https://github.com/qrxcodes/qrx-mcp

Gemini CLI は接続時にブラウザーを開き、QRX へのサインインを求めます。後で再度サインインするには、/mcp auth qrx を実行します。

MCP 認証に対応するクライアントでは、https://qrx.codes/mcp を指定するだけで使えます。サインインするまではサーバーが 401 を返すため、接続時にサインインを求められます。それ以外の場合は、Streamable HTTP クライアントの接続先にこの URL を指定し、Authorization: Bearer qrx_…（または X-API-Key: qrx_…）を送信します。ローカルの stdio サーバーしか実行できないクライアントでは、API キーを使って同じサーバーに接続する @qrxcodes/mcp を利用できます。

{
  "mcpServers": {
    "qrx": {
      "command": "npx",
      "args": ["-y", "@qrxcodes/mcp"],
      "env": { "QRX_API_KEY": "qrx_live_…" }
    }
  }
}