# Configurar el servidor MCP de MAX en Claude Code (/es/docs/max/mcp)

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.

[Elegir cómo conectar](/llms.mdx/docs/es/agents/content.md#mcp-y-skills)

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](https://modelcontextprotocol.io)): 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](/llms.mdx/docs/es/max/profiles/content.md).

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? [#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](/llms.mdx/docs/es/max/remote/content.md).

## Lo que da el servidor [#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 [#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:**

```sh
max personal mcp check                 # проверяет запуск MCP и список инструментов
max personal mcp add codex           # добавляет сервер в Codex
max personal mcp add claude-code     # или в Claude Code
```

Para 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](/llms.mdx/docs/es/max/remote/content.md).

**Claude Code manualmente:**

```sh
claude mcp add max -- max personal mcp serve
```

Cuidado: 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](/llms.mdx/docs/es/max/permissions/content.md)) 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:

```sh
claude mcp add max-work -- max work mcp serve
```

Un servidor para varios perfiles: `--profiles` con una lista o `all`; cada herramienta tiene entonces el campo `profile`:

```sh
claude mcp add max -- max mcp serve --profiles work,personal
claude mcp add max -- max mcp serve --profiles all
```

Sin 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`:

```sh
max personal mcp config                  # права текущего профиля
max work mcp config
```

```json
{
  "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](/llms.mdx/docs/es/max/bot/content.md#%D0%B1%D0%BE%D1%82-%D0%B4%D0%BB%D1%8F-%D0%B0%D0%B3%D0%B5%D0%BD%D1%82%D0%B0-mcp). El acceso depende de `permissions` en el perfil del bot.

## Qué puede hacer un agente [#qué-puede-hacer-un-agente]

El acceso está determinado por el perfil `permissions` ([derechos de acceso en el directorio de configuración](/llms.mdx/docs/es/max/configuration-reference/content.md#%D0%BF%D1%80%D0%B0%D0%B2%D0%B0-%D0%B4%D0%BE%D1%81%D1%82%D1%83%D0%BF%D0%B0)). `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 [#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:

| Comandos | Motivo |
| --- | --- |
| `setup`, `session` | el inicio y cierre de sesión los realiza una persona |
| `complete` | autocompletado del terminal |
| `serve`, `watch`, `mcp`, `bot watch`, `bot mcp` | funcionan hasta detenerlos; una llamada del agente debe terminar |
| `bot auth` | una persona introduce el token |
| `account remove` | cerrar la sesión de la cuenta y eliminar el perfil lo decide el propietario, no el agente |
| `bot uploads put` | lee un archivo de tu equipo |

## Herramientas [#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](/llms.mdx/docs/es/max/commands/content.md). 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:

```json
{ "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](/llms.mdx/docs/es/max/cli-contract/content.md).

## Prompts y chats mediante `@` [#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 [#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 [#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 [#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 [#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](/llms.mdx/docs/es/max/remote/content.md).
