MerCRM

API y agentes

La misma API que usa
la consola, sin atajos.

No hay una API «para integraciones» distinta de la que mueve el producto: lo que hace la pantalla lo hace la API, con las mismas reglas y los mismos límites. Se conecta un agente, un script propio o el sistema que ya tengas.

Las reglas

Lo que un agente
no puede hacer.

Un agente con acceso a tu CRM da miedo por buenas razones. Estas son las líneas que no cruza, y no dependen de cómo esté escrito su prompt: las aplica el servidor.

Actúa por alguien, y se nota

Un token se liga a una persona del equipo. Lo que escribe queda a nombre de ella y con sus permisos, nunca con más. El agente es la vía; la responsable es ella.

Los permisos son por módulo

Leer la bandeja de correo, contestar por WhatsApp, armar un tablero o registrar un pago son permisos distintos. Se dan de uno en uno y se quitan igual.

Nadie amanece con permisos nuevos

Cuando se agrega un módulo, sus permisos no se reparten solos entre los tokens que ya existían. Alguien tiene que darlos a propósito.

Abrir puertas es de personas

Publicar una propuesta o el portal de un proyecto acuña el enlace que verá alguien de fuera de tu empresa. Eso no lo hace un token, ni actuando por alguien.

Un token de máquina no firma

Si un token no está ligado a nadie, no puede crear una propuesta ni contestarle a un cliente: sería una voz de la empresa que nadie firmó.

El secreto se enseña una vez

Al crear un token se muestra su clave y no vuelve a estar disponible. Se revoca cuando haga falta y deja de servir en el acto.

Se explica sola

El agente pregunta
qué puede hacer.

Hay un endpoint que devuelve el contrato completo: cada recurso con sus rutas, qué significa cada estado del negocio y las reglas que un agente debe respetar. No hace falta mandarle documentación aparte ni mantenerla al día por tu cuenta.

Como herramientas MCP, el mismo contrato llega ya masticado: cada una dice para qué sirve, qué necesita y qué error va a recibir si se equivoca.

Lo que ve un agente al conectarse

GET /api/v1/auth/me
→ scopes que trae este token,
  y por qué persona actúa

GET /api/v1/schema
→ los recursos, sus rutas,
  el vocabulario del negocio
  y las reglas para agentes

Los errores dicen qué falta: un permiso, una persona detrás del token, o que eso lo hace un humano.

Para qué se usa

Trabajo real, no demos.

  • Redactar la propuesta con la transcripción de la reunión, contra tu catálogo, y dejarla lista para que una persona la revise y la publique.
  • Contestar por WhatsApp con la voz de la casa, y escalar a una persona cuando la pregunta se sale del guion.
  • Mantener el tablero de entrega al día y responder al cliente en el portal, firmado por quien lleva el proyecto.
  • Leer la cartera para armar un reporte, sin poder tocar la cobranza ni mandarle nada a nadie.

Se prueba en diez minutos.

Creas un token, lo ligas a tu usuario, le das solo lectura y le preguntas qué puede hacer. Ampliar permisos después es una casilla.

Empezar la prueba