Kilo desde tu asistente de IA (MCP)

MCP es para los asistentes de IA lo que una API REST es para los programas: una entrada estándar. El servidor MCP de Kilo vive en el mismo origen que la API - un único servidor alojado, operado por Kilo, sin nada que instalar - y expone un pequeño conjunto de herramientas que un asistente puede llamar en tu nombre una vez le entregas una clave de API.

El efecto práctico: «haz un código QR para el menú y dime la semana que viene cómo fue» se convierte en un flujo completo que ejecutas desde una ventana de chat. El asistente crea el enlace, guarda el estilo del QR y te lee los números; el arte final queda a un clic en el panel.

• Crear - enlaces cortos y los códigos QR que van encima («acorta esto», «haz un QR para el folleto de primavera»).
• Diseñar - guarda el estilo del QR de un enlace: colores, formas de módulo, degradados, un logo; diseños animados en los planes con exportación animada.
• Medir - totales, series temporales, países, dispositivos, referentes y calidad de clic (probablemente humano vs datacenter vs VPN).
• Explorar - lista enlaces y campañas, inspecciona un enlace, comprueba la cuenta y el plan con whoami.

El servidor habla JSON-RPC 2.0 sobre Streamable HTTP en un único endpoint en el origen de Kilo QR, bajo /api/mcp. La mayoría de clientes aceptan un pequeño bloque JSON - esta es la forma (la clave llega en la sección siguiente):

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

En Claude Desktop y Cursor ese bloque va en el archivo de configuración de MCP; otros clientes nombran los campos algo distinto, pero siempre se reduce a la URL más la cabecera Authorization. Claude Code lo conecta en una línea:

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

La autenticación es la misma clave de API bearer que en la API REST: acuña una en el panel, en Claves de API. Dale al asistente una clave de lectura si solo va a informar de números, o una de lectura + escritura si debe crear enlaces y diseños. La gestión de claves sigue siendo solo interactiva - ninguna clave, y ninguna herramienta MCP, puede acuñar o revocar otras claves.

El acceso MCP está incluido del plan Pro hacia arriba. Pídelo por debajo y el servidor responde con un error estructurado que lleva las URLs exactas de mejora y de precios - de modo que un asistente que retransmita el fallo te entrega un siguiente paso que funciona, no un callejón sin salida:

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

Las herramientas están redactadas a propósito alrededor de las frases que la gente dice de verdad. Algunas que funcionan tal cual:

• «Acorta https://example.com/spring-catalog y llámalo Catálogo de primavera.»
• «Haz un código QR para el menú de nuestra cafetería y dale un estilo verde oscuro con puntos redondeados.»
• «¿Cuántos escaneos tuvo el folleto en los últimos 30 días, y desde qué países?»
• «¿Cuál de nuestros enlaces activos recibió más clics probablemente humanos esta semana?»

Por debajo, eso se traduce en un puñado de herramientas - create_link, save_link_qr_design, get_link_analytics, list_links - más un whoami que el asistente llama cuando necesita comprobar tu plan o diagnosticar un error de permisos. El servidor también publica un recurso de primeros pasos que cualquier cliente puede leerte.

El conjunto de herramientas es solo de lectura + creación, a propósito. Un asistente con tu clave puede añadir cosas y leer cosas; no puede destruir ni redirigir nada que ya exista.

• Sin borrar, sin desactivar, sin pausar - ninguna herramienta elimina un enlace.
• Sin ediciones de destino - un QR impreso no se puede reapuntar en silencio desde un chat.
• Cada creación pasa por la misma validación, los mismos topes de plan y el mismo análisis de seguridad del destino que el panel - MCP no es una puerta lateral.
• Una clave de solo lectura no puede llamar a una herramienta de creación, y nada sobre MCP toca miembros, facturación u otras claves.

Todo lo que un asistente puede hacer por MCP también puedes hacerlo por HTTP normal - las guías de la API cubren el mismo terreno endpoint a endpoint.