# Úsalo (/es/docs/pbx/usage)

Aquí se explica cómo se construye un comando y cómo usa un agente la herramienta. Léelo antes de tu primer comando.

## Primero el perfil [#primero-el-perfil]

Un perfil es un nombre que eliges para una centralita. Es la primera palabra de cada comando que usa una cuenta:

```sh
pbx office meetings list
```

`PBX_PROFILE=office` hace lo mismo durante una sesión de la shell. Nunca se supone un perfil, ni siquiera el
único: un comando sin perfil se detiene con el código de salida 2 y muestra los perfiles de este ordenador.

## Las llamadas son reuniones [#las-llamadas-son-reuniones]

Cada fila del CDR es una reunión en el almacén de WireCat. Su título son los dos lados, `+79000000001 → 101`. Sus
personas son la extensión (`manager`) y el número externo (`client`), y su grabación es un adjunto.

```sh
pbx office meetings sync                                  # import what is new
pbx office meetings list "started_at>=2026-11-01"          # newest first
pbx office meetings list "title:*79000000001*"             # the calls of one number
pbx office meetings show 42                                 # times, people, recording
pbx office meetings transcribe                              # recordings to text, on this computer
pbx office meetings transcript 42                           # what was said
```

`pbx office meetings list --help` muestra los campos que admite una consulta.

## Salida para scripts [#salida-para-scripts]

Todos los comandos salvo `mcp serve` sobre stdin y stdout admiten `--json` e imprimen un único valor JSON en stdout.
Los errores salen en JSON por stderr, con un código y un motivo para decidir qué hacer. La
[referencia de comandos](/llms.mdx/docs/es/pbx/commands/content.md) lista los códigos.

## Agentes [#agentes]

`pbx skill install` pone la skill de la herramienta donde la buscan Claude Code, Codex, Gemini CLI y OpenClaw.
`pbx skill install --for hermes` además añade esa carpeta a los ajustes de Hermes Agent, así que un
`skill install` sin más deja fuera a Hermes. `pbx office mcp serve` sirve los comandos del perfil por MCP, sobre
stdin y stdout:

```sh
claude mcp add pbx -- pbx office mcp serve
```

El servidor ofrece todos los comandos salvo `session start` y `session end`. Los permisos del perfil deciden qué se
ejecuta; consulta los [ajustes](/llms.mdx/docs/es/pbx/configuration/content.md#permissions). El texto de una llamada (una transcripción, el nombre
de quien llama, un número) llega al agente marcado como datos no fiables.

Para ChatGPT y Claude en el navegador,
`pbx office mcp serve --http --public-url https://laptop.example.ts.net` escucha en `127.0.0.1` (puerto 8765, o
`--port`) detrás de tu propio túnel. Una aplicación del navegador inicia sesión con un código de un solo uso que
imprime el comando. `pbx office mcp revoke` cierra todas las sesiones.