# Используйте Dvina в других приложениях через MCP > Подключите MCP-клиент, например Claude Code, ChatGPT или Cursor, к Dvina, войдите в аккаунт и разрешите ему читать и добавлять данные в 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 " ``` В другом клиенте добавьте тот же заголовок в настройках заголовков для 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)