logo
APIIntegrações•

Conecte a CodeQR ao Claude, ChatGPT e Cursor com MCP

Adicione o servidor MCP da CodeQR ao Claude, ChatGPT, Cursor, VS Code ou Claude Code, escolha o workspace no login e deixe o assistente cuidar dos links.

Avatar for undefined
CodeQR Team
Equipe de Conteúdo

O servidor MCP da CodeQR permite que um assistente de IA faça o que você faz no painel — criar um link curto no seu domínio, gerar um QR code dinâmico, trocar para onde um código impresso aponta, listar o que criou, ler leituras e cliques — a partir de uma conversa. Este guia conecta os três clientes mais comuns, explica o login e alinha o que o assistente pode e não pode fazer.

Disponibilidade

  • Plano: todos os planos. O assistente trabalha dentro de um workspace com as permissões de quem entrou; links e códigos criados contam nas cotas daquele workspace.
  • Onde: URL do servidor https://mcp.codeqr.io/mcp (Streamable HTTP). Aparece como CodeQR MCP em Configurações → Integrações assim que um workspace é conectado; o cartão diz Access is granted per project, and can be revoked at any time from Settings → Integrations. Referência: MCP em docs.codeqr.io.

Antes de começar

  • Nenhuma chave de API é necessária nem aceita. A primeira requisição abre o navegador, você entra na CodeQR e escolhe o workspace a liberar; o cliente guarda o token a partir daí.
  • Um cliente conectado por vez por workspace: entrar por um segundo cliente — ou autorizar de novo o mesmo — substitui a autorização anterior daquele workspace.
  • O assistente não registra nem lê eventos de conversão (leads, vendas); os objetos de link e QR ainda mostram os contadores clicks, leads e sales.
  • Os clientes pedem confirmação antes das ferramentas que publicam ou reescrevem algo (criar, atualizar, apagar). Deixe isso ligado.

Passos

  1. Claude (web ou app): abra Customize → Connectors, clique em + → Add custom connector, cole https://mcp.codeqr.io/mcp, deixe os campos de OAuth em Advanced settings vazios e salve. No primeiro uso o Claude abre o login da CodeQR; escolha o workspace e permita.
  2. ChatGPT: Settings → Advanced → Developer Mode, depois a aba Connectors → Add Connector, informe https://mcp.codeqr.io/mcp. O ChatGPT descobre os endpoints de OAuth e pede a autorização.
  3. Cursor: acrescente em ~/.cursor/mcp.json (global) ou .cursor/mcp.json (projeto):
{ "mcpServers": { "codeqr": { "url": "https://mcp.codeqr.io/mcp" } } }
  1. VS Code: .vscode/mcp.json:
{ "servers": { "codeqr": { "type": "http", "url": "https://mcp.codeqr.io/mcp" } } }
  1. Claude Code (terminal):
claude mcp add --transport http codeqr https://mcp.codeqr.io/mcp
  1. Peça ao assistente para listar as ferramentas da CodeQR. Devem aparecer catorze: create_link, list_links, get_link_info, update_link, delete_link, create_qrcode, list_qrcodes, update_qrcode, delete_qrcode, get_analytics, list_domains, list_tags, create_tag, get_workspace.

O que pedir

  • "Crie um link curto em go.example.com para https://example.com/cardapio-primavera, chave cardapio-primavera, tag cardapio." → create_link, devolve o link curto.
  • "Faça um QR code dinâmico para a rede Wi-Fi CafeGuest com senha **, título Wi-Fi do balcão." → create_qrcode (tipos: url, text, email, phone, sms, wifi, vcard, crypto, whatsapp).
  • "O QR code das mesas agora deve abrir https://example.com/cardapio-verao — atualize, não crie outro." → update_qrcode; o código impresso continua funcionando.
  • "Quantas leituras o QR code das mesas teve esta semana, por país?" → get_analytics com event: scans, groupBy: countries, interval: 7d.
  • "Em qual workspace e plano estou conectado?" → get_workspace ({ "id", "slug", "name", "plan" }) — pergunte isso primeiro quando tiver vários workspaces.

O servidor avisa o modelo de que todo link e código é um endpoint vivo, cujo destino continua editável depois de impresso e cujas leituras são registradas, e de que trocar a key de um link quebra as cópias já compartilhadas. Espere que o assistente prefira update_link/update_qrcode a recriar.

Revogue ou troque de workspace

Abra Configurações → Integrações → CodeQR MCP e desinstale (⋮ → Uninstall Integration), ou entre de novo pelo cliente e escolha outro workspace — a autorização mais nova substitui a anterior.

Verifique se funcionou

  1. Peça a lista de ferramentas (passo 6). Catorze ferramentas significam conexão completa — um selo de "conectado" sozinho não prova nada.
  2. Peça ao assistente para criar um link de teste. Ele aparece em Links no painel em segundos; Configurações → Integrações mostra CodeQR MCP ativado com o seu nome em INSTALLED BY.
  3. Peça para apagar esse link de teste.

Solução de problemas

O cliente diz conectado, mas o assistente não tem ferramentas da CodeQR

A etapa de OAuth não terminou, ou o cliente guardou uma sessão antiga. Remova o conector, adicione de novo e conclua o login no navegador; então peça a lista de ferramentas.

O assistente trabalha no workspace errado

O token pertence ao workspace escolhido no login. Autorize de novo e escolha o certo — a autorização anterior é substituída. get_workspace diz qual está ativo.

Meu colega perdeu o acesso quando eu conectei

Um cliente por workspace: o seu login substituiu o dele. Cada pessoa pode conectar um workspace diferente, ou uma pessoa fica com a conexão.

"list_domains" devolve uma página de erro

Na data desta publicação essa ferramenta responde com uma página de não encontrado em vez dos seus domínios. Consulte o domínio na página Domínios do painel, ou passe o domínio explicitamente em create_link.

O assistente se recusa a registrar um lead ou uma venda

O rastreamento de conversões não é exposto pelo MCP. Use a API (POST /track/lead, POST /track/sale) ou o SDK.

Artigos relacionados