Подключение к Claude (MCP)

Дайте внешнему Claude (Desktop или Code) доступ к вашему пространству: смотреть агентов, запускать их и генерировать медиа — в рамках лимитов.

Что это даёт

Вы можете подключить внешний Claude (приложение Claude Desktop или Claude Code) к вашему пространству по протоколу MCP. После подключения Claude сможет видеть ваших агентов, запускать их и генерировать изображения и видео — строго в рамках этого пространства и его лимитов. По сути, вы даёте Claude управлять платформой из своего окна.

Управление идёт по токену: вы выпускаете его в настройках и вставляете в Claude. Отозвать доступ можно в любой момент — токен сразу перестанет работать. Токен сотрудника перестаёт работать и тогда, когда его место в команде не оплачено: доступ вернётся сам после продления подписки.

Где это настроить

Откройте раздел «Настройки» → «Подключение к Claude». Прямой адрес страницы — /settings/workspace/mcp. Там же показан адрес MCP-сервера и готовые команды для подключения.

Как выпустить токен

  1. На странице «Подключение к Claude» введите название токена — например, «Claude на ноутбуке».
  2. Нажмите «Выпустить».
  3. Токен показывается только один раз и в дальнейшем не восстанавливается. Сразу скопируйте его. Если потеряли — выпустите новый, а старый отзовите.
  4. В списке активных токенов хранится только начало токена (префикс) — по нему вы узнаёте, какой из них какой.

Как подключить Claude Code

  1. На странице «Подключение к Claude» скопируйте готовую команду (кнопка «Копировать» рядом с блоком «Claude Code»).
  2. Команда выглядит так (адрес сервера и токен подставляются автоматически):
claude mcp add --transport http dirizhor <адрес-сервера> --header "Authorization: Bearer <ВАШ_ТОКЕН>"
  1. Вставьте команду в терминал и выполните её — Claude Code запомнит подключение «dirizhor».

Как подключить Claude Desktop

  1. На странице «Подключение к Claude» скопируйте готовый фрагмент для файла настроек (блок «Claude Desktop»).
  2. Вставьте его в файл конфигурации Claude Desktop (claude_desktop_config.json) и замените плейсхолдер токена на ваш выпущенный токен.
  3. Перезапустите приложение Claude Desktop — мост подтянется автоматически.

Какие инструменты получает Claude

После подключения Claude видит шесть инструментов, строго в рамках вашего пространства:

  • list_agents — список ваших агентов (название, описание, статус).
  • run_agent — запустить агента по его id с текстовым запросом и получить ответ.
  • generate_image — поставить в очередь генерацию изображения по описанию.
  • generate_video — поставить в очередь генерацию видео по описанию.
  • make_video — собрать короткий вертикальный ролик под ключ (подробнее — Видео-завод).
  • get_job_status — проверить статус генерации и забрать готовый файл.

Инструменты конструктора

С сентября Claude может собирать и проверять агентов сам, не заходя в браузер. Всё строго в вашем пространстве, каждая запись попадает в журнал действий, секреты наружу не выходят.

  • Граф — get_agent, list_node_types, create_agent (в том числе из шаблона), apply_graph_ops и put_agent_graph с версией графа (перед каждой записью сохраняется снимок), list_graph_versions, restore_graph_version.
  • Проверка — simulate_event: прогнать текст, голос текстом, фото, кнопку, команду или запуск по расписанию и получить ответ, кнопки, таймер, шаги по нодам и стоимость. Ничего наружу не уходит. Плюс get_run и list_runs.
  • Данные — list_collections, query_rows, aggregate_rows, insert_rows, export_rows, update_rows и delete_rows (те же записи, что в разделе «Данные»). Удалять можно по списку id или по фильтру; удаление по фильтру двухшаговое — сначала Claude узнаёт, сколько записей попадёт под удаление, и только повтор с confirm удаляет. Так устроено «перезаписать расписание на день»: удалить записи за дату, затем записать новые.
  • Рутины и канал — list_routines, upsert_routine, run_routine_now, get_bot_status (без токена бота), send_to_owner_chat (у него есть record: false — прислать вам сообщение, не записывая его в переписку агента; так сводки и выпуски не оседают в его памяти).
  • Мини-приложение — get_mini_app_schema (схема, коллекции агента и памятка по блокам), set_mini_app_schema (запись целиком, с validate_only — только проверить, ничего не записывая), preview_mini_app_data (посчитать вкладку так, как её увидит владелец), push_chat_panel (отправить панель кнопок в чат).
  • Подключения и подтверждения — list_connectors, list_connected_services, request_connection, request_bot_connection, attach_connection, request_owner_approval, get_request, list_requests, cancel_request. Как это устроено — в следующем разделе.

Чего через подключение к Claude нельзя никогда: передать ключ, токен или пароль (таких полей у инструментов просто нет), напрямую записать подключение к сервису, бота или коллекцию данных, применить миграцию, заглянуть в чужое пространство. Остальные опасные шаги проходят через вас — см. ниже.

Подключения и подтверждения

Раньше на просьбу подключить сервис или выдать право записи Claude просто отвечал отказом. Теперь он может ПОПРОСИТЬ вас — а решение и ввод ключей остаются за вами.

