TheQRCode.io MCP Sever

Gere códigos QR para URLs, WiFi, contatos e texto. A chave de API paga adiciona códigos salvos e análises.

Ver em theqrcode.ioExperimente este MCPPatrocinado

Documentação

Servidor MCP de QR Code para Claude, Cursor e Agentes de IA

Um URL. Sem instalação. Adicione a geração de QR codes a qualquer cliente de IA compatível com MCP em menos de um minuto.

URL do servidor MCP

https://mcp.theqrcode.io/mcp HTTP/SSE

Remoto, sem instalação

Funciona via HTTP/SSE. Aponte seu cliente para um URL. Nada para executar localmente, sem npm, sem Docker.

Funciona no contexto

Claude e Cursor chamam a ferramenta automaticamente quando você pede um QR code. Sem chamadas de API manuais.

Grátis para gerar

Sem chave de API, sem cadastro, 100 requisições/hora por IP. Adicione uma chave Developer ou Pro para salvar códigos permanentemente (2.000 ou 500 requisições/hora); o plano Developer também desbloqueia as ferramentas de listagem e análise.

Configuração

Escolha seu cliente e cole a configuração.

Abra Configurações → Desenvolvedor → Editar Config e adicione o bloco mcpServers:

{
  "mcpServers": {
    "theqrcode": {
      "url": "https://mcp.theqrcode.io/mcp"
    }
  }
}

Abra Configurações do Cursor → MCP → Adicionar novo servidor MCP e cole o URL, ou edite ~/.cursor/mcp.json diretamente:

{
  "mcpServers": {
    "theqrcode": {
      "url": "https://mcp.theqrcode.io/mcp"
    }
  }
}

Outros clientes MCP

Qualquer cliente que suporte a especificação MCP com transporte remoto HTTP/SSE funciona. Aponte-o para https://mcp.theqrcode.io/mcp.

Experimente

Depois de conectado, é só pedir. Esses prompts acionam a ferramenta automaticamente.

›

Gere um QR code para https://mysite.com

›

Faça um QR code de WiFi para minha rede "HomeNetwork" com senha "secret123"

›

Crie um QR code para minhas informações de contato: nome João Silva, email joao@exemplo.com

›

Gere um QR code azul escuro para https://example.com, 512px

›

Crie um QR code com o texto "Mesa 12" para meu restaurante

Referência de ferramentas

Três ferramentas. Todas as três são listadas para cada cliente; as duas ferramentas de conta recusam no momento da chamada sem uma chave.

generate_qr_code

Gera uma imagem de QR code e retorna tanto um URL hospedado quanto um PNG base64 para exibição inline.

Grátis, sem chave. Tipos url, wifi, contact, text e email, a 100 requisições/hora por IP. Com uma chave Developer ou Pro, cada código gerado é salvo permanentemente na sua conta em vez de retornar um link de pré-visualização de 24 horas.

Parâmetro	Tipo	Obrigatório	Descrição
type	enum		`url` · `wifi` · `contact` · `text` · `email`
content	string		Dados para codificar: URL, string WiFi, vCard ou texto simples
size	integer	-	Tamanho da saída em pixels (64-1024). Padrão: 256
darkColor	string	-	Cor hexadecimal para módulos escuros. Padrão: `#000000`
lightColor	string	-	Cor hexadecimal para o fundo. Padrão: `#FFFFFF`
dotStyle	enum	-	Forma do módulo: quadrado, pontos, arredondado, extra-arredondado, clássico, clássico-arredondado
cornerStyle	enum	-	Cantos: quadrado, ponto, extra-arredondado
frameStyle	enum	-	Moldura: quadrado (nenhum), arredondado, círculo, tracejado
caption	string	-	Texto abaixo do código (≤60 caracteres). Implica uma moldura
format	enum	-	png (padrão), svg ou pdf. svg/pdf exigem chave de API

Formato de conteúdo WiFi

WIFI:T:WPA;S:MyNetwork;P:MyPassword;;

Esquema completo

{
  "name": "generate_qr_code",
  "description": "Generate a QR code image. Use this whenever a user asks to create, make, or generate a QR code for a URL, website, WiFi network, contact card, or text. Returns a hosted image URL (valid 24 hours) and a base64 PNG for inline display.",
  "parameters": {
    "type": {
      "type": "string",
      "enum": ["url", "wifi", "contact", "text"],
      "required": true
    },
    "content": {
      "type": "string",
      "required": true,
      "description": "Data to encode"
    },
    "size": {
      "type": "integer",
      "min": 64,
      "max": 1024,
      "default": 256
    },
    "darkColor": {
      "type": "string",
      "example": "#000000"
    },
    "lightColor": {
      "type": "string",
      "example": "#FFFFFF"
    }
  }
}

list_qr_codesPlano Developer

Lista os QR codes salvos na sua conta, para que você possa perguntar "quais QR codes eu tenho para o restaurante?" e obter uma resposta dos seus dados reais.

Parâmetro	Tipo	Descrição
page	integer	Número da página. Padrão: 1
limit	integer	Códigos por página (1-100). Padrão: 20
type	enum	Filtrar por tipo: url, wifi, contact, text, email

get_analyticsPlano Developer

