# Ferramentas de Guardar na memória

> Guarde textos ou um link, liste o que você guardou e esqueça um item usando um cliente MCP ou o comando dvina.

Com as ferramentas MCP do Dvina ou o comando `dvina`, outro app pode guardar algo na memória para você, assim como quando você escolhe **Guardar** no Dvina. O que ele guarda pertence a você: aparece em **Guardados** no seu Feed, o Dvina encontra quando você pede e pode usar esse conteúdo para trazê-lo de volta quando for relevante. Para saber mais sobre o recurso Guardar na memória, consulte [Guardar na memória](/docs/use-dvina/features/keep-in-mind).

## As ferramentas

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

## Guarde textos ou um link

`kept_add` guarda textos, um link ou textos com o link de onde vieram. Informe pelo menos `text` ou `url`.

| Entrada       | O que é                                                               | Limite            |
| ----------- | ------------------------------------------------------------------------ | ---------------- |
| `text`      | O texto a guardar.                                                       | 5,000 caracteres |
| `url`       | A página ou o link de onde vem o texto, ou o link 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` | O app de origem, como o nome do seu cliente MCP.                 | 200 caracteres   |

A ferramenta retorna o `id` do item guardado, seu `kind` (`text` ou `link`) e seu `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.

## Liste o que você guardou

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

| Entrada    | O que é                                        |
| -------- | ------------------------------------------------- |
| `query`  | Retorna apenas os itens cujo texto, título ou link contém o termo informado. |
| `limit`  | Quantos itens retornar, até 100. O padrão é 20. |
| `cursor` | Onde a última página terminou, para obter a próxima.  |

Cada item tem `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
```

## Esqueça algo que você guardou

`kept_rm` esquece um item guardado pelo seu `id`. Como em outras alterações, pede sua confirmação primeiro: o Dvina mostra o título do item, e você aprova ou recusa. Se você aprovar, o item vai para **Apagados recentemente**, onde você pode restaurá-lo por 30 dias.

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

## Regras e limites

- As ferramentas agem em seu nome, nos seus próprios itens guardados, conforme as permissões da sua função.
- O que um cliente guarda passa pelas regras de proteção de dados da sua empresa, assim como no app. Se uma regra não permitir, nada será guardado e o cliente receberá o motivo.
- Não é possível guardar imagens com essas ferramentas. Guarde imagens no Dvina ou pela folha de compartilhamento do seu celular.

## Conteúdo relacionado

- [Mantenha em mente](/docs/use-dvina/features/keep-in-mind)
- [Use o Dvina em outros apps com MCP](/docs/dvina-mcp/overview)
- [Use o comando dvina](/docs/dvina-mcp/cli)