Replai expone su API como servidor MCP (Model Context Protocol). Cualquier cliente MCP — Claude Desktop, Cursor, Continue.dev, Zed, agentes propios — puede listar sesiones, mandar mensajes, leer historiales y agregar conocimiento al bot conversando con un LLM, sin que el usuario tenga que escribir código.

Por qué

Tu equipo ya usa Claude / Cursor para escribir código. Con esto le decís: “mandale a Juan el catálogo nuevo por WhatsApp desde la sesión de Soporte” y el LLM lo hace — encuentra la sesión, encuentra al contacto, envía el mensaje, y te devuelve el job id. Sin abrir el dashboard, sin curl, sin SDK.

Instalación

El servidor se ejecuta localmente en la máquina del usuario y habla con https://app.replai.tech/api sobre HTTPS. La API key vive solo en el archivo de configuración del cliente MCP — nunca sale de tu máquina.

Claude Desktop

Editá ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "replai": {
      "command": "npx",
      "args": ["-y", "@replai/mcp"],
      "env": {
        "REPLAI_API_KEY": "live_xxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Reiniciá Claude Desktop. Verás un icono de herramientas (🔨) al lado del prompt — clic ahí y deberían aparecer las 8 herramientas de Replai.

Cursor

Settings → MCP → Add new MCP server. Mismo bloque que arriba, en el campo de configuración JSON.

Otros clientes

Cualquier cliente que hable MCP sobre stdio funciona. El comando es npx -y @replai/mcp; la única variable de entorno requerida es REPLAI_API_KEY. Opcionalmente REPLAI_API_URL si apuntás a un entorno on-prem.

Herramientas disponibles

El servidor expone 8 herramientas. Todas auto-documentadas — el LLM lee la descripción y decide cuál usar.

Tool	Hace	Endpoint REST
`list_sessions`	Lista las sesiones del tenant.	`GET /v1/sessions`
`get_session`	Detalle de una sesión + config del bot.	`GET /v1/sessions/{id}`
`get_session_readiness`	Diagnóstico: ¿puede mandar mensajes? ¿qué obligación está bloqueando?	`GET /v1/sessions/{id}/readiness`
`send_message`	Envía un mensaje de texto. Idempotente con `clientMessageId`.	`POST /v1/messages`
`list_conversations`	Lista los chats. Filtrable por sesión.	`GET /v1/conversations`
`get_conversation_messages`	Historial de un chat (paginado por fecha).	`GET /v1/conversations/{id}/messages`
`list_knowledge`	Fuentes de conocimiento adjuntas a una sesión.	`GET /v1/sessions/{id}/knowledge`
`add_knowledge_text`	Sube una FAQ / política como texto. Se indexa en background.	`POST /v1/sessions/{id}/knowledge`

Permisos

El servidor hereda los scopes de la API key. Crear una key con scopes reducidos (por ejemplo, solo lectura) limita lo que el LLM puede hacer. Te recomendamos generar una key dedicada — “Claude Desktop · Daniel” — para que el audit log distinga entre operaciones humanas y automatizadas.

Privacidad

El servidor corre en tu máquina, no en infraestructura de Replai.
Las llamadas pasan directo a app.replai.tech por HTTPS con tu key.
Anthropic / Cursor / quien sea que esté hosteando el LLM ve los argumentos + respuestas de cada tool call. Si eso te preocupa, no autorices la tool en runtime.
El servidor escribe logs solo a stderr; el cliente MCP los archiva localmente.

Ejemplo de prompt

Después de instalar, podés decirle al LLM cosas como:

“Listame las sesiones activas y deciles cuál está en cuarentena”
“Mandale a +584121234567 desde la sesión de Soporte: ‘Hola, ¿puedo ayudarte?’”
“Leé los últimos 10 mensajes de la conversación con María y resumímelo”
“Agregá esta política de devoluciones a la base de conocimiento de la sesión 1”