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. 打开 自定义 → 连接器，选择 + 添加，然后选择 添加自定义连接器。 对于 Team 和 Enterprise 计划，Owner 需先在 组织设置 → 连接器 中添加连接器，然后每位成员再选择 连接。
2. 名称：QRX。URL：https://qrx.codes/mcp。
3. 身份验证：选择 立即登录，然后在 Claude 提示时登录 QRX。
4. 保存，然后在聊天的连接器菜单中启用 QRX。

若改用 API 密钥，请选择 不登录，并在 请求标头 下添加 Authorization，值为 Bearer qrx_live_…（前提是你的组织允许使用请求标头）。保存后无法更改身份验证方式；请移除该连接器并重新添加。

Claude 免费计划最多可添加一个自定义连接器。

1. 在网页上打开 chatgpt.com/plugins，选择 +，然后选择 添加自定义 MCP 服务。
2. 名称：QRX。服务 URL：https://qrx.codes/mcp。
3. 身份验证：选择 OAuth。接受风险警告，然后选择 创建为插件。
4. 在 ChatGPT 提示时登录 QRX。

ChatGPT 的自定义 MCP 服务不支持 API 密钥。Business 和 Enterprise 计划的工作区管理员可以限制自定义 MCP 服务。

使用上方的 在 Cursor 中安装 按钮，或将以下内容添加到 ~/.cursor/mcp.json（所有项目）或 .cursor/mcp.json（单个项目）：

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

Cursor 连接时会打开浏览器，让你登录 QRX。

若改用 API 密钥：

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

使用上方的 在 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"
    }
  }
}

注意，键名是 serverUrl，不是 url。Windsurf 连接时会提示你登录 QRX。若改用 API 密钥，请添加 "headers": { "Authorization": "Bearer ${env:QRX_API_KEY}" }。

打开 MCP 服务 → 配置 MCP 服务，并将以下内容添加到 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"]
    }
  }
}

Cline 连接时会要求你登录 QRX。在 Cline CLI 中，运行 cline mcp，选择 qrx 和 Authorize OAuth。如果改用 API 密钥，请添加 "headers": { "Authorization": "Bearer qrx_live_…" }。

添加到 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 中配置（注意使用 httpUrl，它会选择 Streamable HTTP）：

{
  "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 等。使用跨 Agent 安装程序进行安装：

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 服务的客户端可以使用 @qrxcodes/mcp，它会使用你的 API 密钥转发到同一服务：

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