Что делает Claude

  • Смотрит каталог сервисов и ваши подключения: какие сервисы есть, что уже подключено, какие операции у сервиса. Ключи и токены ему не отдаются ни при каких условиях.
  • Просит подключить сервис или Telegram-бота: создаёт запрос и отправляет вам ссылку на страницу подключения. Ключ и токен на этой странице вводите только вы.
  • Привязывает уже подключённый сервис к ноде агента — ноде «Интеграция» с операцией или LLM-ноде как инструмент. Сам, без вас, он так даёт ноде только ЧТЕНИЕ: если привязка даёт ноде право менять что-то в сервисе (операция записи, нода «Автономный агент», LLM-нода, которой запись уже разрешена), она уходит вам карточкой на подтверждение.
  • Просит подтвердить опасный шаг: разрешить ноде писать в подключённый сервис (галочка записи у LLM-ноды, операция записи у ноды «Интеграция», подключения у ноды «Автономный агент», интеграция с вашими ключами у нод HTTP, Email и Telegram — и смена того, куда и что такая нода отправляет: адрес и метод запроса, получатель письма или чтение ящика, чат), изменить список «Кто может писать боту», включить, выключить или отключить бота, удалить коллекцию данных. То же происходит, когда обычная правка графа задевает эти настройки: она не применяется молча, а уходит вам карточкой.
  • Следит за судьбой запроса (get_request, list_requests) и может отозвать его сам, если ошибся (cancel_request) — тогда карточка у вас гаснет.

Что делаете вы

  1. Получаете сообщение в Telegram (если к боту привязан ваш личный чат) и видите тот же запрос в разделе «Согласования».
  2. Запрос на подключение — открываете ссылку в браузере, где вы вошли в Дирижёр, вводите ключ или нажимаете «Войти через…». Ссылка живёт 24 часа и без вашего входа бесполезна: в адресе только номер запроса, никаких секретов.
  3. Запрос на действие — читаете карточку и нажимаете «Подтвердить» или «Отклонить». На карточке написано, что именно вы разрешаете: полный список Telegram ID, какие подключения получат право записи, сколько строк в коллекции, какого бота это касается.
  4. Пояснение от внешней программы показывается отдельной строкой с пометкой, что это её текст. Проверяйте по карточке, а не по пояснению.
  5. Пока вы не нажали, ничего не меняется. Повторное нажатие безопасно — решение засчитывается один раз, в Telegram и на сайте это одна и та же карточка.

Где искать запросы

  • Агенты → «Согласования» (/approvals): сверху блок «Ждут вашего участия: подключения» с кнопками «Открыть» и «Отменить», ниже — обычная очередь, где запросы на действие стоят рядом с черновиками публикаций.
  • Telegram: ссылка приходит кнопкой «Открыть страницу подключения», действие — кнопками «Подтвердить» и «Отклонить» в чат владельца агента. Личный чат привязывается во вкладке «Telegram» на странице агента (кнопка «Сгенерировать код привязки», затем «/owner КОД» боту).
  • Число рядом с пунктом «Согласования» в меню считает и черновики, и запросы на подключение — по нему видно, что вас ждут.
  • Если личного чата нет, запрос никуда не пропадает: он живёт в «Согласованиях», и Claude честно предупредит, что доставить его в Telegram не удалось.

Чего не будет никогда

  • Claude не спрашивает и не получает ключи, токены и пароли — их вводите только вы на странице.
  • Он не пишет напрямую в подключения, ботов и коллекции: он создаёт запрос, а делает дело платформа после вашего решения.
  • Он не применяет миграции и не видит соседние пространства — всё строго в рамках пространства своего токена.
  • Право что-то ЗАПИСЫВАТЬ в подключённом сервисе и список «Кто может писать боту» правкой графа в обход подтверждения не достаются никакой ноде: такая правка сама превращается в запрос к вам. Это касается и галочки записи у LLM-ноды, и операции у ноды «Интеграция», и списка подключений у ноды «Автономный агент».

Подтвердить запрос может тот, кому открыт нужный раздел карты доступов: отключить бота — «Каналы и подключения», удалить коллекцию — «Клиенты и переписка». Каждое решение попадает в журнал действий (Настройки → «Команда» → «Что происходило»).

Права и срок токена

  • Полный — конструктор, данные, рутины. Для Claude Code, который собирает агентов.
  • Чтение и тесты — смотреть и проверять, но не менять графы, данные и рутины.
  • Только запуск и медиа — как раньше, без инструментов конструктора.
  • Срок: 30 или 90 дней, год или бессрочно. Просроченный токен перестаёт работать сам.
  • Список разрешённых инструментов снимается в момент выпуска токена. Поэтому уже выпущенные токены «Чтение и тесты» новых инструментов (например, мини-приложения) не увидят, пока вы не выпустите токен заново.

Стоимость и лимиты

  • Запуск агента и генерация медиа через Claude оплачиваются кредитами из того же общего счёта пространства, что и работа внутри платформы. Отдельного бюджета у подключения нет.
  • Действуют и все обычные предохранители: месячный пакет, запас на 7 дней и дневной потолок генерации. Если запас недели исчерпан, вызовы через Claude приостановятся, а ответы агентов клиентам продолжат работать.
  • Расход виден в разделе «Использование».
  • Отозвать доступ можно в любой момент — токен перестанет работать сразу.

Если страница подключения показана неактивной с пометкой «Скоро» — эту часть мы ещё заканчиваем на своей стороне; делать вам ничего не нужно. Как устроены кредиты — в разделе «Кредиты и лимиты».