> For the complete documentation index, see [llms.txt](https://docs.incogniton.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.incogniton.com/documentation/russian-documentation/api-avtomatizacii-i-sdk/connect-ai-clients-mcp.md).

# Подключение AI-клиентов с MCP

Создайте MCP токен в Настройки → Автоматизация и подключите Claude Desktop, Claude Code, Cursor, Windsurf, VS Code или Codex CLI к вашему аккаунту Incogniton.

Откройте **Настройки** в левом меню, нажмите на вкладку **Автоматизация** и нажмите **Создать MCP токен**. Затем выберите вашего AI клиента в разделе **Установить в вашем AI клиенте** и нажмите **Копировать конфигурацию**.

MCP (Model Context Protocol) позволяет AI клиенту, такому как Claude, Cursor или VS Code, работать с вашим аккаунтом Incogniton. Вы можете попросить его найти, создать или отредактировать профили, управлять прокси, группами и тегами, а также запускать или останавливать профили.

Соединение осуществляется через npm пакет `@incogniton/mcp`. Ваш AI клиент запускает его с помощью `npx`, поэтому на компьютере, где работает AI клиент, должна быть установлена [Node.js](https://nodejs.org/) версии 18 или новее.

### Создайте ваш MCP токен

{% stepper %}
{% step %}

#### Откройте вкладку Автоматизация

Нажмите **Настройки** в левом меню, затем нажмите на вкладку **Автоматизация**. Прокрутите до секции **MCP токен**.
{% endstep %}

{% step %}

#### Создайте токен

Нажмите **Создать MCP токен**. Новый токен появится в поле под кнопкой.
{% endstep %}

{% step %}

#### Скопируйте и сохраните его

Нажмите **Копировать** рядом с токеном и сохраните его в безопасном месте, например в менеджере паролей. Incogniton показывает токен только один раз: **Внимание: Вы не сможете восстановить этот токен позже — скопируйте и сохраните его сейчас.**
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
Относитесь к MCP токену как к паролю. Любой, у кого он есть, может управлять профилями вашего аккаунта. Никогда не делитесь им и не вставляйте его в публичный файл.
{% endhint %}

### Замените или отзовите ваш токен

У вас может быть только один активный MCP токен одновременно. Нажатие **Создать MCP токен** снова создаст новый токен и сделает старый недействительным. Обновите токен в каждом AI клиенте, который вы подключили.

Чтобы остановить весь доступ, нажмите **Отозвать** в разделе **Активные токены**. Когда ни один токен не активен, в разделе отображается **Нет активных токенов**.

### Добавьте Incogniton в ваш AI клиент

В разделе **Установить в вашем AI клиенте** откройте выпадающее меню **AI клиент** и выберите вашего клиента: Claude Desktop, Claude Code, Cursor, Windsurf, VS Code или Codex CLI. Incogniton покажет готовую к вставке конфигурацию с уже заполненным новым токеном и укажет, куда его вставить. Нажмите **Копировать конфигурацию**, вставьте ее туда, куда указывает приложение, и перезапустите AI клиент.

Сначала создайте токен. Если вы откроете этот список позже, конфигурация будет содержать `YOUR_MCP_TOKEN` вместо токена: замените его на сохраненный вами токен.

Для ручной настройки в других MCP клиентах смотрите [документацию по MCP серверу](https://api-docs.incogniton.com/mcp).

### Что может делать AI клиент через MCP

После подключения ваш AI клиент может:

* **Профили:** искать, создавать, редактировать и клонировать профили, а также просматривать группы, теги, прокси и языки браузера, которые можно использовать для нового профиля.
* **Группы и теги:** искать и создавать группы и теги профилей.
* **Прокси:** искать и добавлять прокси, а также искать и создавать группы прокси.
* **Команда:** просматривать участников команды.
* **Запуск и остановка:** видеть, на каких компьютерах можно запустить профиль, запускать профиль, проверять, сработал ли запуск или остановка, и останавливать профиль.
* **Облачные телефоны:** перечислять ваши облачные телефоны, создавать облачный телефон с прокси из вашей библиотеки прокси и запускать или останавливать облачные телефоны. Телефоны, запущенные через MCP, запускаются без экрана.

Полный список инструментов находится в [документации по MCP серверу](https://api-docs.incogniton.com/mcp).

### Как работает запуск через MCP

Профиль всегда открывается в приложении Incogniton на одном из ваших компьютеров. Этот компьютер должен иметь открытое приложение и быть авторизованным в вашем аккаунте.

* Если доступен один компьютер, профиль запускается там. Если доступно несколько, AI клиент получает список компьютеров, и вы выбираете один.
* Запрос на запуск, который не был принят ни одним компьютером в течение 5 минут, истекает.
* MCP может останавливать только те профили, которые были запущены через MCP. Закройте профиль, который вы открыли самостоятельно из приложения Incogniton.

### Управление браузером после запуска через MCP

Сам MCP только открывает и закрывает профили. Он не может кликать, вводить текст или читать страницы внутри браузера.

После запуска AI клиент может получить локальный адрес DevTools (`cdp_url`) работающего браузера. AI клиент, который может выполнять код, может подключить Puppeteer, Playwright или браузер MCP к этому адресу.

{% hint style="info" %}
`cdp_url` работает только тогда, когда AI клиент работает на **том же компьютере**, что и приложение Incogniton, которое запустило профиль. Он не работает с другого компьютера или с клиента, который не может выполнять код, такого как Claude Desktop. Также необходимо, чтобы в вкладке Автоматизация была включена опция **Разрешить удаленное управление браузером**. См. [Удаленное управление браузером](https://docs.incogniton.com/documentation/russian-documentation/api-avtomatizacii-i-sdk/browser-remote-control.md).
{% endhint %}

### Что MCP не может делать

Эти действия недоступны через MCP:

* Открытие URL, управление вкладками или чтение страниц в работающем профиле.
* Проверка работоспособности прокси.
* Удаление профилей.
* Восстановление профиля из резервной копии.

Cas, AI помощник внутри приложения Incogniton, может выполнять эти действия. Откройте Cas в приложении, чтобы использовать их.

### Устранение неполадок

* **Клиент не показывает инструменты Incogniton:** перезапустите AI клиент после вставки конфигурации и проверьте, что установлена Node.js версии 18 или новее.
* **Журнал MCP клиента показывает "отсутствует токен носителя":** токен отсутствует в конфигурации. Вставьте ваш токен вместо `YOUR_MCP_TOKEN`.
* **Ошибки аутентификации:** токен был заменен или отозван. Создайте новый и обновите конфигурацию.

Для скриптов, которые запускаются на вашем собственном компьютере, вы также можете использовать [локальный REST API](https://docs.incogniton.com/documentation/russian-documentation/api-avtomatizacii-i-sdk/local-rest-api.md) или [JavaScript и Python SDK](https://docs.incogniton.com/documentation/russian-documentation/api-avtomatizacii-i-sdk/javascript-and-python-sdk.md).
