# Використовуйте Dvina з інших застосунків через MCP

> Підключіть до Dvina MCP-клієнт, наприклад Claude Code, ChatGPT або Cursor, увійдіть і дозвольте йому читати та додавати дані у вашій Dvina з вашого схвалення.

Dvina має власний MCP-сервер. Підключіть MCP-клієнт, наприклад Claude Code, ChatGPT або Cursor, і цей застосунок зможе від вашого імені шукати у вашій Dvina, читати ваші документи й пам’ять, а також додавати нотатки, завдання та нагадування.

## Перш ніж почати

Вам потрібна адреса сервера:

```text
https://api.dvina.ai/mcp
```

Якщо ваша компанія розгорнула Dvina на власних серверах, використовуйте адресу API Dvina вашої компанії з `/mcp` у кінці. Запитайте її в адміністратора.

Сервер використовує Streamable HTTP. Якщо клієнт запитує, який транспорт використовувати, виберіть HTTP.

## Підключіть клієнт

::: tabs

=== Claude Code

1. У терміналі виконайте:

    ```sh
    claude mcp add --transport http dvina https://api.dvina.ai/mcp
    ```

2. Запустіть Claude Code, виконайте `/mcp`, виберіть **dvina** та увійдіть у Dvina.

=== ChatGPT

1. Відкрийте розділ ChatGPT, у якому можна додати MCP-сервер.
2. Введіть `https://api.dvina.ai/mcp` як адресу сервера та виберіть OAuth, якщо з’явиться запит про спосіб входу.
3. Увійдіть у Dvina, коли ChatGPT запропонує це зробити.

=== Cursor

1. Відкрийте розділ Cursor, у якому можна додати MCP-сервер.
2. Додайте сервер із назвою `dvina` та адресою `https://api.dvina.ai/mcp`.
3. Увійдіть у Dvina, коли Cursor запропонує це зробити.

:::

Вам не потрібні ідентифікатор клієнта чи секретний ключ. Клієнт сам реєструється в Dvina під час першого підключення.

## Увійдіть

MCP-сервер Dvina використовує OAuth для входу через браузер:

1. Увійдіть у Dvina, як зазвичай.
2. Якщо ви належите до кількох робочих просторів, виберіть один у розділі **Виберіть робочий простір**, а потім натисніть **Продовжити**. Клієнт працюватиме лише в цьому робочому просторі.
3. У розділі **Авторизуйте доступ** перевірте назву застосунку, а потім натисніть **Дозволити доступ**. Якщо ви не впізнаєте застосунок, натисніть **Відхилити**.

Клієнт залишається підключеним, тож вам не потрібно входити щоразу.

## Що може робити клієнт

Клієнт бачить інструменти Dvina й використовує їх, коли цього потребує ваш запит:

| Розділ                   | Що може робити клієнт                                                                                                                       |
| ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| **Пошук**             | Шукати одночасно у ваших чатах, документах, пам’яті та світі.                                                                                      |
| **Пам’ять**             | Переглядати список файлів пам’яті, читати їх, додавати нові або змінювати наявні.                                                                               |
| **Світ**              | Переглядати список ваших тем, показувати, що Dvina знає про певну тему чи будь-що інше, і переглядати вашу Стрічку.                                                  |
| **Документи**          | Переглядати список вмісту вашої Бібліотеки, читати й шукати в ній, створювати нотатки та папки, завантажувати файли, замінювати, переміщувати чи перейменовувати документи або переміщувати їх у кошик. |
| **Полотна**             | Переглядати список ваших полотен, читати їх, створювати полотна або переписувати сторінки.                                                                             |
| **Завдання та цілі**    | Переглядати список ваших завдань і читати, що вони виконали, запускати завдання чи завдання для досягнення цілі, давати завданням додаткову роботу або зупиняти їх.                |
| **Заплановані повідомлення** | Переглядати їхній список, планувати одноразові чи повторювані повідомлення або нагадування чи скасовувати їх.                                                                 |
| **Агенти та навички**  | Переглядати список ваших агентів і навичок, читати їх, створювати агентів, додавати навички або змінювати їх.                                                        |
| **Проєкти**           | Переглядати список ваших проєктів і показувати папку проєкту та його нещодавні завдання.                                                                             |
| **Спільний доступ**            | Переглядати, хто має доступ до елемента та чим інші поділилися з вами, а також надавати чи скасовувати доступ.                                           |
| **Налаштування**           | Показувати ваші налаштування або вмикати чи вимикати пам’ять.                                                                                             |

