# MCP y skills (/es/docs/zm/mcp)

Permite al agente leer reuniones guardadas y responder con fuentes. Elige instrucciones para
un agente de terminal o MCP para una app que ejecuta herramientas locales. Una skill es un archivo
de instrucciones; MCP es su protocolo. Ninguno inicia sesión ni descarga reuniones.
[Importa o descarga al menos una](/llms.mdx/docs/es/zm/installation/content.md#first-run) antes de preguntar por su texto.

## Elige la conexión [#elige-la-conexión]

| Agente | Conexión | Resultado |
| --- | --- | --- |
| Codex o Gemini CLI en este equipo | `zm skill install --for agents` | Instrucciones para órdenes CLI |
| Claude Code en este equipo | `zm skill install --for claude` | Sus instrucciones CLI |
| App local compatible con MCP | Añadir entrada del servidor y reiniciar | Herramientas de lectura |

Un agente de terminal puede usar la CLI más amplia, incluidas escrituras si las solicitas.
MCP da un conjunto más reducido de lectura. Son elecciones de acceso diferentes.

## La skill del agente [#la-skill-del-agente]

`zm skill show` muestra las instrucciones del paquete. `zm skill install` escribe explícitamente
una copia con su versión en `~/.claude/skills/zoom-cli/` para Claude Code y en `~/.agents/skills/zoom-cli/`
para Codex y Gemini CLI. `--for claude` o `--for agents` elige un grupo; ambos por defecto.
La instalación no ocurre al iniciar un comando normal.

## El servidor MCP [#el-servidor-mcp]

`zm serve --mcp` usa stdio y ofrece siete herramientas de solo lectura: lista y detalles de reuniones,
transcripciones, resúmenes, exportaciones, búsqueda de texto y participantes. Descubrir herramientas
no abre la base. Cada lectura usa la cuenta elegida y cierra su conexión antes de responder; el cliente
no puede cambiar la cuenta. No se exponen escritura de archivos exportados ni cambios remotos.

Un cliente MCP ejecuta `zm` con `["serve", "--mcp"]`. En el formato `mcpServers` de
[Claude Desktop](https://modelcontextprotocol.io/docs/develop/connect-local-servers):

```json
{
  "mcpServers": {
    "zoom": { "command": "zm", "args": ["serve", "--mcp"] }
  }
}
```

Una app puede no ver el `PATH` de la terminal; un servidor stdio hereda parte del entorno
([depurar MCP](https://modelcontextprotocol.io/docs/tools/debugging)). Si no inicia, usa la ruta
completa de `which zm`. Si configuraste `ZM_CONFIG_DIR` o `MESSAGING_STORE`, pasa los mismos valores
en `env`; de lo contrario leerá otro perfil o base.

Reserva stdout para el protocolo: omite `--json`, `--jsonl` y `--fields`. `--max-output-bytes`
limita cada resultado; cero elimina el límite. Elige un perfil e importa o descarga sus datos antes
de leerlos. El descubrimiento funciona sin datos guardados.

## Prueba la conexión [#prueba-la-conexión]

Tras instalar instrucciones, inicia otra sesión si el agente no las detectó. Después de configurar
MCP, reinicia la app y comprueba que sus herramientas Zoom aparecen. Pide:

> ```text prompt
> Lista las reuniones guardadas. Abre la última y muestra fecha, texto disponible y un pasaje que apoye su decisión principal. Indica si los datos son incompletos.
> ```

Compara la reunión con `zm meetings list --json` en el terminal. Si hay herramientas pero no datos,
comprueba perfil/ruta e importa o descarga. Si no se inicia, usa `where zm` en Windows o
`command -v zm` en Linux/macOS y pon la ruta completa en la entrada. Un chat web no ejecuta esta
orden local sin una conexión compatible al equipo.

## Herramientas opcionales [#herramientas-opcionales]

Los indicadores amplían el conjunto: `--meeting-context` añade fuentes, contexto personal y propuestas
de tareas; `--unified-search`, búsqueda compartida solo de reuniones; `--semantic --model <id>`, una
consulta de vectores. Los componentes remotos necesitan `--base-url` y `--dims`. El servidor fija el
componente al iniciar y el perfil al leer por primera vez. Reinícialo para cambiar la selección;
los clientes no pueden hacerlo. Generar vectores y crear tareas no son herramientas MCP.

Para contexto entre proyectos, notas y documentos, continúa con
[búsqueda y fuentes](/llms.mdx/docs/es/zm/search/content.md#notes-tags-and-memories-with-memo); conecta Memo por separado cuando haga falta.