Dvina MCP

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

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

Перегляд у Markdown

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

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

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

https://api.dvina.ai/mcp

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

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

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

Claude Code

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

    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, а ви підтверджуєте або відхиляєте її. Якщо ви відхиляєте зміну, нічого не змінюється.

Примітка

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

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

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

  • Він працює лише поки ви залишаєтеся учасником робочого простору й лише в межах дозволів вашої ролі.
  • Якщо адміністратор вимкне функцію, наприклад завантаження файлів, клієнт також не зможе нею користуватися.
  • Усе, що клієнт додає чи змінює, проходить перевірку за правилами захисту даних вашої компанії, як і в застосунку.
  • Усе, що він додає чи змінює, записується у ваш журнал аудиту як дія асистента від вашого імені із зазначенням клієнта, з якого надійшов запит.
  • Його дії зараховуються до вашого використання в межах ваших звичайних лімітів.

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

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

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

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

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

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

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

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

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

Докладніше про токени див. у розділі Доступ до API.