Relo MCP — Kimi en tu terminal

Relo MCP es un agente tipo Kimi Code CLI que corre en la compu de cada persona del equipo, conectado a Relo de forma segura. Le hablas en español normal ("¿cómo va el budget de MX?") y el agente consulta o ejecuta en la plataforma por ti. El cerebro es tu propia sesión de Kimi (tu suscripción), así que no hay costos de API por token: lo único que se paga es lo que ya pagas por Kimi.

Flujo del agente

---

Modelo de seguridad

• Ninguna llave de poder toca tu compu. El service-role de Supabase y el token del backbone viven solo en el worker (relo-api). Tu máquina solo tiene tu propio JWT, igual que cuando entras al portal.
• Entras con tu cuenta propia de Relo (email + password, los mismos del portal).
• Lectura: todo el staff interno (admin, client_manager, viewer).
• Escritura: solo admin. Si no eres admin, las tools de escritura ni aparecen en tu agente.
• Todo write queda auditado a tu nombre en la tabla mcp_call_log (quién, qué tool, con qué argumentos, cuándo).
• Fail-closed: si el rol no se puede resolver, el agente asume solo-lectura.

---

Setup (una sola vez)

1. Instala Kimi Code CLI si no lo tienes y entra con tu cuenta de Kimi:

   curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash

2. Instala las dependencias del MCP:

   cd ~/relo/mcp
   ./install.sh

3. Edita ~/.kimi-code/mcp.json (ya existe una plantilla generada por el equipo) y rellena solo tus credenciales:

   {
     "mcpServers": {
       "relo": {
         "command": "npx",
         "args": ["tsx", "src/index.ts"],
         "cwd": "/ruta/absoluta/a/relo/mcp",
         "env": {
           "SUPABASE_URL": "https://wbvrlcospepaqsooxhvg.supabase.co",
           "SUPABASE_ANON_KEY": "<la anon key pública del proyecto>",
           "API_BASE": "https://relo-api.quomx.workers.dev",
           "RELO_EMAIL": "tu-email@relo.mx",
           "RELO_PASSWORD": "tu-password"
         }
       }
     }
   }

   SUPABASE_URL, SUPABASE_ANON_KEY y API_BASE son iguales para todos (pídelas a quien administre Relo). RELO_EMAIL y RELO_PASSWORD son personales.

4. Corre el agente desde el directorio mcp/:

   cd ~/relo/mcp
   kimi

   Correrlo desde ahí importa: el agente lee AGENTS.md + context/ (el cerebro del negocio) y ya sabe cómo jala Relo sin que le expliques nada.

5. Verifica que cargó: pregunta "¿qué tools de relo tienes?" — deben aparecer como mcp__relo__*.

---

Qué puedes preguntarle

Lectura (todo el staff):

• "¿Cuánto hemos gastado del budget de MX y cuál es el margen?"
• "¿Cómo van los partners este mes vs el pasado?"
• "Encuéntrame la orden MX260410-12345."
• "Dame el breakdown de comisiones de <partner> este mes."
• "¿Hay fraude sospechoso esta semana?"
• "¿El backbone está sano?" (backbone_health)

Escritura (solo admin — el agente te pide confirmar antes de ejecutar):

• "Pausa el segmento DA de <partner>."
• "Ponle cap de $50,000 al segmento MX de <partner>."
• "Genera los pagos de junio." / "Aprueba el pago de <partner>."
• "Crea el partner <nombre> y asócialo al cliente <cliente>."

---

Qué sabe el agente (context pack)

El agente entiende el negocio porque lee mcp/context/ al arrancar la sesión:

Si cambias una regla de negocio, actualiza estos archivos: son la memoria del agente.

---

Troubleshooting

---

Más sobre IA en Relo

---

¿Necesitas ayuda?

Si el agente contesta algo raro sobre el negocio, probablemente falta contexto: actualiza mcp/context/ y reinicia la sesión. Si una escritura falla, revisa mcp_call_log en Supabase o contacta a ingeniería.