# Ferramentas de Ter em mente

> Guarde texto ou uma ligação, liste o que guardou e esqueça um item a partir de um cliente MCP ou com o comando dvina.

Com as ferramentas MCP do Dvina ou o comando `dvina`, outra aplicação pode guardar algo por si, tal como quando escolhe **Guardar** no Dvina. O que guarda é seu: aparece em **Guardados** no seu Feed, o Dvina encontra-o quando pede e pode usá-lo para voltar a mostrá-lo quando for relevante. Para saber mais sobre a funcionalidade Ter em mente, consulte [Ter em mente](/docs/use-dvina/features/keep-in-mind).

## As ferramentas

| Ferramenta MCP   | Comando          | O que faz                                                    | Pede confirmação |
| ---------- | ---------------- | --------------------------------------------------------------- | ---------- |
| `kept_add` | `dvina kept add` | Guarda texto ou uma ligação.                                          | Não         |
| `kept_ls`  | `dvina kept ls`  | Lista o que guardou, do mais recente para o mais antigo, ou apenas o que corresponde a uma palavra. | Não         |
| `kept_rm`  | `dvina kept rm`  | Esquece um item que guardou. O item é movido para **Apagados recentemente**.   | Sim        |

## Guardar texto ou uma ligação

`kept_add` guarda texto, uma ligação ou texto com a ligação de onde veio. Forneça pelo menos `text` ou `url`.

| Parâmetro       | O que é                                                               | Limite            |
| ----------- | ------------------------------------------------------------------------ | ---------------- |
| `text`      | O texto a guardar.                                                       | 5,000 caracteres |
| `url`       | A página ou ligação de onde vem o texto, ou a ligação a guardar. Apenas http(s). | 2,048 caracteres |
| `title`     | O título da origem, como o da página ou do documento.     | 500 caracteres   |
| `sourceApp` | A aplicação de origem, como o nome do seu cliente MCP.                 | 200 caracteres   |

Devolve o `id` do item guardado, o respetivo `kind` (`text` ou `link`) e o `title`.

```sh
dvina kept add "Bright & Co. includes permits and can start Nov 17." --url https://example.com/quote --title "Kitchen quote"
```

Guardar novamente o mesmo texto da mesma origem não cria um segundo item.

## Listar o que guardou

`kept_ls` lista os seus itens guardados, do mais recente para o mais antigo.

| Parâmetro    | O que é                                        |
| -------- | ------------------------------------------------- |
| `query`  | Apenas os itens cujo texto, título ou ligação contêm este valor. |
| `limit`  | Quantos itens devolver, até 100. O valor predefinido é 20. |
| `cursor` | O ponto onde terminou a última página, para obter a seguinte.  |

Cada item tem os campos `id`, `kind` (`text`, `image` ou `link`), `title`, `text`, `url`, `sourceType` (onde foi guardado, como `chat` ou `mcp`), `sourceApp` e `createdAt`. Quando há mais itens, o resultado inclui um `nextCursor`; com o comando, a lista termina com `next: --cursor <c>`.

```sh
dvina kept ls --query permits --limit 5
```

## Esquecer um item que guardou

`kept_rm` esquece um item guardado através do respetivo `id`. Tal como acontece com outras alterações, pede primeiro a sua confirmação: o Dvina mostra o título do item e pode aprovar ou recusar. Se aprovar, o item é movido para **Apagados recentemente**, onde pode restaurá-lo durante 30 dias.

```sh
dvina kept rm <id>
```

## Condições de utilização

- As ferramentas atuam em seu nome, sobre os seus próprios itens guardados, dentro das permissões da sua função.
- O que um cliente guarda passa pelas regras de proteção de dados da sua empresa, tal como na aplicação. Se uma regra não o permitir, nada é guardado e o cliente recebe o motivo.
- Estas ferramentas não permitem guardar imagens. Guarde imagens no Dvina ou a partir do menu de partilha do seu telemóvel.

## Relacionado

- [Ter em conta](/docs/use-dvina/features/keep-in-mind)
- [Use o Dvina a partir de outras apps com MCP](/docs/dvina-mcp/overview)
- [Use o comando dvina](/docs/dvina-mcp/cli)