# Conecta Claude Code, Codex o Cursor a tu mensajería (/es/docs/agents)

Conecta tu agente al mensajero para encontrar mensajes, reunir contexto y preparar respuestas. Esta página es para quien conecta un agente de terminal, un chat en el navegador o el móvil, o una aplicación MCP. Aquí elegirás cómo conectarlo, configurarás la conexión, encontrarás los skills y comprobarás el resultado. Después podrás pedir tu primera tarea útil.

**En esta página:**

1. [Qué es un agente y cómo usa la herramienta](#qué-es-un-agente-y-cómo-usa-la-herramienta)
2. [Dónde quieres usar el agente](#dónde-quieres-usar-el-agente)
3. [Conecta las instrucciones](#conecta-las-instrucciones)
4. [Comprueba si está todo listo](#comprueba-si-está-todo-listo)
5. [Notas para tu agente](#notas-para-tu-agente)
6. [Dónde conseguir los skills de WireCat](#dónde-conseguir-los-skills-de-wirecat)
7. [Para aplicaciones de chat y agentes remotos](#para-aplicaciones-de-chat-y-agentes-remotos)
8. [MCP y skills](#mcp-y-skills)
9. [Usar desde la web o el móvil](#usar-desde-la-web-o-el-móvil)
10. [Empieza tu primera tarea](#empieza-tu-primera-tarea)

## Qué es un agente y cómo usa la herramienta [#qué-es-un-agente-y-cómo-usa-la-herramienta]

Un **agente de IA** es un programa que utiliza herramientas para realizar una petición. Puede encontrar mensajes y resumirlos. Tú describes la tarea; el agente elige las acciones.

Una **CLI** es una herramienta de línea de comandos: se controla con instrucciones de texto. Un agente con terminal la ejecuta en tu ordenador o servidor, igual que lo harías tú en una terminal. Un **skill** enseña los comandos al agente, así que no necesitas memorizarlos. Las aplicaciones que no pueden ejecutar programas tienen su propia vía [al final de esta página](#chat-apps-and-remote-agents).

## Dónde quieres usar el agente [#dónde-quieres-usar-el-agente]

- **[En ChatGPT, Claude u otro chat de IA en el navegador o móvil](/llms.mdx/docs/es/browser-apps/content.md)** — Sigue la guía de navegador y móvil.
- **[En Codex, Claude Code, Cursor, Gemini CLI, Hermes u OpenClaw con terminal](#connect-instructions)** — Conecta la herramienta abajo.
- **[Mi aplicación no puede ejecutar comandos, o mi agente trabaja en otro ordenador](#chat-apps-and-remote-agents)** — Mira las otras vías, incluida una conexión MCP opcional.
- **[Quiero comprobar una conexión existente](#check-connection)** — Pide la cuenta y los chats.
- **[La herramienta o cuenta no están configuradas](/llms.mdx/docs/es/installation/content.md)** — Empieza por instalación e inicio de sesión.

## Conecta las instrucciones [#conecta-las-instrucciones]

Los ejemplos usan `tg` para Telegram. Para MAX cambia `tg` por `max` y el nombre del skill `tg-cli` por `max-cli`. Se aplica a todos los ejemplos y notas.

### Primera conexión [#primera-conexión]

Ejecuta un comando en el terminal del ordenador donde trabaja el agente. Conecta la cuenta e instala las instrucciones:

```sh
tg personal setup --agent codex
```

Cambia `codex` por `cursor`, `claude` o `gemini`. Sin `--agent`, la configuración te permite elegir. Para Hermes, OpenClaw u otro agente, usa `none` y sigue la nota correspondiente abajo.

### Cuando el agente inicia la sesión [#cuando-el-agente-inicia-la-sesión]

Un agente no tiene terminal en la que dibujar un código QR ni desde la que abrir un navegador, así que cada herramienta imprime lo que necesitas como texto y el agente te lo pasa en el chat. Cambia `personal` por el nombre de tu perfil.

- **Telegram y MAX:** el agente ejecuta `tg personal session start qr` o `max personal session start qr` en segundo plano, porque el comando espera tu escaneo y una herramienta de shell no muestra nada hasta que termina. Sin terminal, la herramienta imprime el código QR como texto. El agente lo pega en el chat como bloque de código, tal como se imprimió, y tú lo escaneas con la app de Telegram o MAX en el teléfono. Cuando Telegram renueva el código, el agente pega el nuevo y dice que el anterior caducó.
- **Los códigos de MAX caducan rápido:** un código QR de MAX dura unos 2 minutos, así que el agente lo pega enseguida. Cuando caduca, el agente vuelve a ejecutar el comando para obtener uno nuevo.
- **Zoom:** sin terminal, `zm personal session start` imprime `Open this URL to approve Zoom login:` y la URL. El agente te da la URL como enlace. Ábrela en un navegador de este mismo ordenador, porque Zoom responde a un receptor que está aquí.
- **Google Drive:** `drive personal session start` siempre imprime su URL de acceso a Google y además intenta abrir un navegador. Si no se abre ninguno, el agente te da la URL impresa como enlace para abrirla en este mismo ordenador.
- **Google Calendar:** `gcal personal session start` siempre imprime `Open Google sign-in:` y la URL, y además intenta abrir un navegador. Si no se abre ninguno, el agente te da la URL como enlace para abrirla en este mismo ordenador. Inicia sesión con la aplicación de Google de WireCat salvo que le des tu propio cliente. Consulta la [configuración de Google Calendar](/llms.mdx/docs/es/gcal/configuration/content.md#your-own-google-client).

El acceso con número de teléfono, la contraseña de verificación en dos pasos y el primer registro de tu app de Telegram siguen necesitándote en una terminal.

### La cuenta ya está conectada [#la-cuenta-ya-está-conectada]

`tg personal setup` con un agente elegido ya instaló el skill. Si tu agente ya ve `tg-cli`, puedes saltarte este paso. Una instalación global de `tg`, `max` o `memo` con npm añade el skill solo cuando `TG_INSTALL_AGENT`, `MAX_INSTALL_AGENT` o `MEMO_INSTALL_AGENT` nombra un agente (`all`, `claude`, `codex`, `cursor` o `gemini`). El instalador de Windows de un solo comando para `tg` y `max` lo añade salvo que pases `-Agent none`. `zm` y `drive` instalan un skill solo cuando se pide: tras `npm install -g`, ejecuta `zm skill install` o `drive skill install`. Para añadir o actualizar las instrucciones sin repetir el inicio de sesión:

```sh
tg skill install
```

Un **skill** es un archivo que enseña al agente a usar la herramienta. No contiene tu acceso al mensajero. Inicia una conversación nueva después.

Dónde busca cada agente el archivo del skill:

- **Codex, Cursor Agent, Gemini CLI**: `~/.agents/skills/tg-cli/SKILL.md`; solo para ellos, `tg skill install --for agents`.
- **Claude Code**: `~/.claude/skills/tg-cli/SKILL.md`; solo para él, `tg skill install --for claude`.
- **Hermes**: `~/.hermes/skills/tg-cli/SKILL.md`; guarda la salida de `tg skill show`, ver [Hermes](#hermes).
- **OpenClaw**: `~/.agents/skills/tg-cli/SKILL.md`; `tg skill install --for agents`, ver [OpenClaw](#openclaw).

`~` es tu carpeta personal, también en Windows. Sin `--for`, `skill install` escribe las dos
copias: en `.agents` y en `.claude`. También puedes conseguir los skills en un directorio de skills,
como ClawHub o skills.sh: [Dónde conseguir los skills de WireCat](#dónde-conseguir-los-skills-de-wirecat).

**Después de actualizar la herramienta, vuelve a ejecutar `tg skill install`**, para que las
instrucciones correspondan a la nueva versión. Para Hermes, o cualquier archivo guardado a mano, vuelve a
guardarlo desde `tg skill show`. Si el agente define `AI_AGENT` o `CLAUDECODE`, la herramienta le avisa como
máximo una vez al día cuando su copia del skill falta o es más antigua que la herramienta. El aviso
va a stderr, así que la salida JSON sigue siendo utilizable.

## Comprueba si está todo listo [#comprueba-si-está-todo-listo]

```text prompt
Usa tg CLI. Lee las instrucciones con tg skill show, muestra la cuenta conectada y cinco chats recientes. Solo lee: no envíes nada ni marques mensajes como leídos.
```

La cuenta y los chats deben ser tuyos. Después sigue con [Primeras tareas](/llms.mdx/docs/es/first-tasks/content.md).

### Si no funciona [#si-no-funciona]

- **El agente no encuentra `tg`.** Pídele que ejecute `tg --version`. Si falla, el terminal del
  agente no ve la herramienta instalada. Abre un terminal nuevo, o reinicia el agente o el editor
  después de instalar Node.js y la herramienta. En Windows, consulta
  [qué cambia el instalador](/llms.mdx/docs/es/installation/content.md#what-the-windows-installer-changes). Otras causas:
  [solución de problemas de Telegram](/llms.mdx/docs/es/tg/troubleshooting/content.md) ·
  [solución de problemas de MAX](/llms.mdx/docs/es/max/troubleshooting/content.md#max-%D0%BD%D0%B5-%D0%BD%D0%B0%D1%85%D0%BE%D0%B4%D0%B8%D1%82%D1%81%D1%8F-%D0%BF%D0%BE%D1%81%D0%BB%D0%B5-%D1%83%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BA%D0%B8).
- **El agente dice «no session».** La herramienta se ejecuta, pero no encuentra el acceso. Inicia
  sesión con `tg personal setup` en el mismo entorno y perfil que usa el agente: el mismo usuario del
  ordenador, el mismo nombre de perfil y las mismas variables de carpetas, como `TG_CONFIG_DIR`,
  si las definiste. Detalles:
  [Telegram](/llms.mdx/docs/es/tg/troubleshooting/content.md#no-session-for-profile-personal--run-tg-personal-setup-in-a-local-terminal) ·
  [MAX](/llms.mdx/docs/es/max/troubleshooting/content.md#no-session-for-profile-personal).

## Notas para tu agente [#notas-para-tu-agente]

Aquí solo se explican pasos adicionales de cada aplicación. El comando principal es común.

### Codex [#codex]

Usa Codex en local, en su CLI o en la extensión del IDE. Selecciona `$tg-cli` en la conversación.
Si no aparece, abre una nueva conversación o reinicia Codex. [Guía de Codex](https://learn.chatgpt.com/docs/build-skills).

### Cursor [#cursor]

Usa **Agent** con acceso a la terminal y pídele que use la herramienta. Puedes elegir `tg-cli` con
`/` en el chat de Agent. Si no aparece, reinicia Cursor o pide al agente que lea `tg skill show`.
[Guía de Cursor](https://cursor.com/help/customization/skills).

### Claude Code [#claude-code]

Usa `/tg-cli` en una nueva sesión local.
[Guía de Claude Code](https://code.claude.com/docs/en/skills).

### Gemini CLI [#gemini-cli]

Comprueba los skills disponibles con `gemini skills list`. En una sesión abierta,
`/skills reload` actualiza la lista. [Guía de Gemini](https://geminicli.com/docs/cli/skills/).

### Hermes [#hermes]

**Instala el skill.** Hermes Agent lee los skills de `~/.hermes/skills`. Pide a Hermes que guarde la
salida exacta de `tg skill show` en `~/.hermes/skills/tg-cli/SKILL.md`, conservando el frontmatter y
el texto en UTF-8. En macOS o Linux puedes hacerlo tú:

```sh
mkdir -p ~/.hermes/skills/tg-cli
tg skill show > ~/.hermes/skills/tg-cli/SKILL.md
```

Hermes también puede instalar el skill desde este sitio; las demás fuentes están en
[Dónde conseguir los skills de WireCat](#hermes-agent):

```sh
hermes skills install well-known:https://wirecat.dev/.well-known/skills/tg-cli
```

Si Hermes se detiene en una advertencia de su revisión de seguridad, no fuerces la
instalación: [avísanos](https://github.com/WireCatLabs/cli-docs/issues) con el hallazgo. Después abre una nueva sesión y repite la comprobación de
arriba. El terminal de Hermes debe tener la herramienta y el mismo acceso a la cuenta.

**En un solo paso:** `tg skill install --for hermes`. Pone el skill en `~/.agents/skills` y añade esa
carpeta a `skills.external_dirs` en los ajustes de Hermes; si eso falla, guarda una copia en
`~/.hermes/skills` y dice qué hizo. Antes de ejecutarlo, borra la copia
que guardaste en `~/.hermes/skills/tg-cli`, o ejecuta `hermes skills uninstall tg-cli` si lo
instalaste desde este sitio: Hermes prefiere esa carpeta, así que una copia antigua ocultaría la nueva.

**Si Hermes no encuentra `tg`.** Hermes ejecuta los comandos con el entorno de un `bash` de inicio de
sesión (`bash -l`), que guarda al empezar la sesión. Ese shell lee `~/.bash_profile` si existe, y si
no, `~/.profile`. No lee `~/.zshrc`. Si añadiste la carpeta de npm al `PATH` solo en `~/.zshrc`, copia
esa línea `export PATH=…` al archivo que lee bash, abre una nueva sesión de Hermes y pídele que
ejecute `tg --version`.

**Si hablas con Hermes desde un chat.** Su gateway te permite escribir a Hermes desde Telegram,
Discord y otros chats. Cualquiera que el gateway acepte puede pedir a Hermes que ejecute `tg` con tu
cuenta: leer tus chats o enviar mensajes en tu nombre. Deja solo a ti en su lista de usuarios
permitidos y considera un perfil que solo lea: consulta [Permisos](/llms.mdx/docs/es/configuration/content.md#permisos).
[Guía de Hermes](https://hermes-agent.nousresearch.com/docs/user-guide/features/skills/).

### OpenClaw [#openclaw]

**Instala el skill.** Con su carpeta de estado predeterminada, OpenClaw también lee
`~/.agents/skills`, así que basta con `tg skill install --for agents`. Si moviste esa carpeta con
`OPENCLAW_STATE_DIR`, pide a OpenClaw que guarde la salida exacta de `tg skill show` en
`skills/tg-cli/SKILL.md` dentro de ella. Comprueba que el skill esté disponible para tu agente y abre
una nueva sesión. La herramienta debe estar instalada en el ordenador o servidor donde se ejecuta
OpenClaw.

**Si OpenClaw no encuentra `tg`.** El servicio en segundo plano de OpenClaw arranca con un `PATH`
corto, como `/usr/local/bin:/usr/bin:/bin` en Linux, y la carpeta global de npm puede no estar en él.
Encuentra esa carpeta con `npm prefix -g`; en macOS y Linux los programas están en su subcarpeta
`bin`. Detén el gateway de OpenClaw, añade la carpeta y vuelve a iniciar el gateway:

```sh
openclaw config set tools.exec.pathPrepend '["/home/you/.npm-global/bin"]' --strict-json
```

Cambia la ruta por la tuya. El valor sustituye toda la lista, así que incluye las carpetas que ya
tuvieras ahí.

**Si hablas con OpenClaw desde un chat.** Sus canales (channels) conectan OpenClaw con Telegram,
WhatsApp, Discord y otros chats. Cualquiera que un canal acepte puede pedir a OpenClaw que ejecute
`tg` con tu cuenta: leer tus chats o enviar mensajes en tu nombre. Acepta solo a ti en sus ajustes de
emparejamiento (pairing) o lista de permitidos, y considera un perfil que solo lea: consulta
[Permisos](/llms.mdx/docs/es/configuration/content.md#permisos).
[Guía de OpenClaw](https://docs.openclaw.ai/tools/skills).

### Otro agente [#otro-agente]

Los ejemplos anteriores no son una lista cerrada. Cualquier agente con acceso a la línea de comandos puede usar la herramienta. Dale la salida de `tg skill show`, o la [documentación en Markdown](#documentación-para-tu-agente). Encuentra qué hacer con `tg guide`, que enumera escenarios paso a paso para tareas habituales, y `tg commands`, que enumera todos los comandos por secciones y marca los que cambian algo. Los mismos escenarios están en este sitio, una página por herramienta: [Telegram](/llms.mdx/docs/es/tg/scenarios/content.md), [MAX](/llms.mdx/docs/es/max/scenarios/content.md), [Zoom](/llms.mdx/docs/es/zm/scenarios/content.md), [Google Drive](/llms.mdx/docs/es/drive/scenarios/content.md), [Google Calendar](/llms.mdx/docs/es/gcal/scenarios/content.md) y [Memo](/llms.mdx/docs/es/memo/scenarios/content.md). `--help` tras un comando, como `tg chats list --help`, muestra sus opciones.

Un agente en la nube trabaja en otro ordenador. Instala allí la herramienta e inicia sesión; tu acceso local no está disponible para él.

Las opciones de instalación preparadas cubren clientes concretos; los demás usan sus propios ajustes de instrucciones o herramientas.

## Dónde conseguir los skills de WireCat [#dónde-conseguir-los-skills-de-wirecat]

Un **skill** es un archivo de instrucciones, `SKILL.md`, que enseña a tu agente de IA los comandos
de una herramienta de WireCat. Cada herramienta instala su propio skill con `skill install` (consulta
[Conecta las instrucciones](#connect-instructions)). Esta sección reúne los directorios de
skills que ofrecen los mismos skills, por si prefieres instalarlos y actualizarlos como lo hace tu
agente. Al terminar, tu agente tendrá el skill que necesita, desde la fuente que elijas.

Un skill solo enseña. La herramienta debe seguir instalada y con la sesión iniciada en el ordenador
donde trabaja tu agente: consulta [Instalación](/llms.mdx/docs/es/installation/content.md).

### Nombres de los skills [#nombres-de-los-skills]

Los ejemplos usan `tg` para Telegram. Para otra herramienta, cambia el repositorio y el nombre del skill:

- **Telegram** (`tg`): repositorio `WireCatLabs/tg-cli`, skill `tg-cli`
- **MAX** (`max`): repositorio `WireCatLabs/max-cli`, skill `max-cli`
- **WhatsApp** (`wa`): repositorio `WireCatLabs/whatsapp-cli`, skill `whatsapp-cli`
- **Google Drive** (`drive`): repositorio `WireCatLabs/drive-cli`, skill `drive-cli`
- **Notion** (`notion`): repositorio `WireCatLabs/notion-cli`, skill `notion-cli`
- **Yandex Disk** (`ydisk`): repositorio `WireCatLabs/ydisk-cli`, skill `yandex-disk-cli`
- **Google Calendar** (`gcal`): repositorio `WireCatLabs/gcal-cli`, skill `gcal-cli`
- **Mail** (`mail`): repositorio `WireCatLabs/mail-cli`, skill `mail-cli`
- **Bitrix24** (`b24`): repositorio `WireCatLabs/bitrix24-cli`, skill `bitrix24-cli`
- **amoCRM y Kommo** (`amo`): repositorio `WireCatLabs/amo-cli`, skill `amo-cli`
- **Asterisk** (`pbx`): repositorio `WireCatLabs/asterisk-cli`, skill `asterisk-cli`
- **Zoom** (`zm`): repositorio `WireCatLabs/zoom-cli`, skill `zoom-cli`
- **Memo** (`memo`): repositorio `WireCatLabs/cli-memo`, skill `cli-memo`

### Desde la propia herramienta [#desde-la-propia-herramienta]

Esta copia corresponde a la versión de la herramienta que instalaste. Sirve para Codex, Claude Code,
Cursor, Gemini CLI y OpenClaw:

```sh
tg skill install
```

Vuelve a ejecutarlo después de actualizar la herramienta.

### Hermes Agent [#hermes-agent]

Este sitio publica el skill de cada herramienta, en la versión que describen estas páginas, en un
índice de skills que Hermes lee. Instala un skill:

```sh
hermes skills install well-known:https://wirecat.dev/.well-known/skills/tg-cli
```

Hermes revisa cada skill antes de instalarlo. Si se detiene en una advertencia (caution), no fuerces la
instalación: [avísanos](https://github.com/WireCatLabs/cli-docs/issues) con el hallazgo que muestra.
`hermes skills search https://wirecat.dev --source well-known` los muestra todos. Hermes guarda la
fuente, así que `hermes skills update` actualiza el skill más adelante. Los clientes del formato de descubrimiento
más reciente leen los mismos skills en `https://wirecat.dev/.well-known/agent-skills/index.json`.

También puedes añadir el repositorio de una herramienta como fuente permanente de skills (un tap):

```sh
hermes skills tap add WireCatLabs/tg-cli
```

Una fuente de repositorio lee la rama principal (main), que puede ir por delante de la versión
publicada de la herramienta.
[Guía de Hermes](https://hermes-agent.nousresearch.com/docs/user-guide/features/skills/#skills-hub).

### OpenClaw y ClawHub [#openclaw-y-clawhub]

ClawHub es el directorio de skills de OpenClaw. Los skills de WireCat están allí, del editor `wirecat`:
`wirecat-tg`, `wirecat-max`, `wirecat-whatsapp`, `wirecat-zoom`,
`wirecat-memo` y `wirecat-drive`. Un comando instala un skill para todos los espacios de trabajo:

```sh
openclaw skills install @wirecat/wirecat-tg --global
```

Sin ClawHub, `tg skill install --for agents` da el skill a OpenClaw, porque OpenClaw lee
`~/.agents/skills`. [Guía de OpenClaw](https://docs.openclaw.ai/tools/skills).

### skills.sh [#skillssh]

El comando `skills` de skills.sh instala un skill desde un repositorio en las carpetas de los
agentes que encuentra en tu ordenador:

```sh
npx skills add WireCatLabs/tg-cli --skill tg-cli
```

Mantén `--skill`: algunos repositorios también contienen skills para quienes desarrollan la propia
herramienta. Igual que una fuente de repositorio de Hermes, lee la rama principal. [skills.sh](https://skills.sh/).

### Marketplace de plugins de Claude Code [#marketplace-de-plugins-de-claude-code]

**Próximamente.** Un marketplace de WireCat para Claude Code, con un plugin por herramienta que solo
contiene su skill. Cuando esté publicado, añádelo en Claude Code con:

```text
/plugin marketplace add WireCatLabs/claude-plugins
```

Mientras tanto, `tg skill install --for claude` instala el skill para Claude Code.
[Guía de plugins de Claude Code](https://code.claude.com/docs/en/plugins).

### Comprueba el resultado [#comprueba-el-resultado]

Abre una nueva sesión con el agente y haz la comprobación de
[Comprueba si está todo listo](#check-connection). Si el agente tiene el skill pero no puede
ejecutar la herramienta, consulta las notas para [Hermes](#hermes) y
[OpenClaw](#openclaw).

## Para aplicaciones de chat y agentes remotos [#para-aplicaciones-de-chat-y-agentes-remotos]

Todo lo anterior ejecuta directamente la herramienta de línea de comandos. Para un agente en el mismo
ordenador es la vía más rápida, y puedes ejecutar tú el mismo comando cuando algo no cuadre. **MCP**
es una conexión opcional para aplicaciones que no pueden ejecutar programas:

- **ChatGPT, Claude u otro chat en el navegador o en una app del móvil:** sigue la
  [guía de navegador y móvil](/llms.mdx/docs/es/browser-apps/content.md).
- **Una aplicación de escritorio con ajustes MCP, como Claude Desktop:** sigue la [configuración MCP](#cursor-y-claude-desktop).
- **Un agente en otro ordenador:** instala allí la herramienta e inicia sesión, como se explica en
  [Otro agente](#other-agents). Si solo puede llegar a tu ordenador a través de una conexión, usa la [configuración MCP](#mcp-y-skills).

El acceso no es una herramienta MCP: un agente que solo tiene MCP te pide que ejecutes tú el comando de inicio de sesión.

## MCP y skills [#mcp-y-skills]

### Qué es MCP [#qué-es-mcp]

**MCP (Model Context Protocol)** es un estándar abierto para conectar agentes de IA con
herramientas. Funciona como un enchufe universal: una aplicación compatible con MCP puede usar
un servidor MCP compatible sin una integración propia. El estándar está publicado en [modelcontextprotocol.io](https://modelcontextprotocol.io/).

Participan dos partes:

- El **cliente** es la aplicación donde trabaja tu agente, por ejemplo Claude Desktop, ChatGPT, Cursor o Gemini CLI.
  Pregunta al servidor qué herramientas hay y llama a una cuando tu petición la necesita.
- El **servidor** es `tg <perfil> mcp serve` o `max <perfil> mcp serve`, parte de la herramienta de línea de comandos. Se ejecuta
  en tu ordenador o en un servidor al que un chat del navegador llega por una dirección HTTPS pública.

Mediante MCP, la IA solo puede usar las herramientas que ofrece el servidor, y solo dentro de los
[permisos](/llms.mdx/docs/es/configuration/content.md#permisos) del perfil: un perfil de solo lectura no puede enviar. Conectar MCP no
inicia sesión en tu mensajero por ti; inicias sesión una vez con la herramienta de línea de comandos.
Tampoco descarga todo tu archivo.

Un agente con terminal, como Claude Code o Codex, no necesita MCP: puede ejecutar los comandos `tg` y
`max` directamente, y un **skill** le explica cómo. Un agente sin terminal, como el de Claude
Desktop o un chat del navegador, usa MCP. La [comparación de abajo](#cli-skill-o-mcp) te ayuda a elegir.

**¿Usas un chat de IA en el navegador o en el móvil?**

ChatGPT, Claude y otros chats web se conectan mediante una dirección HTTPS pública: sigue la [guía de navegador y móvil](/llms.mdx/docs/es/browser-apps/content.md).

### Qué hace el servidor MCP [#qué-hace-el-servidor-mcp]

Nuestro servidor da acceso al mensajero conectado: chats, mensajes, archivos adjuntos, búsqueda e informes. Tú pides un resultado; el agente llama una herramienta y el servidor realiza la acción.

El servidor está incluido en la herramienta de línea de comandos y **debe funcionar mientras el agente lo utiliza**. Una aplicación local puede iniciarlo en tu ordenador. Para navegador o móvil, se mantiene en un ordenador o servidor y se conecta con una dirección HTTPS pública y autenticación. Sigue la [guía de navegador y móvil](/llms.mdx/docs/es/browser-apps/content.md).

### Cómo encuentra y ejecuta acciones el agente [#cómo-encuentra-y-ejecuta-acciones-el-agente]

El servidor ofrece pocas herramientas: el agente descubre primero la acción y sus parámetros, y después la ejecuta. Para encontrar un acuerdo, descubre la búsqueda de mensajes, la ejecuta y abre los resultados.

Los ejemplos usan nombres de Telegram. Para MAX cambia `tg` por `max`, también en nombres de herramientas y ajustes.

| Herramienta | Función |
|---|---|
| `tg_tools_search` | Descubre la acción, parámetros y efectos. Busca acciones disponibles, no mensajes. |
| `tg_read` | Ejecuta una lectura: chats, búsqueda de mensajes, archivos o informes. |
| `tg_write` | Ejecuta cambios: enviar, guardar texto extraído o gestionar grupos según los permisos. |

### Qué hace un skill [#qué-hace-un-skill]

Un **skill** enseña al agente qué herramientas elegir, cómo reunir contexto, comprobar fuentes y preparar resultados. MCP permite ejecutar acciones; el skill explica cómo usarlas. No contiene credenciales.

Las instrucciones vienen con la herramienta. [Añádelas](#connect-instructions) con el comando de configuración; `tg skill show` muestra el texto. Con terminal, el agente puede seguirlas y ejecutar la CLI directamente.

### ¿CLI, skill o MCP? [#cli-skill-o-mcp]

| Conexión | Qué ofrece | Cuándo elegirla |
|---|---|---|
| CLI | Comandos de terminal con resultados JSON | Tu agente ya tiene una terminal local |
| Skill + CLI | Instrucciones de comandos y flujos de trabajo | Tu agente puede ejecutar comandos en la terminal, por ejemplo Codex, Cursor Agent, Claude Code, Gemini CLI, Hermes u OpenClaw |
| MCP | Herramientas con parámetros directamente en el cliente | Tu agente no tiene terminal, por ejemplo Claude Desktop, o prefieres su interfaz de herramientas |
| MCP por HTTP | Las mismas herramientas para un chat de IA en el navegador, como ChatGPT o Claude, tras tu propio túnel | Chateas en el navegador — [ChatGPT y Claude en el navegador](/llms.mdx/docs/es/browser-apps/content.md) |
| Markdown | Explicaciones y referencia de comandos | El agente necesita consultar cómo funciona algo |

Con una terminal, empieza con [un skill](#connect-instructions). MCP es opcional y respeta los mismos
permisos del perfil que el CLI. El inicio de sesión y la descarga del archivo se hacen por separado.

### Antes de conectar [#antes-de-conectar]

[Instala e inicia sesión](/llms.mdx/docs/es/installation/content.md). `tg personal mcp config` o `max personal mcp config`
muestra la configuración con las rutas reales de Node y del CLI. No edita el cliente.
El PATH de una aplicación de escritorio puede ser diferente del de la terminal.

El servidor atiende el perfil que nombras: `tg personal mcp serve`. Un servidor puede atender varios perfiles con
`tg mcp serve --profiles personal,work`, o todos con `--profiles all`; cada llamada a una herramienta indica entonces
su perfil. max funciona igual. Sin perfil ni `--profiles`, ninguno arranca el servidor. `tg mcp` o `max mcp` solo
muestra la ayuda.

#### Codex [#codex-1]

En una terminal donde ya funcione el comando:

```sh
tg personal mcp add codex
codex mcp list
```

Setup usa el comando propio de Codex y deja intactos los demás servidores. A mano, el equivalente es `codex mcp add tg -- tg personal mcp serve`.

Conecta solo los mensajeros que uses. Codex guarda MCP en `~/.codex/config.toml`.
Para Windows o un IDE con otro PATH, toma `command`, `args` y `env` de `mcp config` y añádelos
en `[mcp_servers.tg]` o `[mcp_servers.max]`. Codex utiliza TOML.
[Guía oficial de Codex MCP](https://learn.chatgpt.com/docs/extend/mcp?surface=cli).

#### Claude Code [#claude-code-1]

```sh
tg personal mcp add claude-code
claude mcp list
```

A mano, el equivalente es `claude mcp add --scope user tg -- tg personal mcp serve`. Si el perfil ofrece herramientas de escritura, setup te pide revisar antes sus [permisos](/llms.mdx/docs/es/configuration/content.md#permisos) y repetir con `--allow-writes`. Esa opción solo confirma la instalación; no cambia los permisos.

Comprueba el estado con `/mcp` en la sesión. Para rutas completas, usa los valores de `mcp config`.
[Guía oficial de Claude Code MCP](https://code.claude.com/docs/en/mcp).

#### Cursor y Claude Desktop [#cursor-y-claude-desktop]

Copia la entrada de `tg personal mcp config` o `max personal mcp config` en `mcpServers`, conservando las rutas
y el entorno. Combínala con los servidores que ya tengas.

| Cliente | Archivo |
|---|---|
| Cursor, personal | `~/.cursor/mcp.json` |
| Cursor, proyecto | `.cursor/mcp.json` |
| Claude Desktop, macOS | `~/Library/Application Support/Claude/claude_desktop_config.json` |
| Claude Desktop, Windows | `%APPDATA%\Claude\claude_desktop_config.json` |

Reinicia el cliente y comprueba las herramientas disponibles.
[Guía oficial de Cursor MCP](https://cursor.com/help/customization/mcp).

#### Gemini CLI [#gemini-cli-1]

```sh
gemini mcp add --scope user tg tg personal mcp serve
gemini mcp list
```

Para rutas completas y variables de entorno, añade la entrada generada en `mcpServers` de
`~/.gemini/settings.json`. [Guía oficial de Gemini MCP](https://geminicli.com/docs/tools/mcp-server/).

#### Hermes [#hermes-1]

Hermes usa `mcp_servers` en `~/.hermes/config.yaml`. Añade `tg` o `max` con `command`, `args`
y `env` de la configuración generada, conservando tus ajustes. Utiliza YAML: no pegues el objeto
JSON `mcpServers` entero. Reinicia Hermes.
[Inicio oficial de Hermes](https://hermes-agent.nousresearch.com/docs/getting-started/quickstart/).

### Zoom, Google Drive y Memo [#zoom-google-drive-y-memo]

Cada herramienta inicia su propio servidor. Conéctalo con el comando que tu cliente usa para servidores MCP:

- **Zoom:** `zm personal mcp serve`.
- **Google Drive:** `drive personal --read-only mcp serve`.
- **Notion:** `notion personal mcp serve`.
- **Yandex Disk:** `ydisk personal mcp serve`.
- **Google Calendar:** `gcal personal mcp serve`.
- **Mail:** `mail personal mcp serve`.
- **Bitrix24:** `b24 personal mcp serve`.
- **amoCRM y Kommo:** `amo work mcp serve`.
- **Asterisk:** `pbx office mcp serve`.
- **Memo:** `memo mcp serve`.

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

MCP cubre la mayoría de operaciones habituales: leer y buscar mensajes, consultar personas y grupos, trabajar con adjuntos, crear informes, responder y administrar grupos con permisos.

Consulta sintaxis y disponibilidad MCP en las referencias:

- [Herramientas y cobertura MCP de Telegram](/llms.mdx/docs/es/tg/mcp/content.md#tools) · [Comandos de Telegram](/llms.mdx/docs/es/tg/commands/content.md).
- [Herramientas y cobertura MCP de MAX](/llms.mdx/docs/es/max/mcp/content.md#%D0%B8%D0%BD%D1%81%D1%82%D1%80%D1%83%D0%BC%D0%B5%D0%BD%D1%82%D1%8B) · [Comandos de MAX](/llms.mdx/docs/es/max/commands/content.md).

El catálogo depende del mensajero y del perfil. Pide descubrir la acción: el resultado muestra comando y parámetros. Un perfil de solo lectura excluye cambios. El servidor no tiene un paso de confirmación propio: las confirmaciones las muestra la aplicación, y el servidor no puede comprobar que una persona las aceptó.

Después de conectar pide cinco chats recientes. Sigue con [Primeras tareas](/llms.mdx/docs/es/first-tasks/content.md).

### Documentación para tu agente [#documentación-para-tu-agente]

El MCP del mensajero accede a tu cuenta. La documentación se consulta por separado:

| Recurso | Qué compartir |
|---|---|
| [Índice](/llms.txt) | `https://wirecat.dev/llms.txt` — buscar una página y seguir su enlace Markdown |
| [Todas las páginas](/llms-full.txt) | `https://wirecat.dev/llms-full.txt` — referencia completa para herramientas que admitan documentos grandes |
| Una página | **Copiar Markdown** o **Abrir** en la cabecera |
| La propia herramienta | Para un agente que ejecuta la herramienta: `tg guide` enumera escenarios paso a paso y `tg commands`, todos los comandos por secciones |

Prueba: **«Lee https://wirecat.dev/llms.txt, busca la documentación de los mensajes entrantes
de Telegram y úsala para resumir mis mensajes sin leer».** Si no puede abrir URL, pega el Markdown
de la página en el chat.

Estas páginas Markdown se leen directamente. Da al agente el índice o la página necesaria; no hace falta otro servidor de documentación.

Si falla la conexión, comprueba las rutas, Node y que cliente y terminal usan el mismo perfil
y los mismos directorios. Los detalles están en la referencia MCP de [Telegram](/llms.mdx/docs/es/tg/mcp/content.md)
y [MAX](/llms.mdx/docs/es/max/mcp/content.md).

## Usar desde la web o el móvil [#usar-desde-la-web-o-el-móvil]

ChatGPT, Claude, Gemini y otros chats de IA en el navegador o el móvil no ejecutan programas en tu ordenador. Llegan a la herramienta mediante MCP y una dirección HTTPS pública. La guía [Usar desde la web o el móvil](/llms.mdx/docs/es/browser-apps/content.md) cubre la dirección, cómo añadir la conexión a tu chat, los permisos, la recuperación y un servidor siempre activo.

## Empieza tu primera tarea [#empieza-tu-primera-tarea]

Pide encontrar un acuerdo, resumir conversaciones o preparar un borrador: [Primeras tareas](/llms.mdx/docs/es/first-tasks/content.md). Si no encuentra la herramienta, comprueba la instalación y que el agente trabaja en el mismo ordenador. Para otro dispositivo, sigue la [guía de navegador y móvil](/llms.mdx/docs/es/browser-apps/content.md).
