# Установка CLI и MCP-сервера WireCat для ИИ-агента (/ru/docs/installation)

Подключите информацию, с которой должен работать ИИ-агент: переписку, заметки, почту, документы
или встречи. Выберите один инструмент ниже, установите его там, где агент сможет его запускать,
и проверьте небольшой результат. Для локальных файлов или скачанной расшифровки встречи аккаунт
мессенджера не нужен.

Всё уже установлено и подключено? [Подключите агента](/llms.mdx/docs/ru/agents/content.md) и
[попробуйте первую задачу](/llms.mdx/docs/ru/content.md#%D0%BF%D0%BE%D0%BF%D1%80%D0%BE%D0%B1%D1%83%D0%B9%D1%82%D0%B5-%D0%B7%D0%B0%D0%BF%D1%80%D0%BE%D1%81). При пустом поиске сначала проверяют
доступные данные, а не переустанавливают инструмент.

![Claude Code в терминале ставит инструмент WireCat через npm; в WireCat Desktop виден экран «Инструменты»](/screenshots/install/install-and-connect-light-ru.webp)

Не хотите работать в терминале? [WireCat Desktop](/ru/download) — приложение для macOS, Windows и
Linux. Оно устанавливает и обновляет эти инструменты, ставит Node.js, если его нет, даёт агентам навыки
инструментов и открывает вход в аккаунт для каждого. [Что умеет приложение](/llms.mdx/docs/ru/desktop/content.md).

**На этой странице:**

1. [Выберите инструмент](#выберите-инструмент)
2. [Настройте с помощью агента](#настройте-с-помощью-агента)
3. [Настройте вручную](#настройте-вручную)
4. [Node.js, npm и доступность команды](#nodejs-npm-и-доступность-команды)
5. [Проверьте первый полезный результат](#проверьте-первый-полезный-результат)
6. [Данные, обновления и фоновая работа](#данные-обновления-и-фоновая-работа)

## Выберите инструмент

| С чем работать | Установка и подключение |
|---|---|
| Заметки, локальные файлы или почта | [Установить Memo](/llms.mdx/docs/ru/memo/installation/content.md); для начала достаточно папки: см. [Markdown и Obsidian](/llms.mdx/docs/ru/markdown/content.md) |
| Чаты Telegram | [Установить Telegram](/llms.mdx/docs/ru/tg/installation/content.md); для бота — [настройка бота](/llms.mdx/docs/ru/tg/bot/content.md) |
| Чаты WhatsApp | [Установить WhatsApp](/llms.mdx/docs/ru/wa/installation/content.md); для бизнес-номеров — [настройка Cloud API бота](/llms.mdx/docs/ru/wa/bot/content.md) |
| Чаты MAX | [Установить MAX](/llms.mdx/docs/ru/max/installation/content.md); для бота — [настройка бота](/llms.mdx/docs/ru/max/bot/content.md) |
| Документы Google Диска | [Установить Drive](/llms.mdx/docs/ru/drive/installation/content.md) из npm, подключить Google и выбрать папку |
| Страницы и базы данных Notion | [Установить Notion](/llms.mdx/docs/ru/notion/installation/content.md) из npm, затем [войти с токеном Notion и скопировать страницы](/llms.mdx/docs/ru/notion/content.md#%D0%BF%D0%BE%D0%B4%D0%BA%D0%BB%D1%8E%D1%87%D0%B8%D1%82%D0%B5-%D0%B8-%D1%81%D0%BA%D0%BE%D0%BF%D0%B8%D1%80%D1%83%D0%B9%D1%82%D0%B5-%D1%81%D1%82%D1%80%D0%B0%D0%BD%D0%B8%D1%86%D1%8B) |
| Файлы на Яндекс Диске | [Установить Яндекс Диск](/llms.mdx/docs/ru/ydisk/installation/content.md) из npm, затем войти с токеном Яндекса и [скопировать папку](/llms.mdx/docs/ru/ydisk/usage/content.md#sync) |
| Встречи Google Календаря | [Установить Google Calendar](/llms.mdx/docs/ru/gcal/installation/content.md) из npm и войти в Google через приложение Google от WireCat или своё |
| Почта по IMAP | [Установить Mail](/llms.mdx/docs/ru/mail/installation/content.md) из npm, затем создать пароль приложения для ящика |
| Встречи или расшифровки Zoom | [Установить Zoom](/llms.mdx/docs/ru/zm/installation/content.md); подключить существующее/новое приложение или импортировать VTT без него |
| Звонки и расшифровки Google Meet | [Установить Google Calendar](/llms.mdx/docs/ru/gcal/installation/content.md), затем войти с `--grant meetings`: см. [Google Meet](/llms.mdx/docs/ru/google-meet/content.md) |
| CRM Битрикс24 | [Установить Битрикс24](/llms.mdx/docs/ru/b24/installation/content.md) из npm, затем создать входящий вебхук или локальное приложение на портале |
| CRM amoCRM или Kommo | [Установить amoCRM](/llms.mdx/docs/ru/amo/installation/content.md) из npm, затем создать приватную интеграцию в аккаунте и войти по ее токену |
| Звонки АТС Asterisk или FreePBX | [Установить и подключить Asterisk](/llms.mdx/docs/ru/pbx/installation/content.md): установить из npm на свой компьютер и подключить журнал звонков и записи |

В каждой инструкции есть точные команды, вход в аккаунт, поддерживаемые платформы и исправление
ошибок. Приложению Zoom нужен Public Client ID; собственное приложение Google Drive может
использовать JSON-файл клиента; Google Calendar входит через приложение Google от WireCat
или с JSON-файлом клиента вашего собственного приложения Google. Следуйте инструкции выбранного инструмента: единого файла
учётных данных для всех инструментов нет.

## Настройте с помощью агента

Используйте ИИ-агента (ИИ-агент, который может запускать команды на вашем компьютере, например Claude Code, Codex, Cursor или Gemini CLI. Чат в браузере без доступа к терминалу не сможет установить инструмент командной строки за вас.) с доступом к терминалу на этом компьютере: например Claude Code, Codex, Cursor
или Gemini CLI. Назовите выбранный инструмент и источник, затем скопируйте запрос:

```text prompt
Помоги настроить выбранный инструмент WireCat по его инструкции. Сначала проверь Node.js и npm.
Подключи только выбранный аккаунт или папку; вход я подтвержу сам.
Установи инструкции для моего агента и подготовь немного данных.
Проверь один вопрос только для чтения, покажи источник и укажи, каких данных не хватает.
Объясни, где хранятся данные и как остановить запущенные фоновые процессы.
```

Агент подготовит программы и объяснит следующий шаг. Вы разрешаете доступ через вход самого
сервиса. Если вход запускает агент, он вставляет QR-код или ссылку для входа вам в чат: см.
[если вход запускает агент](/llms.mdx/docs/ru/agents/content.md#agent-login). Действия с браузером или токеном бота описаны
в инструкции инструмента; пароли, токены и данные обратного вызова авторизации не отправляют в
обычный чат с агентом.

Для агента без терминала используйте [MCP](/llms.mdx/docs/ru/agents/content.md#mcp-%D0%B8-%D0%BD%D0%B0%D0%B2%D1%8B%D0%BA%D0%B8) или [доступ из браузера и с телефона](/llms.mdx/docs/ru/browser-apps/content.md).
Инструмент всё равно должен работать на компьютере под вашим управлением.

## Настройте вручную

1. **Выберите компьютер.** Проще начать на своём компьютере с Windows, macOS или Linux. Сервер
   удобен для регулярной работы, но сеансы и файлы будут на нём. Папка ноутбука не появляется
   на сервере автоматически. Два компьютера сразу не нужны.
2. **Проверьте среду запуска** командами ниже. Затем выполните команду установки из инструкции
   выбранного инструмента. Инструмент командной строки, или CLI, — программа, которую агент
   запускает через терминал.
3. **Подключите источник.** Следуйте шагам входа или импорта файлов. Установка пакета не даёт
   доступ к аккаунту; вход также не загружает все его данные.
4. **Подключите агента.** [Установите skill или настройте MCP](/llms.mdx/docs/ru/agents/content.md). Skill даёт инструкции
   агенту с терминалом; MCP открывает возможности инструмента совместимому агенту.
5. **Подготовьте первые данные и проверьте их.** Воспользуйтесь проверками ниже, прежде чем добавлять источники.

## Node.js, npm и доступность команды

Node.js (Программа для запуска инструментов tg, max и memo на вашем компьютере. Агент может проверить, установлена ли она, и помочь с настройкой.) запускает инструменты, npm устанавливает их.
Поддерживаются **22.16+ в ветке 22.x или 24+**; для tg в ветке 22.x нужен **22.19+**. Другие
варианты среды смотрите в инструкции выбранного инструмента. В терминале или PowerShell выполните:

```sh
node --version
npm --version
```

Если команды нет или версия устарела, попросите агента подготовить среду:

```text
Проверь, установлены ли Node.js и npm.
Если нужно, установи подходящую стабильную версию Node.js с npm для моей операционной системы: 22.19+ (ветка 22.x) или 24+.
Проверь node --version и npm --version, затем продолжи настройку мессенджера.
```

После установки проверьте версию инструмента **в той же среде, где работает агент**. Глобальная
установка добавляет команды в PATH — список папок, где терминал ищет программы. Откройте терминал
заново или перезапустите уже работающего агента, если он не находит новую команду.

### Предупреждение npm о скриптах установки

npm 11.17 и новее после первой глобальной установки `tg`, `max` или `memo` пишет
`install scripts not yet covered by allowScripts`. В нём названы скрипт настройки самого инструмента
и драйвер базы данных. В npm 11 оба скрипта всё равно выполняются и инструмент работает, поэтому
предупреждение можно не учитывать. npm 12 их блокирует. Выполните команду
`npm install -g --allow-scripts=…`, которую npm печатает под предупреждением: она разрешает только
названные пакеты и только один раз.

### Windows и доступность команды

Если PowerShell блокирует `npm.ps1`, используйте `npm.cmd`. Может понадобиться и `.cmd`-команда
самого инструмента; смотрите его инструкцию для Windows. У Telegram и MAX также есть установщик,
который настраивает PATH и инструкции агента. Не считайте, что он подходит для любого инструмента.
Следуйте шагам для [Telegram](/llms.mdx/docs/ru/tg/installation/content.md), [MAX](/llms.mdx/docs/ru/max/installation/content.md),
[Drive](/llms.mdx/docs/ru/drive/installation/content.md) или [Zoom](/llms.mdx/docs/ru/zm/installation/content.md).

## Проверьте первый полезный результат

Попросите агента проверить выбранный аккаунт или папку, загрузить небольшой период либо
импортировать небольшую папку и ответить на один вопрос с источником:

- **Переписка:** показать несколько чатов, загрузить нужный период и найти известное сообщение.
  [История Telegram](/llms.mdx/docs/ru/tg/archive/content.md) · [история MAX](/llms.mdx/docs/ru/max/archive/content.md).
- **Файлы или почта:** импортировать выбранную папку или настроенный почтовый ящик и найти знакомую фразу.
  [Memo](/llms.mdx/docs/ru/memo/content.md) · [почта](/llms.mdx/docs/ru/mail/email/content.md).
- **Drive:** импортировать одну выбранную папку и открыть документ из результата.
  [Первый импорт Drive](/llms.mdx/docs/ru/drive/usage/content.md).
- **Встречи:** получить или импортировать одну расшифровку и прочитать фрагмент со ссылкой.
  [Первый результат Zoom](/llms.mdx/docs/ru/zm/installation/content.md#check-your-first-result).

Успех — команда доступна, подключён нужный источник, сохранены полезные данные и агент может
на них сослаться. При пустом ответе проверьте даты и отсутствующие или непрочитанные файлы.
Сам по себе вход, установка skill или подключение MCP этого не подтверждает.

## Данные, обновления и фоновая работа

Сеансы и локальные данные остаются там, где работает инструмент. Агент может передавать прочитанные
материалы своему провайдеру ИИ согласно настройкам. Прежде чем разрешать изменения, изучите
[безопасность и движение данных](/llms.mdx/docs/ru/security/content.md) и [разрешения](/llms.mdx/docs/ru/configuration/content.md#%D0%BF%D1%80%D0%B0%D0%B2%D0%B0).

Установка не запускает постоянную синхронизацию или автоответы. Регулярным задачам нужен работающий
процесс или расписание; попросите агента объяснить, как остановить всё запущенное. Закрытие чата
не обязательно останавливает отдельный процесс. См. [регулярные задачи](/llms.mdx/docs/ru/prompting/content.md#recurring-tasks).

Обновление и удаление описаны в инструкции выбранного инструмента. Удаление пакета, локальных
данных и отзыв доступа к аккаунту — разные действия. Когда первая проверка пройдёт,
[выберите следующую задачу](/llms.mdx/docs/ru/content.md#%D0%BF%D0%BE%D0%BF%D1%80%D0%BE%D0%B1%D1%83%D0%B9%D1%82%D0%B5-%D0%B7%D0%B0%D0%BF%D1%80%D0%BE%D1%81).