Клієнт не може нічого видаляти назавжди, відкривати публічні посилання, підключати чи відключати застосунки або змінювати налаштування адміністрування чи оплати.

## Підтвердження змін

Дії клієнта підпорядковуються тим самим правилам, що й усюди в Dvina:

- Читання виконується без підтвердження.
- Додавання чогось нового, наприклад нотатки, файлу пам’яті чи завдання, виконується без підтвердження. Воно ніколи не змінює того, що вже є.
- Зміна чи видалення чогось, наприклад переміщення документа в кошик, переписування сторінки полотна, зупинення завдання чи надання спільного доступу до елемента, потребує вашого попереднього підтвердження. Клієнт показує стислий опис зміни від Dvina, а ви підтверджуєте або відхиляєте її. Якщо ви відхиляєте зміну, нічого не змінюється.

> [!NOTE]
> Якщо клієнт не може запитати у вас підтвердження, Dvina не вносить зміну за його запитом. Натомість внесіть зміну в застосунку Dvina або скористайтеся клієнтом, який може запитувати підтвердження.

## Ваш доступ і правила вашої компанії

Клієнт діє від вашого імені й має доступ лише до того, що ви можете бачити та робити в Dvina:

- Він працює лише поки ви залишаєтеся учасником робочого простору й лише в межах дозволів вашої ролі.
- Якщо адміністратор вимкне функцію, наприклад завантаження файлів, клієнт також не зможе нею користуватися.
- Усе, що клієнт додає чи змінює, проходить перевірку за правилами захисту даних вашої компанії, як і в застосунку.
- Усе, що він додає чи змінює, записується у ваш [журнал аудиту](/docs/teams/audit-log) як дія асистента від вашого імені із зазначенням клієнта, з якого надійшов запит.
- Його дії зараховуються до вашого використання в межах ваших звичайних лімітів.

## Підключення за допомогою ключа API замість OAuth

На тарифі Enterprise клієнт може підключатися за допомогою особистого токена доступу замість входу в обліковий запис. Використовуйте цей спосіб для клієнта, який не може ввійти через OAuth, або для скрипту.

1. Відкрийте налаштування та виберіть **Доступ до API**.
2. У розділі **Особисті токени доступу** виберіть **Створити токен**.
3. Введіть **Назву**, виберіть **Доступ** і **Термін дії**, а потім виберіть **Створити токен**.
4. У розділі **Скопіюйте свій токен** скопіюйте токен. Його буде показано лише цього разу.

Виберіть доступ, потрібний клієнту:

- **Лише читання:** клієнт бачить лише інструменти для читання. Він може шукати й читати дані у вашій Dvina, але не може нічого додавати чи змінювати.
- **Читання та запис:** клієнт бачить усі інструменти, а зміни, як і з OAuth, усе одно потребують вашого підтвердження.

Передавайте токен у заголовку `Authorization` після `Bearer`. Наприклад, у Claude Code:

```sh
claude mcp add --transport http dvina https://api.dvina.ai/mcp --header "Authorization: Bearer <your token>"
```

В іншому клієнті додайте той самий заголовок там, де можна налаштувати заголовки для сервера MCP.

Токен діє від вашого імені в робочому просторі, де ви його створили, з дозволами вашої поточної ролі в ньому. Щоб замінити його, відкрийте його в розділі **Особисті токени доступу** та виберіть **Замінити…**: новий токен замінить його, а старий одразу перестане працювати. Щоб припинити його дію, виберіть **Відкликати…**: усе, що його використовує, одразу перестане працювати.

Докладніше про токени див. у розділі [Доступ до API](/docs/dvina-mcp/api-access).

## Пов’язані матеріали

- [Власні застосунки та сервери MCP](/docs/connectors/custom-apps)
- [Доступ до API](/docs/dvina-mcp/api-access)
- [Використання команди dvina](/docs/dvina-mcp/cli)
- [Огляд команд](/docs/teams/overview)