> ## 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 pelo Claude

> Crie e administre monitores da Croma pedindo ao Claude, ao ChatGPT ou a qualquer cliente MCP: os pedidos que funcionam, o que o agente faz e as sete ferramentas de monitores.

Com a Croma conectada por MCP, você cria um monitor pedindo. O agente consulta
a fonte primeiro, para você ver o que já coincide, depois cria o monitor e
pergunta quem deve receber os e-mails.

<Note>
  Conecte a Croma primeiro: [servidor MCP](/pt/mcp-server). Um monitor criado
  por um agente é o mesmo que a [API](/pt/monitors) e o console em
  [platform.usecroma.com/monitors](https://platform.usecroma.com/monitors) administram.
</Note>

## Peça

Diga o que acompanhar, onde e quem deve saber. Por exemplo:

* "Avísame cuando la ANM publique algo sobre el título AD9-111. Envíalo a [legal@empresa.com](mailto:legal@empresa.com)."
* "Acompanhe no SECOP II os contratos novos com o NIT 900123456 e me mande um e-mail toda segunda às 8."
* "Me avise quando a Corte Constitucional publicar uma decisão sobre habeas data, só as de tutela."
* "Pause meu monitor do AD9-111." / "O que meus monitores encontraram esta semana?"

## O que o agente faz

<Steps>
  <Step title="Consulta a fonte">
    Roda a busca com seus filtros, por exemplo `anm_notices_search` com
    `title_number: "AD9-111"`, para você ver o que existe hoje.
  </Step>

  <Step title="Cria o monitor">
    Chama `create_monitor` com `endpoint` igual ao nome dessa ferramenta e
    `query` com os mesmos argumentos. A frequência padrão é logo depois de cada
    atualização da fonte.
  </Step>

  <Step title="Pergunta os destinatários">
    Até três e-mails. Nunca inventa um; se você não informou, ele pergunta.
  </Step>

  <Step title="Roda a execução inicial">
    A primeira execução registra o que já coincide e envia um e-mail de
    boas-vindas. Daí em diante, cada e-mail traz só o que é novo.
  </Step>
</Steps>

Esta é a chamada por trás do primeiro exemplo:

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

## As ferramentas

| Ferramenta             | O que faz                                                                          |
| ---------------------- | ---------------------------------------------------------------------------------- |
| `create_monitor`       | Acompanha uma busca de dataset com uma frequência e envia por e-mail o que é novo. |
| `list_monitors`        | Os monitores da sua organização, com a última execução de cada um.                 |
| `get_monitor`          | Um monitor: consulta, frequência, próxima execução e destinatários.                |
| `update_monitor`       | Renomeia, muda a consulta, a frequência ou os destinatários, pausa ou retoma.      |
| `run_monitor`          | Roda agora, fora da frequência.                                                    |
| `list_monitor_matches` | Cada linha que já reportou, com o veredito do filtro de relevância.                |
| `delete_monitor`       | Remove com o agendamento, as execuções e os resultados.                            |

`endpoint` aceita o nome da ferramenta (`anm_notices_search`), o id de catálogo
(`anm-notices-search`) ou o caminho (`/co/anm/notices-search/v1`). As buscas que
um monitor pode acompanhar estão em [Fontes monitoráveis](/pt/monitors-sources).

## Dicas

* **Seja exato sobre o que acompanhar.** Um identificador (uma placa, um NIT, um
  radicado) dá um monitor preciso; texto livre também funciona e traz mais.
* **Diga "só quando houver algo novo"** para pular o e-mail curto de "sem
  novidades"; o agente usa `notify: "on_new"`.
* **Descreva o que conta** ("só avisos sobre caducidade") e o agente adiciona um
  [filtro de relevância](/pt/monitors#o-filtro-de-relevância). O que for
  descartado fica guardado no monitor.
* **Cada execução gasta um crédito.** Criar e administrar monitores é grátis.
* Clientes que carregam ferramentas sob demanda, como o Claude, encontram estas
  ferramentas quando buscam "monitor" ou "alerta". Se o seu não encontrar, peça
  para usar `create_monitor`.