Saltar al contenido principal
Max tiene un servidor MCP (Model Context Protocol). Conectas Claude, Cursor, Grok o cualquier cliente compatible, y tu asistente de IA trabaja sobre tu organización de Max. Con él puedes:
  • Auditar y editar agentes: leer su configuración completa y ajustar tono, prompt y reglas.
  • Cargar contenido: crear y editar artículos, con ediciones puntuales.
  • Gestionar derivaciones, seguimientos e integraciones, incluso crear una integración custom completa.
  • Publicar, siempre con tu confirmación.
Los cambios de reglas, derivaciones, ajustes, seguimiento e integraciones de un agente, y conectar o desconectar artículos, van a su borrador. Nada de eso se publica sin tu confirmación: publicas tú en Publicar, o le confirmas a tu asistente después de que te muestre los cambios.Se aplican al instante, sin pasar por Publicar: el nombre del agente, el contenido de los artículos (afecta a todos los agentes que los usan) y las integraciones custom con sus acciones.

Antes de empezar

Hay un atajo. En la portada de cualquier agente, con el chat del asistente vacío, toca Claude y después Agregar a Claude: confirmas en Claude, inicias sesión en Max y eliges a qué organizaciones darle acceso, sin API key. Con Codex, toca Generar acceso: Max crea la key y te da el texto para pegar en Codex. Lo que sigue es el camino manual, que sirve para cualquier cliente MCP.
Hay dos formas de autenticarte:
  • Con tu cuenta (OAuth): Claude, Claude Code y Cursor te piden iniciar sesión en Max y elegir organizaciones. Una conexión sirve para varias organizaciones. Más detalle en Con tu cuenta (OAuth).
  • Con API key: un header Authorization: Bearer sk_…, una organización por key. Sirve para cualquier cliente MCP.
Para conectar con API key, necesitas una de tu organización: en la página Desarrolladores, toca Crear API key. Esa página todavía no está en el menú de Settings. Para llegar, entra a cualquier sección de Settings y reemplaza el final de la dirección por /settings/developers. La key completa (sk_…) se muestra una sola vez, así que guárdala en un lugar seguro. Cada key pertenece a una organización y solo accede a lo de esa organización.
Pantalla de API keys en Desarrolladores

Conectar tu cliente

El servidor vive en https://maxagente.com/api/mcp (transporte HTTP). Con API key, la key va como Bearer token. Con tu cuenta, configuras solo la URL.
Si ya agregaste Max en Claude con Agregar a Claude, ese conector también funciona en Claude Code, sin API key.
Para verificar la conexión, pídele a tu asistente que liste tus agentes. Debe llamar a list_agents y devolver los de tu organización.

Con tu cuenta (OAuth)

Claude, Claude Code y Cursor pueden conectarse con tu cuenta de Max en lugar de una API key. Configuras el servidor solo con la URL, sin el header Authorization. Al conectar, el cliente abre Max: inicias sesión, eliges a qué organizaciones darle acceso y tocas Permitir.
  • Una conexión, varias organizaciones. El asistente llama a list_workspaces para ver las organizaciones de la conexión y, en cada herramienta, pasa la que le indiques en el argumento workspace. Si la conexión tiene una sola, no hace falta.
  • Cada persona conecta la suya. La conexión usa tu cuenta, no la de la organización.
  • La sesión se renueva sola mientras la uses. Si pasan 90 días sin usarla, vuelves a iniciar sesión.
  • Claude: en el diálogo Claude del asistente cambias las Organizaciones con acceso. Quitar acceso lo corta en Max y abre Claude para que quites Max de tus conectores.

Herramientas

El servidor expone 38 herramientas. Las que operan sobre un agente reciben su agent_slug, que se obtiene con list_agents.

Casos de uso

