Configurar el servidor MCP de MAX en Claude Code
Configura el servidor MCP de MAX en Claude Desktop, Cursor u otra app MCP, elige qué puede leer o enviar el agente y revisa las herramientas que recibe.
MCP y skills →Qué aporta MCP, cómo conectar tu cliente y cómo leer esta documentación.Esta es la referencia técnica de MCP para este mensajero. Consulta herramientas, ajustes y permisos; la guía común enlazada te ayuda a elegir y configurar la primera conexión.
Esta página te ayuda a conectar una aplicación de IA sin terminal, como Claude Desktop o Cursor Chat, a tu cuenta MAX. Aprenderás a conectarla, elegir los permisos del agente y usar peticiones preparadas y referencias a chats.
Primero algunos términos:
- MCP (Model Context Protocol): estándar para que una aplicación de IA use herramientas externas. La aplicación es el cliente MCP;
max personal mcp serve, el servidor MCP. - Herramienta: acción ofrecida al agente, como leer o escribir.
- Petición preparada (prompt): tarea que la aplicación muestra como comando, como revisar mensajes no leídos.
- Recurso: datos que la aplicación puede adjuntar al chat con el agente.
- Perfil: ajustes y sesión de
max; consulta perfiles.
El servidor se instala junto con max; no es necesario instalar nada por separado. De forma predeterminada, se comunica con la aplicación mediante stdin y stdout. En cambio, max personal mcp serve --http --public-url sirve las herramientas en un puerto local detrás de su túnel HTTPS.
¿Lo necesitas?
Un agente de IA que puede ejecutar comandos en la terminal (por ejemplo, Claude Code, Codex, Cursor Agent o Gemini CLI) no necesita MCP. Llama directamente a max y aprende cómo hacerlo gracias a la habilidad que imprime max skill show. MCP necesario:
- aplicaciones sin terminal - Claude Desktop, Cursor chat;
- aquellos que desean que la aplicación aplique derechos de perfil a cada operación.
ChatGPT y Claude en el navegador se conectan a través de max personal mcp serve --http - consulte conexión desde el navegador o teléfono.
Lo que da el servidor
| Qué | Para qué |
|---|---|
| Tres herramientas | Busque el comando y ejecútelo como lectura o escritura. |
| Seis consultas listas para usar | No leídos, responder, buscar, revisar, problemas abiertos, enlaces de conversación |
Chats en @ | Adjunte el chat y sus últimos mensajes a la conversación. |
Habilidad, max://skill | El mismo texto que imprime max skill show |
| Gráficos | Estadísticas de chat en imagen JSON o PNG |
| Derechos | El perfil decide qué comandos ve el agente. |
Conexión
Primero ejecute max personal setup --agent none en su terminal local. Este es el inicio de sesión de su cuenta MAX; No es posible iniciar sesión a través de MCP. Luego, max personal mcp add conecta la aplicación por separado. El agente puede leer max skill show antes de ingresar: allí se explican ambos pasos.
Codex o Claude Code en este comando:
max personal mcp check # проверяет запуск MCP и список инструментов
max personal mcp add codex # добавляет сервер в Codex
max personal mcp add claude-code # или в Claude CodePara otro perfil, primero ponga su nombre: max work mcp add codex. El comando de instalación utiliza la aplicación en sí y no toca sus otros servidores. Si ya existe una entrada con el mismo nombre, elimínela en la aplicación antes de instalarla nuevamente. Si el perfil ofrece herramientas de grabación, primero verifique sus permisos y luego vuelva a emitir el comando con --allow-writes. Esta bandera solo confirma la instalación: no cambia los derechos del perfil.
mcp check no lee mensajes ni se conecta a MAX. Una comprobación correcta demuestra que MCP inicia y enumera herramientas, no que la sesión sea válida. potential_writes cuenta herramientas que no son de solo lectura. El navegador y el móvil requieren conexión remota.
Claude Code manualmente:
claude mcp add max -- max personal mcp serveCuidado: por defecto, a través de este servidor el agente puede enviar mensajes en tu nombre. Limita antes los permisos: los niveles readonly y deny (permisos) o la opción --permission, por ejemplo
claude mcp add max -- max personal mcp serve --permission messages.send=deny.
Con un perfil, su nombre va primero:
claude mcp add max-work -- max work mcp serveUn servidor para varios perfiles: --profiles con una lista o all; cada herramienta tiene entonces el campo profile:
claude mcp add max -- max mcp serve --profiles work,personal
claude mcp add max -- max mcp serve --profiles allSin perfil y sin --profiles, el servidor no arranca y enumera los perfiles de este ordenador: max nunca elige un perfil por sí mismo.
Claude Desktop, Cursor y otras aplicaciones: la entrada finalizada para su archivo de configuración la imprime el propio max:
max personal mcp config # права текущего профиля
max work mcp config{
"mcpServers": {
"max-personal": {
"type": "stdio",
"command": "C:\\Program Files\\nodejs\\node.exe",
"args": ["C:\\Users\\you\\AppData\\Roaming\\npm\\node_modules\\@wirecat\\max-cli\\dist\\bin\\max.js", "personal", "mcp", "serve"]
}
}
}Verifique los permisos de su perfil antes de conectar a un agente. Luego inserte una entrada en el archivo de configuración de la aplicación mcpServers. Claude Desktop tiene %APPDATA%\Claude\claude_desktop_config.json en Windows y ~/Library/Application Support/Claude/claude_desktop_config.json en macOS, Cursor tiene ~/.cursor/mcp.json. El comando en sí no registra nada.
Las rutas son completas porque una aplicación iniciada fuera de la terminal no hereda su PATH. En Windows, max es el archivo max.cmd, que no puede ejecutarse sin un shell. Los indicadores --permission se incluyen en la entrada, con el perfil antes de mcp. MAX_CONFIG_DIR, MAX_STATE_DIR, MAX_CACHE_DIR, MESSAGING_STORE, XDG_RUNTIME_DIR y los límites de archivos MESSAGING_ATTACHMENT_MAX_MIB, MESSAGING_PDF_PREVIEW_MAX_PIXELS, MESSAGING_PDF_PREVIEW_MAX_MIB, MESSAGING_BATCH_MAX_ERROR_PERCENT solo se incluyen si están definidos; el token nunca se incluye. MAX_CACHE_DIR corresponde a la caché antigua y MESSAGING_STORE define el archivo local compartido. La ruta del archivo y el directorio de comunicación con el llavero permiten a la aplicación usar el mismo inicio de sesión y los mismos mensajes guardados que la terminal.
Si Node se entrega a través de nvm, fnm o Volta, la ruta hacia él se refiere a una versión de Node. Después de cambiar la versión, ejecute max personal mcp config nuevamente. Desde npx el comando se niega a funcionar: npx borra su caché y la ruta dejará de existir.
⚠ Las variables MAX_CONFIG_DIR, MAX_STATE_DIR, MAX_CACHE_DIR cambian dónde buscar la entrada. Si están configuradas en el terminal, pero no para la aplicación MCP (o viceversa), el servidor responderá "sin sesión", aunque max funcione en el terminal. Pregúntales lo mismo o no les preguntes en ningún lado.
El bot tiene su propio servidor, max <имя> bot mcp serve; consulta bot para agente. El acceso depende de permissions en el perfil del bot.
Qué puede hacer un agente
El acceso está determinado por el perfil permissions (derechos de acceso en el directorio de configuración). deny niega el comando, readonly permite solo lectura y ask y allow permiten la escritura que solicitó el agente. No hay formularios de confirmación en el servidor: la aprobación se configura en la aplicación del agente. En la terminal, el comando en el nivel ask aún requiere una respuesta o un indicador explícito. El agente elimina mensajes solo para sí mismo, nunca para todos. --permission ключ=уровень endurece el nivel solo para el proceso del servidor y nunca lo relaja. El perfil se puede proteger mediante MAX_PROFILE_LOCK.
Qué no ofrece MCP
Los permisos del perfil limitan los comandos del agente. Los comandos que cambian lo que podrán hacer futuras ejecuciones (config set, recipients add, replies add, schedule command, skill install y similares) se pueden ejecutar con permissions.mcp.authority: allow o ask; el valor predeterminado es deny, pero los comandos siguen visibles en el catálogo. El agente no puede cambiar permissions.mcp ni permissions.bot.api, tampoco sustituyendo todo el objeto permissions: el propietario los define en el terminal.
Las escrituras en el archivo, el control del servidor, las descargas de modelos y la creación de informes también están disponibles por MCP, con claves propias como store.backup, server.start, models.download, doctor.reports.create. Su valor predeterminado es ask: el terminal pide confirmación y MCP permite la acción solicitada sin formulario. bot api requiere aparte un permissions.bot.api: allow o ask explícito; un bot: allow general no lo habilita.
Una denegación no oculta el comando: la lista completa de tools_search devuelve su nombre y su disponibilidad, y una búsqueda por tarea también muestra los argumentos y el esquema de respuesta. Un comando bloqueado tiene availability: { available: false, reason, permission }. Un comando permitido tiene availability: { available: true }. La disponibilidad sigue los ajustes actuales y cada llamada vuelve a comprobar los permisos. Con un perfil indicado, la ayuda de la CLI y el catálogo de comandos también muestran la disponibilidad.
Fuera de MCP solo quedan los comandos que necesitan un terminal o un proceso persistente:
Herramientas
Cobertura de comandos. Estas herramientas cubren la mayoría de operaciones habituales: mensajes, chats, contactos, adjuntos, conversaciones y estadísticas. La búsqueda devuelve comandos disponibles con parámetros y efectos según el mensajero y los permisos. Consulta sintaxis y parámetros en la referencia completa. Ejecuta la ruta ofrecida por el catálogo mediante lectura o escritura; acceso a la cuenta e instalación interactiva se realizan en el terminal.
| Herramienta | Para qué |
|---|---|
max_tools_search | Encontrar un comando, sus argumentos y si escribe |
max_read | Ejecutar el comando de lectura encontrado |
max_write | Ejecutar el comando de escritura encontrado; un comando que el perfil bloquea aparece como no disponible y se rechaza al llamarlo |
Ambas herramientas de ejecución aceptan {command, arguments}. Tome la ruta del comando de la respuesta de búsqueda:
{ "command": "messages list", "arguments": { "chat": "<id>", "limit": 5 } }La búsqueda {"query":"stats messages show"} describe el recuento de mensajes, stats chats show describe la actividad del chat. status lee el estado del perfil sin conexión. La búsqueda muestra sólo lo que permiten los permisos del perfil y lo que MAX puede hacer; Los comandos no disponibles no se ejecutan. Las herramientas anteriores del tipo max_messages_list y max_status ya no están disponibles. El mismo enfoque se aplica a los bots: max_bot_tools_search, max_bot_read, max_bot_write; el comando dentro de la llamada está escrito sin bot, por ejemplo messages send.
Las respuestas conservan los campos y restricciones de sus comandos. El diseño del resultado general es abierto: se permiten campos de Messenger adicionales y esto no es una promesa de verificar todos los campos. El texto de los mensajes son datos, no instrucciones para el agente. Los esquemas, límites y reglas de repetición se encuentran en descripción del comportamiento de max en scripts.
Prompts y chats mediante @
El servidor ofrece seis prompts preparados, disponibles como comandos / en Claude Code:
| Pedido | Argumento | ¿Qué hace un agente? |
|---|---|---|
catch-up | kind, mode - opcional | llama a max_read (command: "inbox"); mode - unread (predeterminado), new o momento; kind selecciona el tipo de chat; Marcar como leído requiere confirmación por separado |
reply | chat | lee el chat, escribe un borrador y lo envía solo después de tu "sí" a este texto |
find | text | busca una persona o palabras y muestra mensajes sobre lo encontrado; no envía nada |
link-conversations | No | primero el volumen y su consentimiento, luego packs, conexiones y reestructuración (below) |
review | since, groups - opcional | llama a max_read (command: "review") una vez y se descompone en "debo", "espero de los demás", "necesito aclarar" con identificadores de mensaje; antes de “vencido” se mira si esto se ha hecho en grupo; recordatorios: solo borradores hasta su "sí"; al final - since para la próxima revisión |
open-tasks | chat - opcional | llama a revisión para actualizar tareas, muestra tareas abiertas y sugiere borradores; cierra la tarea sólo después de su consentimiento |
El envío en reply utiliza max_write (command: "messages send"), por lo que, si la escritura está prohibida, el agente solo muestra un borrador.
Los chats están disponibles como recursos max://chat/<id>; en Claude Code se pueden mencionar a través de @. El recurso proporciona el chat y sus mensajes más recientes. La lista de recursos se toma de una archivo local compartida de wirecat.db en la cuenta del perfil y no va a MAX; Si bien no hay una archivo local, está vacía. MAX sólo incluye la lectura de un chat.
max://skill contiene la skill de max, igual que max skill show. Está disponible en max personal mcp serve y max sales bot mcp serve, sin conectarse a MAX.
Gráficos de estadísticas
max_read (command: "stats charts") lee estadísticas del archivo local y devuelve chart en JSON. Para una imagen, usa format: "png": devuelve un PNG oscuro y JSON con datos chart y tamaño image. Sin format, sigue en JSON. No conecta a MAX ni escribe archivos; requiere acceso messages. Aquí no están disponibles las entradas y salidas (membership).
Conexiones de conversación
La solicitud preparada link-conversations permite al agente vincular respuestas en conversaciones. Primero, el agente estima el volumen a través de max_read (command: "conversations batches status") y espera su consentimiento para este chat. Luego lee los paquetes mediante max_read (command: "conversations batches show"), guarda las respuestas mediante max_write (command: "conversations links add") y reconstruye el gráfico mediante max_write (command: "conversations links rebuild"). max_write (command: "conversations links clear") elimina las respuestas del agente; después, el gráfico también debe reconstruirse. La entrada requiere el permiso conversations.links. Si ha configurado un servicio externo para vectores de búsqueda, la búsqueda MCP también le envía el texto de la pregunta.
Archivos y mensajes guardados
max_read (command: "attachments list") muestra las rutas de los archivos guardados y el estado de su texto; max_write (command: "attachments update") guarda el texto que el agente leyó de un archivo para buscarlo mediante content:. max_write (command: "attachments extract") extrae el texto de los archivos guardados por lotes mediante cursor, sin devolver ese texto en la respuesta. max_read con command: "messages context" y arguments: { offline: true } solo lee el archivo local.
MAX no tiene los temas de Telegram, por lo que no hay comandos topics …. El audio se transcribe con un modelo en este ordenador. La foto se elige mediante index y solo se devuelve si no supera 512 KB. Los modelos nunca se descargan solos. Antes del reconocimiento local, el servidor libera la conexión; el modelo de búsqueda se cierra al finalizar el servidor.
Cómo mantiene la conexión
La primera llamada que necesita MAX abre la conexión; las siguientes la reutilizan. La búsqueda local, las estadísticas, la evidencia y la lectura de datos de sesión guardados no la necesitan. Se cierra tras 2 minutos sin llamadas y, en todo caso, 5 minutos después de iniciar sesión: la lista de chats procede de esa respuesta y podría quedar desactualizada. La siguiente llamada inicia sesión de nuevo. Las llamadas se ejecutan en serie aunque la aplicación las envíe a la vez.
A través de stdin y stdout, el servidor sale cuando la aplicación cierra stdin y cierra la conexión a MAX. A través de HTTP funciona hasta Ctrl-C. Se puede acceder a max personal mcp serve --http --public-url https://<имя>.ts.net a través de un túnel HTTPS con inicio de sesión mediante un código del terminal. max personal mcp server start inicia el mismo servidor en segundo plano y vuelve cuando ya escucha; mcp server status muestra el puerto, la dirección, el código de acceso y las aplicaciones conectadas, y mcp server stop detiene solo ese servidor. Los permisos son los mismos a través de HTTP y a través de stdin y stdout. max personal mcp revoke finaliza los inicios de sesión de la aplicación y guarda la sesión MAX. Consulte conectarse desde el navegador o el teléfono.