Агенты (MCP)

Shortex умеет отдавать управление фермой ИИ-агенту: Claude Code, Cursor, Codex CLI и любому клиенту, который говорит по протоколу MCP. Агент делает то же самое, что делаете вы руками — заводит аккаунты, назначает прокси, готовит профили, запускает прогрев, уникализацию, автозалив и продвижение, читает статусы задач.

Это функция для продвинутых пользователей. Без неё Shortex работает полностью.

Только в приложении на компьютере

Вкладка «Настройки» → «Агенты (MCP)» есть в приложении на ПК и отсутствует в веб-кабинете: сервер живёт локально, на вашей машине.

Как это устроено

• Сервер слушает только 127.0.0.1 — из интернета к нему не подключиться.
• Порт по умолчанию 8765, адрес http://127.0.0.1:8765/mcp.
• Каждый запрос требует заголовок Authorization: Bearer <токен>.
• Запросы из браузера отклоняются: сервер предназначен для агентов, не для веб-страниц.
• По умолчанию сервер выключен.

Включение

1. «Настройки» → вкладка «Агенты (MCP)».
2. Включить тумблер «MCP-сервер».
3. При необходимости сменить порт и нажать «Применить».
4. Скопировать токен кнопкой рядом с ним.

Токен генерируется при первом включении и хранится зашифрованным. На экране он показан маской, в буфер копируется настоящий. Кнопка «Обновить токен» отзывает старый — после неё придётся обновить конфиг во всех клиентах.

Подключение

На той же вкладке есть готовые сниппеты — скопировать и вставить. Ниже <ТОКЕН> — значение из настроек.

Claude Code:

claude mcp add --transport http shortex http://127.0.0.1:8765/mcp --header "Authorization: Bearer <ТОКЕН>"

Cursor, Windsurf и другие клиенты с файлом mcp.json:

{
  "mcpServers": {
    "shortex": {
      "url": "http://127.0.0.1:8765/mcp",
      "headers": { "Authorization": "Bearer <ТОКЕН>" }
    }
  }
}

Клиенты, которые умеют только stdio, подключаются через мост mcp-remote — сниппет для них тоже есть на вкладке.

Что умеет агент

Инструменты сгруппированы по разделам интерфейса: аккаунты, прокси, профили, прогрев, креативы и версии, уникализация, автозалив, продвижение, оформление каналов, задачи и журнал. Список групп виден на самой вкладке.

Безопасность

Вопрос	Ответ
Кто-то извне может подключиться?	Нет: сервер слушает только петлевой адрес
Что даёт токен	Полное управление фермой на этой машине — обращайтесь с ним как с паролем
Веб-страница сможет дёрнуть сервер?	Нет: запросы с Origin браузера отклоняются
Уходит ли токен на наши серверы	Нет, он существует только на вашем компьютере

Частые ошибки

Симптом	Причина	Решение
«MCP-сервер не запущен: EADDRINUSE»	Порт 8765 занят другой программой	Сменить порт на вкладке и нажать «Применить»
Агент не видит инструменты	Не совпал токен или сервер выключен	Сверить токен, проверить тумблер
Работало, перестало после «Обновить токен»	Старый токен отозван	Обновить конфиг во всех клиентах
Вкладки «Агенты (MCP)» нет	Вы в веб-кабинете	Открыть приложение на компьютере

Дальше: Настройки · Что уходит наружу