У Dvina есть собственный MCP-сервер. Подключите MCP-клиент, например Claude Code, ChatGPT или Cursor, и это приложение сможет от вашего имени искать данные в Dvina, читать ваши документы и память, а также добавлять заметки, задачи и напоминания.
Перед началом
Вам понадобится адрес сервера:
https://api.dvina.ai/mcp
Если ваша компания размещает Dvina на собственных серверах, используйте адрес API Dvina вашей компании, добавив /mcp в конце. Узнайте адрес у администратора.
Сервер использует Streamable HTTP. Если клиент предлагает выбрать транспорт, выберите HTTP.
Подключите клиент
Claude Code
В терминале выполните:
claude mcp add --transport http dvina https://api.dvina.ai/mcpЗапустите Claude Code, выполните
/mcp, выберите dvina и войдите в Dvina.
ChatGPT
- Откройте раздел ChatGPT, в котором можно добавить MCP-сервер.
- Укажите
https://api.dvina.ai/mcpв качестве адреса сервера и выберите OAuth, если появится запрос на выбор способа входа. - Войдите в Dvina, когда ChatGPT предложит это сделать.
Cursor
- Откройте раздел Cursor, в котором можно добавить MCP-сервер.
- Добавьте сервер с именем
dvinaи адресомhttps://api.dvina.ai/mcp. - Войдите в Dvina, когда Cursor предложит это сделать.
Вам не нужны идентификатор клиента или секрет. Клиент сам регистрируется в Dvina при первом подключении.
Войдите в аккаунт
MCP-сервер Dvina использует OAuth для входа через браузер:
- Войдите в Dvina привычным способом.
- Если вы состоите в нескольких рабочих пространствах, выберите одно в разделе Выберите рабочее пространство, затем нажмите Продолжить. Клиент работает только в этом рабочем пространстве.
- В разделе Разрешите доступ проверьте название приложения, затем нажмите Разрешить доступ. Если приложение вам незнакомо, нажмите Отклонить.
Клиент остаётся подключённым, поэтому вам не нужно входить каждый раз.
Что может делать клиент
Клиент видит инструменты Dvina и использует их, когда это нужно для выполнения вашего запроса:
| Раздел | Что может делать клиент |
|---|---|
| Поиск | Искать одновременно в ваших чатах, документах, памяти и мире. |
| Память | Просматривать список файлов памяти, читать их, добавлять новые и изменять существующие. |
| Мир | Просматривать список ваших тем, показывать, что Dvina знает о теме или о чём-либо ещё, и просматривать вашу ленту. |
| Документы | Просматривать список документов в вашей библиотеке, читать их и искать по ним, создавать заметки и папки, загружать файлы, заменять, перемещать и переименовывать документы, а также перемещать их в корзину. |
| Холст | Просматривать список ваших холстов, читать их, создавать холсты и переписывать страницы. |
| Задачи и цели | Просматривать список ваших задач и читать, что они сделали, запускать задачи, в том числе направленные на достижение цели, давать задачам дополнительные поручения и останавливать их. |
| Запланированные сообщения | Просматривать их список, планировать разовые или повторяющиеся сообщения и напоминания, а также отменять их. |
| Агенты и навыки | Просматривать список ваших агентов и навыков, читать их, создавать агентов, добавлять навыки и изменять те и другие. |
| Проекты | Просматривать список ваших проектов, показывать папку проекта и его недавние задачи. |
| Общий доступ | Проверять, у кого есть доступ к объекту и чем другие поделились с вами, предоставлять и отзывать доступ. |
| Настройки | Показывать ваши настройки, включать и выключать память. |
Клиент не может удалять что-либо безвозвратно, открывать публичные ссылки, подключать или отключать приложения, а также менять настройки администрирования или оплаты.
Подтверждение изменений
Действия клиента подчиняются тем же правилам, что и везде в Dvina:
- Чтение выполняется без подтверждения.
- Добавление чего-либо нового, например заметки, файла памяти или задачи, выполняется без подтверждения. Оно никогда не меняет то, что уже есть.
- Изменение или удаление чего-либо, например перемещение документа в корзину, переписывание страницы холста, остановка задачи или предоставление доступа к объекту, сначала требует вашего подтверждения. Клиент показывает описание изменения, составленное самой Dvina, а вы подтверждаете или отклоняете его. Если вы отклоняете изменение, ничего не меняется.
Примечание
Если клиент не может запросить у вас подтверждение, Dvina не выполняет переданное им изменение. Внесите изменение в приложении Dvina или используйте клиент, который может запросить подтверждение.
Ваш доступ и правила вашей компании
Клиент действует от вашего имени и может видеть и делать только то, что доступно вам в Dvina:
- Он работает, только пока вы остаётесь участником рабочего пространства, и только в пределах прав вашей роли.
- Если администратор отключает функцию, например загрузку файлов, клиент тоже не может её использовать.
- Всё, что клиент добавляет или изменяет, проходит проверку по правилам защиты данных вашей компании, как и в приложении.
- Всё, что он добавляет или изменяет, записывается в ваш журнал аудита как действие ассистента от вашего имени с указанием клиента, из которого оно поступило.
- Его действия учитываются в вашем использовании сервиса в пределах ваших обычных лимитов.
Подключение с ключом API вместо OAuth
На тарифе Enterprise клиент может подключаться с помощью персонального токена доступа вместо входа в аккаунт. Используйте этот способ для клиента, который не поддерживает вход через OAuth, или для скрипта.
- Откройте настройки и выберите Доступ к API.
- В разделе Персональные токены доступа выберите Создать токен.
- Укажите Имя, выберите Доступ и Срок действия, затем выберите Создать токен.
- В разделе Скопируйте токен скопируйте токен. Он показывается только один раз.
Выберите доступ, который нужен клиенту:
- Только чтение: клиент видит только инструменты для чтения. Он может искать и читать данные в вашей Dvina, но не может ничего добавлять или изменять.
- Чтение и запись: клиент видит все инструменты, а изменения по-прежнему требуют вашего подтверждения, как и при подключении через OAuth.
Передавайте токен в заголовке Authorization после Bearer. Например, в Claude Code:
claude mcp add --transport http dvina https://api.dvina.ai/mcp --header "Authorization: Bearer <your token>"
В другом клиенте добавьте тот же заголовок в настройках заголовков для MCP-сервера.
Токен действует от вашего имени в том рабочем пространстве, где вы его создали, с правами вашей текущей роли в нём. Чтобы заменить токен, откройте его в разделе Персональные токены доступа и выберите Заменить…: новый токен заменит его, а старый сразу перестанет работать. Чтобы отключить токен, выберите Отозвать…: всё, что его использует, сразу перестанет работать.
Подробнее о токенах см. в разделе Доступ к API.