El asistente con el MCP

Para qué sirve

El MCP es un conector que deja a un asistente de inteligencia artificial usar las mismas operaciones que la API, con un token que vos controlás. El asistente no entra al panel: consulta datos y, si le diste permiso, hace cambios chicos, siempre dentro de lo que el token permite.

Sirve para armar resúmenes, buscar algo sin navegar el panel, preparar un informe o revisar pendientes. Hoy ofrece 80 operaciones de 8 módulos (Gestión, Administración, Configuración, Inmobiliaria, Bandeja, Tienda, Alquileres, Turnos), 50 de ellas de solo lectura.

Lo primero: qué clientes pueden conectarse hoy

Lo que sí funciona hoy:

• Claude Code y Cursor, con un encabezado fijo. Está explicado en la página de MCP.
• La aplicación de escritorio de Claude, con un puente que se llama mcp-remote y que agrega el encabezado desde tu computadora. Es el camino de esta guía. Necesita tener instalado Node.js.

Cuando el ingreso por OAuth esté, esta guía se va a simplificar a pegar la dirección en Add custom connector. Lo anunciamos en el registro de cambios.

Qué necesitás

• Una cuenta de Kaptativa con API y MCP activo, dentro de Administración.
• La aplicación de escritorio de Claude y Node.js instalado (la versión recomendada, «LTS»). El puente se descarga solo la primera vez que arranca.
• Un token propio para el asistente (más abajo).

Pasos

1. Crear un token para el asistente

1. Entrá al panel y abrí Administración > API y MCP.
2. En Crear un token, en Nombre escribí quién lo usa, por ejemplo «Claude de Ana».
3. En Qué puede hacer, elegí Solo ver. Si querés que el asistente vea solo ciertos módulos, Elegir por módulo y marcá Ver en los que corresponda.
4. En Vence, elegí En 90 días (o el plazo que prefieras), y tocá Crear el token.
5. Copiá el token (empieza con kpt_) en ese momento: no se vuelve a mostrar. Tocá Ya lo copié.

2. Conectar la aplicación de escritorio de Claude

1. Abrí Claude. En el menú, Settings (Configuración) > Developer (Desarrollador) > Edit Config. Se abre una carpeta con el archivo claude_desktop_config.json.
2. Abrí el archivo con un editor de texto. Si está vacío o tiene solo {}, pegá el texto de abajo. Si ya tiene otros servidores, sumá kaptativa dentro de mcpServers sin borrar los que hay.
3. Reemplazá kpt_... por tu token, dejando la palabra Bearer y el espacio.
4. Guardá y cerrá Claude por completo (en Windows, también desde la bandeja del sistema) y volvé a abrirlo.

{
  "mcpServers": {
    "kaptativa": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://panel.kaptativa.app/api/mcp",
        "--transport",
        "http-only",
        "--header",
        "Authorization:${KAPTATIVA_AUTORIZACION}"
      ],
      "env": {
        "KAPTATIVA_AUTORIZACION": "Bearer kpt_..."
      }
    }
  }
}

El encabezado va en una variable aparte (KAPTATIVA_AUTORIZACION) y no dentro del argumento porque algunas versiones de Windows parten los argumentos en el espacio de «Bearer kpt_...».

3. Si usás Claude Code

No hace falta el puente: se suma con un comando, que está en la página de MCP.

Qué puede hacer

El asistente ve únicamente las operaciones que ese token puede usar. Algunos ejemplos de lo que le podés pedir, con un token de Solo ver:

• «Listame las consultas de hoy y decime cuáles están demoradas.»
• «Buscá al cliente Pérez y resumime su ficha.»
• «¿Qué productos de la tienda tienen poco stock?»
• «Armame una tabla con las tarjetas del tablero de ventas por estado.»

Con un token de Ver y hacer cambios puede además dar de alta un cliente o registrar una consulta, entre otras operaciones de la referencia. Esas llevan la marca de que cambian algo, y Claude te pide confirmación antes de usarlas: dejá esa confirmación activada.

Los límites

Una advertencia sobre cualquier asistente de IA: lo que le consultes lo lee el servicio de IA que uses para conversar. Si en la cuenta hay datos personales de tus clientes (nombres, teléfonos, mensajes), un token de Solo ver acotado a los módulos que hacen falta es más prudente que uno de todos los módulos.

Cómo comprobar que anda

1. Abrí un chat nuevo en Claude. Junto al cuadro de texto tiene que aparecer el ícono de herramientas, y al tocarlo, kaptativa con su lista de herramientas.
2. Escribí: «Usá Kaptativa y decime con qué cuenta estás conectado.» Tiene que responder con datos de tu cuenta.
3. En el panel, en Administración > API y MCP, abrí el registro del token: tienen que figurar los pedidos que acaba de hacer, con el resultado Hecho.

Si algo falla, probá el servidor sin el asistente con el pedido de Probar la conexión a mano: dice si el problema es el token o el cliente.

Problemas comunes

Para usarlo con cuidado

• Un token por persona y por equipo. Si alguien deja de usar el asistente, se revoca el suyo y nada más.
• El archivo de configuración tiene el token adentro: no lo compartas, no lo subas a un repositorio ni lo mandes por chat.
• Empezá con Solo ver. Sumá cambios solo en el módulo donde el asistente tiene que hacerlos.
• Revisá cada tanto el registro de pedidos del token.