Kilo do seu assistente de IA (MCP)

MCP é para assistentes de IA o que uma API REST é para programas: uma entrada padrão. O servidor MCP do Kilo vive na mesma origem que a API - um único servidor hospedado, operado pelo Kilo, nada para instalar - e expõe um pequeno conjunto de ferramentas que um assistente pode chamar em seu nome assim que você lhe entrega uma chave de API.

O efeito prático: “faça um código QR para o cardápio e me diga na semana que vem como ele foi” vira um fluxo completo que você conduz de uma janela de chat. O assistente cria o link, salva o estilo do QR e lê os números para você; a arte final fica a um clique no painel.

• Criar - links curtos e os códigos QR que vão em cima deles (“encurte isto”, “faça um QR para o folheto de primavera”).
• Desenhar - salve o estilo do QR de um link: cores, formas de módulo, degradês, um logo; designs animados nos planos com exportação animada.
• Medir - totais, séries temporais, países, dispositivos, referências e qualidade de clique (provavelmente humano vs datacenter vs VPN).
• Explorar - liste links e campanhas, inspecione um link, confira a conta e o plano com whoami.

O servidor fala JSON-RPC 2.0 sobre Streamable HTTP em um único endpoint na origem do Kilo QR, sob /api/mcp. A maioria dos clientes aceita um pequeno bloco JSON - esta é a forma (a chave vem na próxima seção):

{
  "mcpServers": {
    "kilo-routes": {
      "type": "http",
      "url": "https://qr2r.com/api/mcp",
      "headers": { "Authorization": "Bearer $KILO_API_KEY" }
    }
  }
}

No Claude Desktop e no Cursor esse bloco vai no arquivo de configurações do MCP; outros clientes nomeiam os campos um pouco diferente, mas sempre se resume à URL mais o cabeçalho Authorization. O Claude Code liga tudo em uma linha:

claude mcp add --transport http kilo-routes https://qr2r.com/api/mcp \
  --header "Authorization: Bearer $KILO_API_KEY"

A autenticação é a mesma chave de API bearer da API REST: cunhe uma no painel, em Chaves de API. Dê ao assistente uma chave de leitura se ele só vai relatar números, ou uma de leitura + escrita se ele deve criar links e designs. A gestão de chaves continua sendo apenas interativa - nenhuma chave, e nenhuma ferramenta MCP, pode cunhar ou revogar outras chaves.

O acesso MCP está incluído do plano Pro para cima. Peça abaixo disso e o servidor responde com um erro estruturado carregando as URLs exatas de upgrade e de preços - de modo que um assistente que repasse a falha lhe entrega um próximo passo que funciona, não um beco sem saída:

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32003,
    "message": "MCP access is included from the Pro plan up (current plan: Free). …",
    "data": {
      "feature": "mcp_access",
      "upgrade_url": "…/billing",
      "pricing_url": "…/#pricing"
    }
  }
}

As ferramentas são formuladas de propósito em torno das frases que as pessoas realmente dizem. Algumas que funcionam como estão:

• “Encurte https://example.com/spring-catalog e chame de Catálogo de primavera.”
• “Faça um código QR para o cardápio do nosso café e estilize em verde escuro com pontos arredondados.”
• “Quantos escaneamentos o folheto teve nos últimos 30 dias, e de quais países?”
• “Qual dos nossos links ativos recebeu mais cliques provavelmente humanos esta semana?”

Por baixo, isso corresponde a um punhado de ferramentas - create_link, save_link_qr_design, get_link_analytics, list_links - mais um whoami que o assistente chama quando precisa conferir seu plano ou diagnosticar um erro de permissões. O servidor também publica um recurso de primeiros passos que qualquer cliente pode ler para você.

O conjunto de ferramentas é só de leitura + criação, de propósito. Um assistente com a sua chave pode adicionar coisas e ler coisas; não pode destruir nem redirecionar nada que já exista.

• Sem apagar, sem desativar, sem pausar - nenhuma ferramenta remove um link.
• Sem edições de destino - um QR impresso não pode ser silenciosamente reapontado a partir de um chat.
• Cada criação passa pela mesma validação, pelos mesmos tetos de plano e pela mesma verificação de segurança do destino que o painel - MCP não é uma porta lateral.
• Uma chave somente leitura não pode chamar uma ferramenta de criação, e nada via MCP toca em membros, cobrança ou outras chaves.

Tudo o que um assistente pode fazer via MCP você também pode fazer por HTTP puro - os guias da API cobrem o mesmo terreno endpoint por endpoint.