Caso: mejorar al agente a partir de sus conversaciones reales. El ciclo es revisar fallas, proponer el arreglo, dejarlo en borrador, revisarlo y publicarlo tú, y volver a medir.
Revisa las conversaciones del último mes del asistente de ventas. Empieza por las que se derivaron a un humano (list_chats con escalated_only) y lee cada transcript. Clasifica las fallas en tres pilas: falta de contenido (no sabía la respuesta), falta de reglas (respondió con el tono o el criterio equivocado) y problemas de prompt. Para cada pila propón el fix concreto: crea o corrige los artículos con la información que faltó, agrega las reglas que hubieran evitado el error, y sugiéreme cambios de prompt. Aplica todo al borrador y dame un resumen de qué cambiaste y por qué. Yo lo reviso en Publicar.
Caso: revisar qué tiene configurado un agente y detectar huecos.
Lista mis agentes, trae la configuración completa del asistente de ventas y dime qué reglas le faltan comparado con las mejores prácticas de atención: saludo, precios, horarios y escalación a humano. No cambies nada todavía. Primero muéstrame el plan.
Caso: convertir un menú, catálogo o FAQ existente en contenido del agente.
Toma este PDF del menú, conviértelo a markdown prolijo y crea un artículo “Menú y precios” conectado al Asistente de Aromas. Si el artículo ya existe, actualízalo con ediciones puntuales en lugar de reemplazarlo entero.
Caso: aplicar un cambio de política a varios agentes.
Para cada agente de la organización: agrega una regla en “Contenido y fuentes” que diga que nunca prometa fechas de entrega sin confirmar con el equipo. Muéstrame el resumen de qué le agregaste a cada uno.
Caso: conectar una API interna sin escribir código.
Crea una integración custom “Turnos Clínica” apuntando a https://api.miclinica.com con auth por API key. Define dos acciones: buscar turnos disponibles por fecha y reservar un turno con nombre y teléfono. Después habilítasela al agente de recepción.

Seguridad

  • Una key, una organización. Las herramientas no ven ni tocan otras organizaciones. La key se revoca al instante desde la página Desarrolladores. Con tu cuenta (OAuth), la conexión accede solo a las organizaciones que elegiste.
  • Nada se publica sin tu confirmación. Las ediciones de un agente van a su borrador, salvo el nombre, el contenido de los artículos y las integraciones custom, que se aplican al instante. publish_agent trabaja en dos pasos: primero devuelve los cambios pendientes y un código de confirmación, y solo cuando le confirmas a tu asistente vuelve a llamarla con ese código. El código dura 10 minutos y cualquier edición posterior lo invalida, así que se publica lo mismo que viste.
  • Cuidado con otros servidores MCP. Si tu cliente tiene varios servidores conectados, activa la confirmación humana de herramientas. Un contenido de terceros podría inyectar instrucciones que terminen editando tus agentes.

Preguntas frecuentes

Sí, con tu confirmación. publish_agent primero devuelve los cambios pendientes y tu asistente te pregunta si publica. La versión se crea solo si le confirmas. Si el borrador cambia o pasan más de 10 minutos antes de tu respuesta, tiene que mostrarte los cambios de nuevo. También puedes publicar a mano desde Publicar.
Verifica que el header sea exactamente Authorization: Bearer sk_… y que la key no haya sido revocada. Las keys se crean en la página Desarrolladores y se muestran completas solo al crearlas.
Con tu cuenta (OAuth), una sola conexión alcanza: eliges las organizaciones al iniciar sesión y el asistente usa list_workspaces para trabajar en la que le indiques. Con API keys, crea una key en cada organización y configura un servidor MCP por key (por ejemplo max-ventas y max-soporte).
En Publicar, dentro del agente. Cada regla, derivación o ajuste editado aparece en el detalle de cambios, igual que una edición manual.

Sigue con

Asistente

El atajo para conectar Claude o Codex con un agente.

Publicar versiones

Revisa lo que cambió tu cliente MCP antes de publicarlo.