> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usecroma.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Monitores desde Claude

> Crea y administra monitores de Croma pidiéndoselo a Claude, ChatGPT o cualquier cliente MCP: las instrucciones que funcionan, lo que hace el agente y las siete herramientas de monitores.

Con Croma conectado por MCP, creas un monitor pidiéndolo. El agente primero
consulta la fuente, para que veas lo que ya coincide, luego crea el monitor y
te pregunta quién debe recibir los correos.

<Note>
  Primero conecta Croma: [servidor MCP](/es/mcp-server). Un monitor creado desde
  un agente es el mismo que administran la [API](/es/monitors) y la consola en
  [platform.usecroma.com/monitors](https://platform.usecroma.com/monitors).
</Note>

## Pídelo

Di qué vigilar, dónde y a quién avisar. Por ejemplo:

* "Avísame cuando la ANM publique algo sobre el título AD9-111. Envíalo a [legal@empresa.com](mailto:legal@empresa.com)."
* "Vigila en SECOP II los contratos nuevos con el NIT 900123456 y mándame un correo cada lunes a las 8."
* "Avísame cuando la Corte Constitucional publique una sentencia sobre habeas data, solo las de tutela."
* "Pausa mi monitor de AD9-111." / "¿Qué encontraron mis monitores esta semana?"

## Lo que hace el agente

<Steps>
  <Step title="Consulta la fuente">
    Corre la búsqueda con tus filtros, por ejemplo `anm_notices_search` con
    `title_number: "AD9-111"`, para que veas lo que existe hoy.
  </Step>

  <Step title="Crea el monitor">
    Llama `create_monitor` con `endpoint` igual al nombre de esa herramienta y
    `query` con los mismos argumentos. La frecuencia predeterminada es justo
    después de cada actualización de la fuente.
  </Step>

  <Step title="Pregunta los destinatarios">
    Hasta tres correos. Nunca adivina uno; si no los diste, te los pregunta.
  </Step>

  <Step title="Corre la ejecución inicial">
    La primera ejecución registra lo que ya coincide y envía un correo de
    bienvenida. Desde entonces, cada correo trae solo lo nuevo.
  </Step>
</Steps>

Esta es la llamada detrás del primer ejemplo:

```json theme={"dark"}
{
  "name": "Contrato AD9-111",
  "endpoint": "anm_notices_search",
  "query": { "title_number": "AD9-111" },
  "recipients": ["legal@empresa.com"],
  "language": "es"
}
```

## Las herramientas

| Herramienta            | Qué hace                                                                          |
| ---------------------- | --------------------------------------------------------------------------------- |
| `create_monitor`       | Vigila una búsqueda de dataset con una frecuencia y envía por correo lo nuevo.    |
| `list_monitors`        | Los monitores de tu organización, con la última ejecución de cada uno.            |
| `get_monitor`          | Un monitor: su consulta, frecuencia, próxima ejecución y destinatarios.           |
| `update_monitor`       | Renombra, cambia la consulta, la frecuencia o los destinatarios, pausa o reanuda. |
| `run_monitor`          | Lo ejecuta ahora, fuera de su frecuencia.                                         |
| `list_monitor_matches` | Cada fila que ha reportado, con el veredicto del filtro de relevancia.            |
| `delete_monitor`       | Lo elimina con su programación, ejecuciones y resultados.                         |

`endpoint` acepta el nombre de la herramienta (`anm_notices_search`), el id de
catálogo (`anm-notices-search`) o la ruta (`/co/anm/notices-search/v1`). Las
búsquedas que un monitor puede vigilar están en
[Fuentes monitoreables](/es/monitors-sources).

## Consejos

* **Sé exacto con lo que quieres vigilar.** Un identificador (una placa, un NIT,
  un radicado) da un monitor preciso; el texto libre también sirve y trae más.
* **Di "solo cuando haya algo nuevo"** para evitar el correo corto de "sin
  novedades"; el agente usa `notify: "on_new"`.
* **Describe qué cuenta** ("solo avisos sobre caducidad") y el agente agrega un
  [filtro de relevancia](/es/monitors#el-filtro-de-relevancia). Lo descartado
  queda guardado en el monitor.
* **Cada ejecución consume un crédito.** Crear y administrar monitores es gratis.
* Los clientes que cargan herramientas bajo demanda, como Claude, encuentran
  estas herramientas cuando buscan "monitor" o "alerta". Si el tuyo no las
  encuentra, pídele que use `create_monitor`.