API · MCP · CLI

Conectar un agente por MCP

Tu agente puede consultar tu negocio y, si le das permiso, cambiar tu inventario y tus pedidos sin pedirte aprobación. Lo que cuesta plata o les llega a tus clientes, como guías, cobros, facturas y mensajes, no se hace con la llave: sigue en el panel. No tiene costo mientras no publiquemos un precio en Precios.

El servidor MCP de TuAsistente está en https://mcp.tuasistente.co/mcp (transporte HTTP). Tiene las operaciones de la API como herramientas, con los mismos nombres, permisos y respuestas. Por ahora se conecta solo con tu llave en la cabecera Authorization: Bearer ta_pk_…; la conexión con inicio de sesión (OAuth) llegará más adelante.

Cambios desde el MCP

Con los permisos de cambio, las herramientas ajustar_inventario, fijar_inventario, registrar_venta, marcar_pedido_pagado, marcar_pedido_entregado, marcar_pedido_devuelto, cancelar_pedido, agregar_nota_pedido y cambiar_produccion_pedido cambian datos de tu negocio. Piden el argumento llave_idempotencia y aceptan simular, igual que la API (ver Cambios).

Van marcadas para que tu cliente sepa que no son solo de lectura, y cancelar_pedido, marcar_pedido_devuelto y fijar_inventario, como destructivas: muchos clientes te piden confirmar antes de usarlas. Pídele a tu agente que simule primero y te muestre el antes y el después.

Claude Code

Con la llave en la variable TUASISTENTE_LLAVE (como en el inicio rápido), agrega el servidor desde la terminal:

terminal

claude mcp add --transport http --scope user tuasistente https://mcp.tuasistente.co/mcp \
  --header "Authorization: Bearer $TUASISTENTE_LLAVE"

Con --scope user queda disponible en todos tus proyectos. Claude Code guarda la cabecera en su configuración, así que no compartas ese archivo. Si prefieres no guardar la llave, crea un archivo .mcp.json en tu proyecto que la lea de tu entorno al arrancar, y no subas la llave a tu repositorio:

.mcp.json

{
  "mcpServers": {
    "tuasistente": {
      "type": "http",
      "url": "https://mcp.tuasistente.co/mcp",
      "headers": {
        "Authorization": "Bearer ${TUASISTENTE_LLAVE}"
      }
    }
  }
}

Dentro de Claude Code, /mcp te muestra si quedó conectado. Pídele, por ejemplo, «¿qué pedidos tengo por despachar?».

Claude (web y escritorio)

En Claude, entra a Customize › Connectors y toca «Add custom connector» (en los planes Team y Enterprise lo agrega un administrador desde Organization settings › Connectors). Los nombres pueden aparecer traducidos.

Nombre: TuAsistente. Dirección: https://mcp.tuasistente.co/mcp.
Autenticación: «No sign in».
En «Request headers», agrega la cabecera authorization con el valor Bearer ta_pk_…: la palabra Bearer, un espacio y tu llave completa.

El conector queda en tu cuenta y también sirve en Claude de escritorio. Claude no deja cambiar la cabecera después de guardarla: para usar otra llave, quita el conector y agrégalo de nuevo.

Las cabeceras en los conectores personalizados todavía están en prueba en Claude y no todas las cuentas las tienen. Si no ves «Request headers», tu cuenta aún no puede conectarse a TuAsistente por ahí: usa Claude Code, la API o el CLI.

ChatGPT

Por ahora no se puede. Los conectores de ChatGPT se conectan con inicio de sesión (OAuth) o sin autenticación, y no permiten mandar una cabecera con tu llave. Cuando TuAsistente tenga la conexión con inicio de sesión, lo podrás conectar desde ChatGPT. Mientras tanto, usa la API o el CLI.

Otros clientes MCP

Funciona cualquier cliente que se conecte a servidores MCP remotos por HTTP y te deje agregar cabeceras. Necesitas estos datos:

Dirección: https://mcp.tuasistente.co/mcp
Transporte: HTTP (Streamable HTTP)
Cabecera: Authorization: Bearer ta_pk_…

Muchos clientes usan un archivo de configuración parecido a este. El nombre de los campos cambia entre clientes: revisa la documentación del tuyo.

json

{
  "mcpServers": {
    "tuasistente": {
      "type": "http",
      "url": "https://mcp.tuasistente.co/mcp",
      "headers": {
        "Authorization": "Bearer ta_pk_EJEMPLO…"
      }
    }
  }
}

Si tu cliente solo acepta inicio de sesión (OAuth) y no deja agregar cabeceras, todavía no puede conectarse a TuAsistente.