QRX

Opção A: plugin (servidor MCP mais a habilidade QRX)

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

Ao ativar o plugin, o Claude Code solicita sua chave de API QRX e a armazena no armazenamento de credenciais do sistema. O plugin também adiciona a habilidade qrx, que ensina o Claude a escrever bons prompts de arte, aguardar o código e prepará-lo para impressão.

Opção B: apenas servidor MCP

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

Ou adicione isso ao .mcp.json de um projeto para que toda a equipe tenha acesso (cada pessoa define seu próprio QRX_API_KEY):

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

Quando OAuth estiver ativo: claude mcp add --transport http qrx https://qrx.codes/mcp, depois execute /mcp e faça login.

O Claude Desktop usa as mesmas configurações de conector do claude.ai; você não edita o claude_desktop_config.json para um servidor remoto.

1. Abra Personalizar → Conectores, selecione + Adicionar e depois Adicionar conector personalizado. Nos planos Team e Enterprise, um proprietário adiciona em Configurações da organização → Conectores primeiro.
2. Nome: QRX. URL: https://qrx.codes/mcp.
3. Autenticação:
   • Agora: escolha a opção de credenciais fixas e, em Cabeçalhos de solicitação, adicione Authorization com o valor Bearer qrx_live_….
   • Quando OAuth estiver ativo: escolha Entrar quando necessário; o Claude mostra um botão Conectar na primeira vez que você criar um código.
4. Salve e ative o QRX em um chat pelo menu de conectores.

Planos gratuitos do Claude podem adicionar um conector personalizado.

Os servidores MCP personalizados do ChatGPT aceitam OAuth ou nenhuma autenticação, não chaves de API, então o QRX no ChatGPT precisa da versão com OAuth.

Quando OAuth estiver ativo:

1. Abra chatgpt.com/plugins na web, selecione + e depois Adicionar servidor MCP personalizado.
2. Nome: QRX. URL do servidor: https://qrx.codes/mcp.
3. Autenticação: OAuth. Aceite o aviso de risco e selecione Criar como plugin.
4. Peça um código QR; o ChatGPT solicita que você entre no QRX na primeira vez.

Administradores do workspace podem restringir servidores MCP personalizados nos planos Business e Enterprise.

Use o botão Instalar no Cursor acima, ou adicione isso ao ~/.cursor/mcp.json (todos os projetos) ou .cursor/mcp.json (um projeto):

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

Quando OAuth estiver ativo: remova o bloco headers; o Cursor solicita que você faça login.

Use o botão Instalar no VS Code acima (ele solicita sua chave e a armazena com segurança), ou adicione isso ao .vscode/mcp.json:

{
  "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}" }
    }
  }
}

Pelo terminal:

code --add-mcp '{"name":"qrx","type":"http","url":"https://qrx.codes/mcp","headers":{"Authorization":"Bearer ${input:qrx-api-key}"},"inputs":[{"type":"promptString","id":"qrx-api-key","description":"QRX API key","password":true}]}'

Quando OAuth estiver ativo: {"type": "http", "url": "https://qrx.codes/mcp"} é suficiente.

Edite o mcp_config.json (macOS/Linux ~/.config/devin/mcp_config.json, Windows %APPDATA%\devin\mcp_config.json; instalações antigas do Windsurf usam ~/.codeium/windsurf/mcp_config.json):

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

Observe que a chave é serverUrl, não url.

Abra Servidores MCP → Configurar servidores MCP e adicione ao cline_mcp_settings.json:

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

Quando OAuth estiver ativo: remova headers e use Autorizar OAuth no servidor.

Adicione ao settings.json:

{
  "context_servers": {
    "qrx": {
      "url": "https://qrx.codes/mcp",
      "headers": { "Authorization": "Bearer qrx_live_…" }
    }
  }
}

Quando OAuth estiver ativo: omita headers; o Zed executa o fluxo de login MCP quando nenhum cabeçalho Authorization está definido.

Execute goose configure → Adicionar extensão → Extensão remota (HTTP Streamable), insira https://qrx.codes/mcp e adicione o cabeçalho Authorization: Bearer qrx_live_…. Ou edite o 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
    headers:
      Authorization: "Bearer qrx_live_…"
    timeout: 300

Adicione ao ~/.codex/config.toml:

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

Quando OAuth estiver ativo: codex mcp add qrx --url https://qrx.codes/mcp, depois codex mcp login qrx.

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

Ou no ~/.gemini/settings.json (observe httpUrl, que seleciona HTTP Streamable):

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

A pasta skills/qrx segue o padrão Agent Skills, então a mesma habilidade funciona no Codex, Gemini CLI, GitHub Copilot, Cursor, Goose e outros. Instale-a com o instalador entre agentes:

npx skills add qrxcodes/qrx-mcp

A habilidade espera que o servidor MCP QRX esteja conectado (veja seu cliente acima) ou um QRX_API_KEY para a API REST.

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

A extensão solicita sua chave de API QRX e a armazena no chaveiro do sistema.

Aponte um cliente HTTP Streamable para https://qrx.codes/mcp e envie Authorization: Bearer qrx_… (ou X-API-Key: qrx_…). Clientes que só falam stdio podem usar uma ponte como mcp-remote:

{
  "mcpServers": {
    "qrx": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://qrx.codes/mcp", "--header", "Authorization:Bearer ${QRX_API_KEY}"],
      "env": { "QRX_API_KEY": "qrx_live_…" }
    }
  }
}