Análise de escaneamento dos seus códigos — para toda a conta ou para um código específico. Pergunte "como foi o desempenho do código da mesa no mês passado?" e o assistente lê seus dados reais de escaneamento: total e escaneamentos únicos, horário, localização aproximada, dispositivo e sistema operacional, e campanha. O que cada métrica significa →

Parâmetro	Tipo	Descrição
qrCodeId	string	ID de um código. Omita para totais da conta inteira
timeRange	enum	1h · 1d · 7d · 30d (padrão) · 90d · 1y

Adicione um cabeçalho Authorization à mesma configuração. Sem ele, a sessão é anônima e apenas generate_qr_code funciona. As chaves vêm com os planos Developer e Pro: Developer permite 2.000 requisições MCP/hora com todas as três ferramentas, Pro 500/hora com apenas generate_qr_code.

{
  "mcpServers": {
    "theqrcode": {
      "url": "https://mcp.theqrcode.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Resposta

imageUrl

URL do PNG hospedado. No plano gratuito, isso é uma pré-visualização e para de funcionar após 24 horas

image (base64)

PNG inline para clientes que renderizam imagens diretamente

O QR code não expira — o link de pré-visualização gratuito expira. O padrão codificado é permanente, então uma imagem baixada funciona para sempre. É a hospedagem gratuita dessa imagem que é temporária: baixe-a, ou conecte uma chave Developer ou Pro e o código será armazenado na sua conta e permanecerá ativo. Como funciona a permanência →

Também disponível

API REST

HTTP direto, sem necessidade de cliente MCP. Funciona em qualquer linguagem.

Ver documentação

Especificação OpenAPI

Importe no Postman, Insomnia, ou gere um cliente tipado.

openapi.json

Manifesto de Plugin de IA

Formato de plugin OpenAI para integrações de chamada de função.

Ver manifesto

Perguntas frequentes

QR codes, MCP e o que cada assistente pode realmente fazer.

O que é um servidor MCP de QR code?

MCP (Model Context Protocol) é um padrão aberto que permite que um assistente de IA chame ferramentas externas. Um servidor MCP de QR code é um endpoint de ferramenta que um assistente pode chamar para criar um QR code, então você pede em linguagem natural em vez de sair do chat para usar um site. O nosso é um servidor HTTP remoto em https://mcp.theqrcode.io/mcp — você adiciona um URL à configuração do seu cliente e não há nada para instalar.

O Claude pode gerar QR codes?

Sim. O Claude não consegue desenhar um QR code escaneável sozinho — a codificação é precisa e a geração de imagens não é — mas com um servidor MCP conectado, ele chama um gerador real e retorna um código real. Adicione o URL do nosso servidor à configuração do Claude Desktop e peça "faça um QR code para meu WiFi".

O ChatGPT pode gerar QR codes?

Através da nossa API REST sem chave e do manifesto de plugin OpenAI, sim — veja o guia de agentes de IA em https://theqrcode.io/ai-agents para o esquema de chamada de função. O suporte a MCP do ChatGPT depende de qual produto e plano você está usando; o caminho REST funciona em todos os lugares.

O Cursor pode gerar QR codes?

Sim. Adicione o URL do servidor a ~/.cursor/mcp.json, reinicie o Cursor e peça. A ferramenta é acionada automaticamente quando sua solicitação precisa de um QR code.

Requer instalação local?

Não. Sem npm, sem Docker, sem Python. É um servidor HTTP remoto com streaming; seu cliente apenas guarda um URL. O código-fonte é público em https://github.com/awilliams-2020/theqrcode-mcp se você preferir executá-lo você mesmo.

Quais ferramentas o servidor MCP expõe?

Três. generate_qr_code cria um QR code e é gratuito sem chave, para tipos url, wifi, contact e text. list_qr_codes retorna os códigos salvos na sua conta. get_analytics retorna análises de escaneamento — total e escaneamentos únicos, horário, localização aproximada, dispositivo e sistema operacional — para toda a conta ou para um código específico. As duas últimas exigem uma chave de API do plano Developer.

Como é o QR code retornado?

Você recebe duas coisas: um URL de PNG hospedado que você pode clicar ou colar, e um PNG base64 que clientes como o Claude Desktop renderizam inline na conversa. No plano gratuito, o link hospedado é uma pré-visualização de 24 horas, então baixe a imagem. O QR code em si nunca expira — conecte uma chave Developer ou Pro e o código será salvo permanentemente na sua conta.

Como funciona a autenticação?

Adicione um cabeçalho Authorization: Bearer <your API key> à configuração do servidor no seu cliente MCP. Sem ele, a sessão é anônima e apenas generate_qr_code funciona, a 100 requisições/hora por IP. As chaves vêm com os planos Developer ($19/mês, todas as três ferramentas, 2.000 requisições/hora) e Pro ($29/mês, apenas generate_qr_code, 500 requisições/hora).

Está no registro oficial do MCP?

Sim, como io.theqrcode/qr-code-generator. O código-fonte é público em https://github.com/awilliams-2020/theqrcode-mcp.

Pronto para conectar?

Adicione o URL do servidor à configuração do seu cliente MCP e comece a gerar QR codes a partir de qualquer conversa.

https://mcp.theqrcode.io/mcp