# Instala WireCat: CLI y servidor MCP para tu agente de IA (/es/docs/installation)

Conecta la información que quieres que use tu agente de IA: mensajes, notas, correo, documentos
o reuniones. Elige una herramienta, instálala donde tu agente pueda ejecutarla y comprueba un
resultado pequeño. No necesitas una cuenta de mensajería para empezar con archivos locales o
una transcripción descargada.

¿Ya está instalado y conectado? [Conecta tu agente](/llms.mdx/docs/es/agents/content.md) y
[prueba una primera tarea](/llms.mdx/docs/es/content.md#prueba-una-petici%C3%B3n). Una búsqueda vacía suele requerir
comprobar los datos disponibles antes de volver a instalar.

![Claude Code en un terminal instala una herramienta de WireCat con npm; WireCat Desktop muestra la pantalla Herramientas](/screenshots/install/install-and-connect-light-es.webp)

¿Prefieres no usar la terminal? [WireCat Desktop](/es/download) es una aplicación para macOS, Windows y
Linux. Instala y actualiza estas herramientas, instala Node.js si falta, da a tus agentes las skills de
las herramientas y abre el inicio de sesión de cada una. [Qué hace la aplicación](/llms.mdx/docs/es/desktop/content.md).

**En esta página:**

1. [Elige una herramienta](#elige-una-herramienta)
2. [Configura con tu agente](#configura-con-tu-agente)
3. [Configura a mano](#configura-a-mano)
4. [Node.js, npm y cómo encontrar el comando](#nodejs-npm-y-cómo-encontrar-el-comando)
5. [Comprueba el primer resultado útil](#comprueba-el-primer-resultado-útil)
6. [Datos, actualizaciones y trabajo en segundo plano](#datos-actualizaciones-y-trabajo-en-segundo-plano)

## Elige una herramienta

| Quieres usar | Instalación y conexión |
|---|---|
| Notas, archivos locales o correo | [Instalar Memo](/llms.mdx/docs/es/memo/installation/content.md); basta una carpeta para empezar: consulta [Markdown y Obsidian](/llms.mdx/docs/es/markdown/content.md) |
| Chats de Telegram | [Instalar Telegram](/llms.mdx/docs/es/tg/installation/content.md); para un bot, usa [su configuración](/llms.mdx/docs/es/tg/bot/content.md) |
| Chats de WhatsApp | [Instalar WhatsApp](/llms.mdx/docs/es/wa/installation/content.md); los números empresariales usan [Cloud API](/llms.mdx/docs/es/wa/bot/content.md) |
| Chats de MAX | [Instalar MAX](/llms.mdx/docs/es/max/installation/content.md); para un bot, usa [su configuración](/llms.mdx/docs/es/max/bot/content.md) |
| Documentos de Google Drive | [Instalar Drive](/llms.mdx/docs/es/drive/installation/content.md) desde npm, conectar Google y elegir una carpeta |
| Páginas y bases de datos de Notion | [Instalar Notion](/llms.mdx/docs/es/notion/installation/content.md) desde npm, luego [iniciar sesión con un token de Notion y copiar tus páginas](/llms.mdx/docs/es/notion/content.md#conecta-y-copia-tus-p%C3%A1ginas) |
| Archivos de Yandex Disk | [Instalar Yandex Disk](/llms.mdx/docs/es/ydisk/installation/content.md) desde npm, luego iniciar sesión con un token de Yandex y [copiar una carpeta](/llms.mdx/docs/es/ydisk/usage/content.md#sync) |
| Reuniones de Google Calendar | [Instalar Google Calendar](/llms.mdx/docs/es/gcal/installation/content.md) desde npm e iniciar sesión en Google con la aplicación de Google de WireCat, o con la tuya |
| Correo por IMAP | [Instalar Mail](/llms.mdx/docs/es/mail/installation/content.md) desde npm y crear antes una contraseña de aplicación para tu buzón |
| Reuniones o transcripciones de Zoom | [Instalar Zoom](/llms.mdx/docs/es/zm/installation/content.md); conectar una aplicación existente/nueva o importar VTT sin ella |
| Llamadas y transcripciones de Google Meet | [Instalar Google Calendar](/llms.mdx/docs/es/gcal/installation/content.md) e iniciar sesión con `--grant meetings`: consulta [Google Meet](/llms.mdx/docs/es/google-meet/content.md) |
| Un CRM de Bitrix24 | [Instalar Bitrix24](/llms.mdx/docs/es/b24/installation/content.md) desde npm y crear un webhook entrante o una aplicación local en tu portal |
| Un CRM de amoCRM o Kommo | [Instalar amoCRM](/llms.mdx/docs/es/amo/installation/content.md) desde npm, crear una integración privada en tu cuenta e iniciar sesión con su token |
| Llamadas de una centralita Asterisk o FreePBX | [Instalar y conectar Asterisk](/llms.mdx/docs/es/pbx/installation/content.md): instalarlo desde npm en tu propio ordenador y conectar los registros de llamadas y las grabaciones |

Cada guía incluye los comandos exactos, los pasos de acceso, las plataformas compatibles y la
resolución de errores. Una aplicación de Zoom usa un Public Client ID; una aplicación propia de
Google Drive puede usar un archivo JSON del cliente; Google Calendar inicia sesión con la aplicación
de Google de WireCat, o con el archivo JSON del cliente de tu propia aplicación de Google. Sigue la guía elegida: no hay un archivo
de credenciales común para todas las herramientas.

## Configura con tu agente

Usa un agente de IA (Un agente de IA que puede ejecutar comandos en tu ordenador, por ejemplo Claude Code, Codex, Cursor o Gemini CLI. Un chat en el navegador sin acceso a la terminal no puede instalar la herramienta de línea de comandos por ti.) con acceso a la terminal en este ordenador, como Claude Code, Codex, Cursor o Gemini
CLI. Indica la herramienta y la fuente elegidas y copia esta petición:

```text prompt
Ayúdame a configurar la herramienta WireCat elegida siguiendo su guía. Comprueba primero Node.js y npm.
Conecta solo la cuenta o carpeta elegida; yo aprobaré el acceso.
Instala las instrucciones para mi agente y prepara unos pocos datos.
Prueba una pregunta de solo lectura, muestra su fuente e indica los datos que faltan.
Explica dónde se guardan los datos y cómo detener el trabajo en segundo plano que inicies.
```

El agente prepara los programas y explica el siguiente paso. Tú apruebas el acceso en el inicio
de sesión del propio servicio. Cuando el agente inicia la sesión, te pega en el chat el código QR o el
enlace de acceso: consulta [cuando el agente inicia la sesión](/llms.mdx/docs/es/agents/content.md#agent-login). Sigue la guía
para el consentimiento en el navegador o el token de un bot; no pegues contraseñas, tokens ni respuestas
de autorización en el chat habitual.

Para un agente sin terminal, usa [MCP](/llms.mdx/docs/es/agents/content.md#mcp-y-skills) o [el acceso web y móvil](/llms.mdx/docs/es/browser-apps/content.md).
La herramienta sigue necesitando un ordenador que controlas.

## Configura a mano

1. **Elige el ordenador.** Lo más sencillo es empezar en tu equipo con Windows, macOS o Linux.
   Un servidor sirve para tareas recurrentes, pero sus sesiones y archivos se guardan allí.
   Una carpeta del portátil no aparece automáticamente en el servidor. No necesitas ambos.
2. **Comprueba el entorno** con los comandos de abajo. Después usa el comando de instalación
   de la guía elegida. Una herramienta de línea de comandos, o CLI, es un programa que el agente
   ejecuta mediante una terminal.
3. **Conecta la fuente.** Sigue sus pasos de acceso o importación. Instalar un paquete no autoriza
   una cuenta; iniciar sesión tampoco descarga todos sus datos.
4. **Conecta tu agente.** [Instala el skill o configura MCP](/llms.mdx/docs/es/agents/content.md). El skill da instrucciones
   a un agente con terminal; MCP expone capacidades a un agente compatible.
5. **Prepara los primeros datos y compruébalos.** Usa las comprobaciones siguientes antes de añadir fuentes.

## Node.js, npm y cómo encontrar el comando

Node.js (El programa que ejecuta herramientas como tg, max y memo en tu ordenador. Tu agente puede comprobar si está instalado y ayudarte a configurarlo.) ejecuta las herramientas; npm las instala.
Las líneas compatibles son **22.16+ dentro de 22.x, o 24+**; tg necesita **22.19+** dentro de 22.x.
Consulta otras opciones de ejecución en la guía de la herramienta. En Terminal o PowerShell, ejecuta:

```sh
node --version
npm --version
```

Si falta alguno o la versión es antigua, pide al agente que prepare el entorno:

```text
Comprueba si Node.js y npm están instalados.
Si hace falta, instala una versión estable compatible de Node.js con npm para mi sistema operativo: 22.19+ (rama 22.x) o 24+.
Verifica node --version y npm --version y continúa con la configuración del servicio de mensajería.
```

Tras instalar, comprueba la versión de la herramienta **en el mismo entorno que usa el agente**.
La instalación global pone los comandos en PATH, las carpetas donde la terminal busca programas.
Abre de nuevo la terminal o reinicia un agente que ya estuviera ejecutándose si no encuentra el comando.

### El aviso de npm sobre scripts de instalación

npm 11.17 y posteriores avisan tras la primera instalación global de `tg`, `max` o `memo`:
`install scripts not yet covered by allowScripts`. El aviso nombra el script de configuración de la
herramienta y su controlador de base de datos. Con npm 11 ambos scripts se ejecutan igualmente y la
herramienta funciona, así que puedes ignorar el aviso. npm 12, en cambio, los bloquea. Ejecuta el
comando `npm install -g --allow-scripts=…` que npm muestra bajo el aviso: permite solo los paquetes
que nombra, una vez.

### Windows y visibilidad del comando

Si PowerShell bloquea `npm.ps1`, usa `npm.cmd`. Quizá también necesites el lanzador `.cmd` de la
herramienta; consulta sus pasos para Windows. Telegram y MAX ofrecen además un instalador que
configura PATH y las instrucciones del agente. No supongas que sirve para todas las herramientas.
Usa los pasos de [Telegram](/llms.mdx/docs/es/tg/installation/content.md), [MAX](/llms.mdx/docs/es/max/installation/content.md),
[Drive](/llms.mdx/docs/es/drive/installation/content.md) o [Zoom](/llms.mdx/docs/es/zm/installation/content.md).

## Comprueba el primer resultado útil

Pide al agente que compruebe la cuenta o carpeta elegida, recupere un periodo pequeño o importe
una carpeta pequeña y responda una pregunta con una fuente:

- **Mensajes:** mostrar algunos chats, recuperar el periodo necesario y encontrar un mensaje conocido.
  [Historial de Telegram](/llms.mdx/docs/es/tg/archive/content.md) · [historial de MAX](/llms.mdx/docs/es/max/archive/content.md).
- **Archivos o correo:** importar una carpeta elegida o un buzón configurado y buscar una frase conocida.
  [Memo](/llms.mdx/docs/es/memo/content.md) · [correo](/llms.mdx/docs/es/mail/email/content.md).
- **Drive:** importar una carpeta elegida y abrir el documento del resultado.
  [Primera importación de Drive](/llms.mdx/docs/es/drive/usage/content.md).
- **Reuniones:** recuperar o importar una transcripción y leer un fragmento citado.
  [Primer resultado de Zoom](/llms.mdx/docs/es/zm/installation/content.md#check-your-first-result).

El resultado funciona cuando el comando está disponible, la fuente correcta está conectada, hay
datos útiles guardados y el agente puede citarlos. Comprueba fechas y archivos ausentes o ilegibles
antes de interpretar una respuesta vacía. El inicio de sesión, el skill o MCP por sí solos no lo demuestran.

## Datos, actualizaciones y trabajo en segundo plano

Las sesiones y los datos locales se guardan donde se ejecuta la herramienta. El agente puede
enviar contenido consultado a su proveedor de IA según sus ajustes. Revisa [seguridad y flujo de datos](/llms.mdx/docs/es/security/content.md)
y [permisos](/llms.mdx/docs/es/configuration/content.md#permisos) antes de permitir cambios.

Instalar no inicia sincronización continua ni respuestas automáticas. Las tareas recurrentes
necesitan un proceso o una programación; pide al agente cómo detener lo que inicie. Cerrar su chat
no detiene necesariamente un proceso separado. Consulta [tareas recurrentes](/llms.mdx/docs/es/prompting/content.md#recurring-tasks).

Para actualizar o desinstalar, sigue la guía de la herramienta. Quitar un paquete, borrar datos
locales y revocar el acceso a una cuenta son acciones distintas. Cuando funcione la primera
comprobación, [elige la siguiente tarea](/llms.mdx/docs/es/content.md#prueba-una-petici%C3%B3n).
