# Tools zum Merken

> Merke dir Text oder einen Link, liste Gemerktes auf und entferne Einträge aus dem Gemerkten – über einen MCP-Client oder mit dem Befehl dvina.

Mit den MCP-Tools von Dvina oder dem Befehl `dvina` kann eine andere App etwas für dich merken – genauso, als würdest du in Dvina **Merken** wählen. Was sie sich merkt, gehört dir: Es erscheint unter **Gemerkt** in deinem Feed, Dvina findet es, wenn du danach fragst, und kann es wieder aufgreifen, wenn es relevant ist. Mehr über die Funktion selbst erfährst du unter [Merken](/docs/use-dvina/features/keep-in-mind).

## Die Tools

| MCP-Tool   | Befehl          | Funktion                                                    | Fragt vorher nach |
| ---------- | ---------------- | --------------------------------------------------------------- | ---------- |
| `kept_add` | `dvina kept add` | Merkt sich Text oder einen Link.                                          | Nein         |
| `kept_ls`  | `dvina kept ls`  | Listet Gemerktes auf, neueste Einträge zuerst, oder nur Einträge, die zu einem Wort passen. | Nein         |
| `kept_rm`  | `dvina kept rm`  | Entfernt einen gemerkten Eintrag. Er wird nach **Zuletzt gelöscht** verschoben.   | Ja        |

## Text oder einen Link merken

`kept_add` merkt sich Text, einen Link oder Text mit dem Link, von dem er stammt. Gib mindestens `text` oder `url` an.

| Eingabe       | Bedeutung                                                               | Grenze            |
| ----------- | ------------------------------------------------------------------------ | ---------------- |
| `text`      | Der Text, der gemerkt werden soll.                                                       | 5,000 Zeichen |
| `url`       | Die Seite oder der Link, von dem der Text stammt, oder der Link, der gemerkt werden soll. Nur http(s). | 2,048 Zeichen |
| `title`     | Der Titel der Quelle, etwa der Seite oder des Dokuments.     | 500 Zeichen   |
| `sourceApp` | Die App, aus der der Inhalt stammt, etwa der Name deines MCP-Clients.                 | 200 Zeichen   |

Zurückgegeben werden die `id` des gemerkten Eintrags, sein `kind` (`text` oder `link`) und sein `title`.

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

Wenn du denselben Text aus derselben Quelle erneut merkst, entsteht kein zweiter Eintrag.

## Gemerktes auflisten

`kept_ls` listet deine gemerkten Einträge auf, die neuesten zuerst.

| Eingabe    | Bedeutung                                        |
| -------- | ------------------------------------------------- |
| `query`  | Nur Einträge, deren Text, Titel oder Link den Suchbegriff enthält. |
| `limit`  | Die Anzahl der zurückzugebenden Einträge, höchstens 100. Der Standardwert ist 20. |
| `cursor` | Das Ende der letzten Seite, um die nächste Seite abzurufen.  |

Jeder Eintrag enthält `id`, `kind` (`text`, `image` oder `link`), `title`, `text`, `url`, `sourceType` (wo er gemerkt wurde, etwa `chat` oder `mcp`), `sourceApp` und `createdAt`. Wenn es weitere Einträge gibt, enthält das Ergebnis einen `nextCursor`; beim Befehl endet die Liste mit `next: --cursor <c>`.

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

## Einen gemerkten Eintrag entfernen

`kept_rm` entfernt einen gemerkten Eintrag anhand seiner `id`. Wie bei anderen Änderungen fragt Dvina dich zuerst: Dvina zeigt den Titel des Eintrags an, und du stimmst zu oder lehnst ab. Wenn du zustimmst, wird der Eintrag nach **Zuletzt gelöscht** verschoben. Dort kannst du ihn 30 Tage lang wiederherstellen.

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

## Was dabei gilt

- Die Tools handeln in deinem Namen und arbeiten mit deinen eigenen gemerkten Einträgen, im Rahmen der Berechtigungen deiner Rolle.
- Was ein Client merkt, unterliegt den Datenschutzregeln deines Unternehmens, genau wie in der App. Wenn eine Regel es nicht erlaubt, wird nichts gemerkt und der Client erhält den Grund.
- Mit diesen Tools lassen sich keine Bilder merken. Merke dir Bilder in Dvina oder über das Teilen-Menü deines Smartphones.

## Weitere Informationen

- [Keep in Mind](/docs/use-dvina/features/keep-in-mind)
- [Dvina über MCP in anderen Apps verwenden](/docs/dvina-mcp/overview)
- [Den Befehl dvina verwenden](/docs/dvina-mcp/cli)