# 기억해 두기 도구

> MCP 클라이언트나 dvina 명령으로 텍스트나 링크를 기억해 두고, 기억한 항목을 조회하거나 잊을 수 있습니다.

Dvina의 MCP 도구나 `dvina` 명령을 사용하면 다른 앱에서도 Dvina에서 **기억해 두기**를 선택하는 것처럼 사용자를 위해 정보를 기억해 둘 수 있습니다. 이렇게 기억한 정보는 사용자의 것으로, 피드의 **기억한 항목**에 표시됩니다. 사용자가 물어보면 Dvina가 해당 정보를 찾아주며, 필요할 때 다시 꺼내주는 데도 활용할 수 있습니다. 기억해 두기 기능에 대해 자세히 알아보려면 [기억해 두기](/docs/use-dvina/features/keep-in-mind)를 참조하세요.

## 도구

| MCP 도구   | 명령          | 기능                                                    | 먼저 확인 |
| ---------- | ---------------- | --------------------------------------------------------------- | ---------- |
| `kept_add` | `dvina kept add` | 텍스트나 링크를 기억해 둡니다.                                          | 아니요         |
| `kept_ls`  | `dvina kept ls`  | 기억한 항목을 최신순으로 나열하거나 특정 단어와 일치하는 항목만 나열합니다. | 아니요         |
| `kept_rm`  | `dvina kept rm`  | 기억한 항목을 잊습니다. 해당 항목은 **최근 삭제된 항목**으로 이동합니다.   | 예        |

## 텍스트나 링크 기억해 두기

`kept_add`는 텍스트, 링크 또는 출처 링크가 포함된 텍스트를 기억해 둡니다. `text`나 `url` 중 하나 이상을 지정하세요.

| 입력       | 설명                                                               | 제한            |
| ----------- | ------------------------------------------------------------------------ | ---------------- |
| `text`      | 기억해 둘 텍스트입니다.                                                       | 5,000자 |
| `url`       | 텍스트의 출처 페이지나 링크 또는 기억해 둘 링크입니다. http(s)만 지원합니다. | 2,048자 |
| `title`     | 페이지나 문서 제목 등 출처의 제목입니다.     | 500자   |
| `sourceApp` | MCP 클라이언트 이름 등 출처 앱입니다.                 | 200자   |

기억한 항목의 `id`, `kind`(`text` 또는 `link`), `title`을 반환합니다.

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

같은 출처의 같은 텍스트를 다시 기억해 두어도 항목이 중복으로 생성되지 않습니다.

## 기억한 항목 조회하기

`kept_ls`는 기억한 항목을 최신순으로 나열합니다.

| 입력    | 설명                                        |
| -------- | ------------------------------------------------- |
| `query`  | 텍스트, 제목 또는 링크에 이 값이 포함된 항목만 반환합니다. |
| `limit`  | 반환할 항목 수로, 최대 100입니다. 기본값은 20입니다. |
| `cursor` | 다음 페이지를 가져오기 위한 마지막 페이지의 끝 위치입니다.  |

각 항목에는 `id`, `kind`(`text`, `image` 또는 `link`), `title`, `text`, `url`, `sourceType`(항목을 기억해 둔 곳으로, `chat` 또는 `mcp` 등), `sourceApp`, `createdAt`이 포함됩니다. 항목이 더 있으면 결과에 `nextCursor`가 포함됩니다. 명령을 사용하면 목록 끝에 `next: --cursor <c>`가 표시됩니다.

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

## 기억한 항목 잊기

`kept_rm`은 `id`로 지정한 기억한 항목 하나를 잊습니다. 다른 변경 작업과 마찬가지로 먼저 사용자에게 확인을 요청합니다. Dvina가 항목의 제목을 표시하면 승인하거나 거절하세요. 승인하면 항목이 **최근 삭제된 항목**으로 이동하며, 30일 동안 복원할 수 있습니다.

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

## 적용 사항

- 도구는 사용자의 자격으로 작동하며, 사용자의 역할에 허용된 범위 내에서 사용자가 기억한 항목만 처리합니다.
- 클라이언트가 기억해 두는 정보에도 앱에서와 동일하게 회사의 데이터 보호 규칙이 적용됩니다. 규칙에서 허용하지 않으면 아무것도 기억해 두지 않으며, 클라이언트에 그 이유가 전달됩니다.
- 이 도구로는 사진을 기억해 둘 수 없습니다. Dvina나 휴대폰의 공유 시트에서 사진을 기억해 두세요.

## 관련 항목

- [기억해 두기](/docs/use-dvina/features/keep-in-mind)
- [MCP로 다른 앱에서 Dvina 사용하기](/docs/dvina-mcp/overview)
- [dvina 명령 사용하기](/docs/dvina-mcp/cli)