ariekogan/ateam-mcp

Аутентификация с A-Team. Требуется перед любой операцией, учитывающей тенант (чтение решений, развертывание, тестирование и т. д.). Пользователь может получить свой API-ключ по адресу https://mcp.ateam-ai.com/get-api-key. Только глобальные конечные точки (spec, examples, validate) работают без аутентификации. ВАЖНО: Даже если настроены переменные окружения (ADAS_API_KEY), вы ОБЯЗАНЫ явно вызывать ateam_auth - только env vars недостаточно. Для кросс-тенантных административных операций используйте master_key вместо api_key.

ОБЯЗАТЕЛЬНАЯ точка входа для A-Team MCP. ДОЛЖНА вызываться, когда пользователь приветствует, говорит «привет», спрашивает, что это, просит помощи, изучает возможности или при первом подключении MCP. Возвращает объяснение платформы, примеры решений и инструкции по поведению ассистента. НЕ импровизируйте с приветствием, вместо этого вызывайте этот инструмент.

РАЗВЕРНУТЬ ТЕКУЩУЮ ВЕТКУ MAIN НА A-TEAM CORE. ⚠️ САМАЯ ТЯЖЕЛАЯ ОПЕРАЦИЯ (60-180 с): проверяет solution+skills → разворачивает все connectors+skills на Core (пересоздаёт MCP серверы) → проверяет здоровье → опционально запускает warm test → автоматически пушит в GitHub. 🌳 DEV/PROD РАБОЧИЙ ПРОЦЕСС: 1. Редактировать файлы → ateam_github_patch (по умолчанию пишет в ветку `dev`) 2. (Опционально) Посмотреть, что скоро отправится → ateam_github_diff 3. Отправить dev → main → ateam_github_promote (слияние + автоматический тег `prod-YYYY-MM-DD-NNN`) 4. Развернуть main на Core → ateam_build_and_run Этот инструмент ВСЕГДА разворачивает ветку `main` — параметра `ref` нет. Чтобы развернуть незаконченную dev-работу, сначала продвигайте её. АВТОМАТИЧЕСКИ ОПРЕДЕЛЯЕТ GitHub репозиторий: если опустить mcp_store и репозиторий существует, код коннектора автоматически подтягивается из main. При первом развертывании требуется mcp_store. После этого редактируйте через ateam_github_patch + promote, затем build_and_run. Для небольших изменений предпочтительнее ateam_patch (быстрее, инкрементально). Требуется аутентификация.

SLIM chain status — the chip-quick poll. Given a chain_id (from ateam_conversation), returns the WHOLE-CHAIN aggregate status cheaply: chain_status + chain_done (true only when the ENTIRE chain — root job + every handoff + askAnySkill subcall — is terminal), plus pending_question, result, and a short progress line. This is what you poll on a loop after ateam_conversation — NOT ateam_get_chain (that returns the full tree; too heavy for periodic polling). A single job can finish while the chain is still running, so poll chain_done, not a job's status. Loop: call every ~2s until chain_done === true (or pending_question is set — the assistant is waiting on the user). Then read `result` / fetch the full tree once via ateam_get_chain if you need per-job detail.

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

Создайте каркас нового MCP коннектора с файлами server.js + package.json + README. Устраняет ~50% одинакового шаблонного кода (настройка MCP сервера, регистрация инструментов, stdio транспорт). Затем заполните реализации инструментов. Установите ui_capable=true, чтобы включить заглушки ui.listPlugins / ui.getPlugin (файлы исходного кода плагинов добавляются отдельно через ateam_create_plugin). После создания каркаса файлы загружаются в Core по тому же пути, что и ateam_upload_connector.

Создай каркас UI-плагина (iframe HTML, React Native TSX или оба варианта) внутри существующего коннектора. Это устраняет ~50% однотипного шаблонного кода (импорты, хуки темы/моста, протокол postMessage, форма экспорта по умолчанию). Остаётся только написать тело компонента. Используй kind='iframe' только для веба, 'rn' только для мобильных, 'adaptive' для обоих. Автообнаружение (Phase 5 of the strip) подхватит новый плагин при следующем деплое без объявления манифеста.

⚠️ CASCADING — любой навык, чьи engine.bootstrap_tools или tools[] ссылаются на коннектор из этого набора, ПРОВАЛИТ своё следующее выполнение. Останавливает и удаляет коннектор из A-Team Core; убирает ссылки из определения решения (grant'ы, platform_connectors, ui_plugins с идентификаторами, начинающимися на `mcp:<connector-id>:*`) и определений навыков (массив connectors); очищает файлы mcp-store. Исходный код на GitHub сохраняется — последующий вызов `ateam_build_and_run(github:true)` может восстановить коннектор. ТРЕБУЕТ `confirm:true`.

⚠️ НЕОБРАТИМО в Core + Builder FS — убивает работающий процесс MCP, удаляет из реестра навыков, удаляет запись в Mongo, убирает из solution.skills[] и solution.linked_skills, а также удаляет файлы навыка из Builder FS. ТРЕБУЕТ `confirm:true`. ВОССТАНОВЛЕНИЕ: навык остаётся в GitHub — `ateam_github_pull` пересобирает всё решение (отдельного пути восстановления навыка нет).

⚠️ НЕОБРАТИМО — уничтожает состояние Mongo, запущенные MCP-процессы и файловую систему Builder для всего решения и каждого скилла. ТРЕБУЕТ `confirm:true` И `confirm_solution_id`, который повторяет идентификатор уничтожаемого решения (защита от опечаток и галлюцинированных ID). ВОССТАНОВЛЕНИЕ: GitHub-репозиторий нетронут; `ateam_github_pull` пересобирает решение из `main`. Предпочитайте его повторному развёртыванию по памяти.

Проверяет полное дерево цепочки для любой задачи — начиная с указанного job_id, проходя по всем handoff и askAnySkill subcall. Используйте, когда цепочка уже выполнилась и вы хотите проанализировать структуру: какой скилл кого вызвал, насколько глубоко ушло дерево вызовов, какой инструмент внутри какой задачи вызвал какой под-инструмент. Две основные формы: • response.chain.chainJobs[] — одна запись на каждую задачу в цепочке. Поля: jobId, skill, status, iteration, depth (0 = корень, +1 за каждый hop askAnySkill), relation ('root' | 'subcall' | 'handoff'), parentJobId, parentSkill, goal. • response.chain.executionSteps[] — каждый вызов инструмента во всех задачах цепочки, размеченный _skill, _jobId, _depth (= глубина задачи), _relation, _parentSkill, _parentJobId, _toolDepth (вложенность инструмента в инструмент через opId/parentOpId). Отличается от ateam_test_status по назначению: status нужен для живого опроса задачи, которую вы только что запустили; get_chain — для посмертного анализа дерева (отладка многоскилловых потоков, регрессионное тестирование, сравнение двух запусков). Авторизация: пробрасывает ваш авторизованный api_key. Ограничивается тенантом самого ключа. Доступ по актору: вы можете просматривать только цепочки, корневые задачи которых доступны вашему актору.

Читает исходные файлы развернутого MCP-коннектора. Возвращает все файлы (server.js, package.json и т.д.), хранящиеся в mcp_store для этого коннектора. Используйте это ПЕРЕД патчингом или переписыванием коннектора: всегда сначала читайте текущий код, чтобы вносить точечные исправления, а не слепые перезаписи целиком.

Получите полные рабочие примеры, которые проходят проверку. Изучите их, прежде чем создавать свои собственные.

Чтение состояния решения: определение, навыки, работоспособность, статус или экспорт. Используйте это для проверки развернутых решений.

Получите спецификацию A-Team — схемы, правила валидации, системные инструменты, руководства по агентам и шаблоны. Начните здесь после начальной загрузки, чтобы понять, как создавать скиллы и решения. Используйте 'section', чтобы получить только одну часть спецификации скилла (гораздо меньше полной спецификации). Используйте 'search', чтобы найти конкретные поля или понятия по всей спецификации. При разработке персоны, которая управляет логикой через run_python_script (паттерн Python-as-orchestrator), также загрузите topic='python_helpers' — он вернет ссылку на пространство имен помощников adas.*. Скиллы, разработанные без знания adas.*, получаются в 5-10 раз больше и более хрупкими. При подключении виджетов (UI-плагинов) к решению загрузите topic='widgets' — он вернет спецификацию виджетов (модель каталога, блоки how_to_use, форму opener_call, правила формулировок персоны, семантику привязки), чтобы вы могли правильно объявить `ui_plugins`. Для получения живого каталога виджетов, фактически доступных в развернутом тенанте, используйте ateam_get_widget_catalog.

Получает живой каталог виджетов (UI-плагинов), доступных в решении данного экземпляра. Возвращает виджеты, входящие в состав платформы + решения + объявленные навыком, каждый с готовым к вставке блоком how_to_use (фрагмент solution.json + opener_call + persona_phrasing + binding_notes). Используйте это при подключении виджетов к навыку или решению: блок how_to_use предназначен для дословного копирования в запись ui_plugins[] в solution.json и в формулировку открывающей фразы персонажа. Так вам не придётся писать ничего вручную. Каталог отражает то, что фактически развёрнуто в экземпляре прямо сейчас, а не абстрактную спецификацию (для самой спецификации используйте ateam_get_spec topic='widgets'). Источники: • 'platform' = виджеты, входящие в состав платформы (всегда доступны). • 'solution' = виджеты, входящие в состав решения данного экземпляра. • 'skill' = виджеты, объявленные конкретным навыком в решении. Аутентификация: передаёт ваш аутентифицированный api_key в Core (без участия мастер-секрета). Область действия экземпляра определяется самим ключом.

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

ПРЕДВАРИТЕЛЬНАЯ ПРОВЕРКА ПЕРЕД ПРОДВИЖЕНИЕМ. По умолчанию сравнивает `dev` (голова) и `main` (база): показывает точно, какие коммиты и файлы будут отправлены, если следующим вызвать ateam_github_promote(). Используйте это, когда хотите: • Просмотреть изменения перед продвижением в продакшн • Узнать, опережает ли dev main вообще (возвращает ahead_by: 0, если продвигать нечего) • Проверить произвольные сравнения веток/тегов/коммитов (переопределить base/head)

Выводит список всех доступных контрольных точек (теги safe-*) для решения. Показывает имя тега, дату, счётчик и SHA коммита. Используйте перед откатом, чтобы увидеть доступные точки восстановления.

Просматривает историю коммитов для GitHub-репозитория решения. Показывает последние коммиты с сообщениями, SHA, временными метками и ссылками. По умолчанию читает из `main` (прод). Укажите `ref: 'dev'`, чтобы увидеть текущую работу.

Редактирует файл в GitHub-репозитории решения и делает коммит. Два режима: 1. FULL FILE: передаёшь `content` — заменяет весь файл (подходит для новых или маленьких файлов) 2. SEARCH/REPLACE: передаёшь `search` + `replace` — точечное редактирование без отправки полного файла (предпочтительно для больших файлов вроде server.js) Всегда используй search/replace для больших файлов (>5 КБ). Сначала всегда читай файл через ateam_github_read, чтобы получить точный текст для поиска. ПО УМОЛЧАНИЮ работает с веткой `dev` — изменения не трогают прод. Используй ateam_github_promote, чтобы перенести из dev → main, когда будет готово. Передавай ref:'main' только для экстренных исправлений.

SHIP DEV TO PROD. Сливает ветку `dev` с `main` и автоматически помечает новую голову main тегом safe-YYYY-MM-DD-NNN. Используйте после тестирования вашей разработки, когда будете готовы развернуть изменения в продакшене. Рабочий процесс: 1) ateam_github_patch (записывает в dev) → 2) ateam_github_promote (сливает dev→main) → 3) ateam_build_and_run (развёртывает main). Передайте dry_run:true, чтобы увидеть, что будет отправлено, без слияния. При конфликте слияния вызов возвращает 409 - разрешите конфликт вручную на GitHub (откройте PR или используйте веб-интерфейс), затем повторите попытку.

Разверните решение ИЗ его репозитория GitHub. Читает .ateam/export.json + исходный код коннектора из репозитория и передаёт их в пайплайн развёртывания. Используйте это, чтобы восстановить предыдущую версию или развернуть из GitHub как источник истины.

Отправляет текущее развёрнутое решение в GitHub. Автоматически создаёт репозиторий при первом использовании. Фиксирует атомарно полный пакет (решение + навыки + исходный код коннектора). Используйте после ateam_build_and_run, чтобы версионировать ваше решение, или в любой момент, когда хотите сделать снимок текущего состояния.

Читает любой файл из репозитория GitHub решения. Возвращает содержимое файла. Используйте, чтобы читать исходный код коннектора, определения скиллов или любой версионированный файл. По умолчанию читает из `main` (развёрнутое/продакшн состояние). Передайте `ref: 'dev'`, чтобы читать незавершённую работу.

Откати прод (ветку `main`) до предыдущего состояния. ADDITIVE — НЕ уничтожает историю. Создаёт новый коммит поверх main, дерево которого совпадает с деревом целевого коммита. История всего, что находится между целевым коммитом и текущим main, сохраняется (можно откатить откат). Порядок действий: 1) ateam_github_list_versions (найти тег safe-*) → 2) ateam_github_rollback(target: 'safe-...') → 3) ateam_build_and_run (разворачивает откаченное состояние).

Проверьте, есть ли у решения репозиторий на GitHub, его URL и последний коммит. Используйте это, чтобы убедиться, что интеграция с GitHub работает для решения.

Записывает файл в GitHub-репозиторий решения. Используйте это для создания новых файлов коннекторов или замены существующих — один файл за вызов. Это ОСНОВНОЙ способ записи кода коннектора после первого развёртывания. Записывайте каждый файл по отдельности (server.js, package.json, ресурсы UI), затем вызывайте ateam_github_promote() для отправки в продакшн (dev→main), затем ateam_build_and_run() для развёртывания. ПО УМОЛЧАНИЮ используется ветка `dev`.

Перечислите все решения, развернутые в Skill Builder.

Хирургически обновляет ЛЮБОЕ поле в определении навыка или решения, переразворачивает и опционально перезапускает тесты — всё за один шаг. ⚠️ MERGE-BY-DEFAULT (v0.4.0) — Массивы защищены от молчаливой замены. Прямая запись массива в solution.linked_skills / ui_plugins / platform_connectors / handoffs / grants / triggers (и т.д.) и skill.tools / connectors / handoffs / scenarios ОТКЛОНЯЕТСЯ — чтобы не потерять соседние элементы. Добавляйте или удаляйте элементы с суффиксами _push / _delete / _update; переключайтесь на полную замену массива, только когда вы намерены это сделать. ОПЕРАЦИИ (безопасные по построению): 1. Скалярные (точечная нотация): { "problem.statement": "новое значение", "role.persona": "Ты..." } 2. Глубоко вложенные: { "intents.thresholds.accept": 0.9, "policy.escalation.enabled": true } 3. ДОБАВЛЕНИЕ в массив: { "tools_push": [{ name: "new_tool", description: "..." }] } 4. УДАЛЕНИЕ из массива: { "tools_delete": ["tool_name"] } 5. ИЗМЕНЕНИЕ одного элемента: { "tools_update": [{ name: "existing_tool", description: "обновлено" }] } 6. Полная ЗАМЕНА массива (согласие обязательно): { "linked_skills": [...], "linked_skills_replace": true } — или { _replace: true, ... }, чтобы согласиться на замену всех массивов в этом вызове. ПРИМЕРЫ ДЛЯ РЕШЕНИЯ (target='solution'): - ДОБАВИТЬ навык в решение: updates: { "linked_skills_push": ["my-new-skill"] } ← НЕ { linked_skills: ["my-new-skill"] } (это ОТКЛОНИТСЯ — вы потеряете остальные навыки) - УДАЛИТЬ навык: updates: { "linked_skills_delete": ["old-skill"] } - ДОБАВИТЬ UI-плагин: updates: { "ui_plugins_push": [{ id: "mcp:conn:panel", ... }] } - ДОБАВИТЬ handoff: updates: { "handoffs_push": [{ id: "h1", ... }] } ПРИМЕРЫ ДЛЯ НАВЫКА (target='skill' + skill_id): - Изменить персону: updates: { "role.persona": "Ты — дружелюбный ассистент" } - Дополнить персону: updates: { "persona_append": "\n\nВСЕГДА отвечай двумя предложениями." } - Добавить ограничение: updates: { "policy.guardrails.never_push": ["Никогда не передавай пароли"] } - Добавить инструмент: updates: { "tools_push": [{ name: "conn.tool", description: "...", inputs: [...], output: {...} }] } - Изменить intent: updates: ...

Переразвернуть навыки БЕЗ изменения определений. ⚠️ ТЯЖЁЛАЯ ОПЕРАЦИЯ: заново генерирует MCP серверы (код на Python) для каждого навыка, отправляет каждый в A-Team Core, перезапускает коннекторы и проверяет обнаружение инструментов. Занимает 30-120 секунд в зависимости от количества навыков. Используйте после перезапусков коннекторов, сбоев Core или устаревшего состояния. Для инкрементальных изменений предпочитайте `ateam_patch` (обновляет и переразвёртывает за один шаг).

Показывает минимальное представление авторской части навыка — только persona, connectors, handoff_when, style и policy guardrails. ~10× меньше, чем ateam_get_solution(view:'skills') для того же навыка. Используйте, когда нужно только несократимое авторское содержимое (Phase 9 of the strip).

Покажите минимальное представление решения для редактирования — только name + description + style + routing_mode + identity_mode + skill ids + connector ids. Пропускает deployed metadata, handoffs (автоматически сгенерированные), grants, ui_plugins, validation results. Используйте для быстрой проверки без подробных полей (Phase 9 of the strip).

Показывает статус синхронизации с GitHub для ВСЕХ тенантов и решений за один вызов. Требует аутентификации по мастер-ключу. Возвращает сводную таблицу решений каждого тенанта с их статусом синхронизации с GitHub.

Синхронизировать ВСЕ тенанты: отправить Builder FS → GitHub, затем вытянуть GitHub → Core MongoDB. Требуется аутентификация с мастер-ключом. Возвращает сводную таблицу с результатами для каждого тенанта/решения.

Прервать выполняющийся тест навыка. Останавливает выполнение задания на границе следующей итерации. (Продвинутый.)

Вызовите инструмент на работающем коннекторе и получите результат. Используйте это для тестирования отдельных инструментов коннектора (например, triggers.list, entities.list, google.command) без развертывания на клиенте. Коннектор должен быть подключен и работать.

Отправляет НАСТОЯЩЕЕ уведомление существующему актору в развёрнутом решении — для сквозного тестирования пути уведомлений, инициированных системой (каналы telegram/push/app). В отличие от ateam_test_skill (синтетический тестовый актор без каналов) и ateam_conversation (поток, инициированный пользователем), этот вызов идёт по пути /api/internal/notify-user, который используют PCM и другие смежные сервисы — поэтому реальные включённые каналы актора действительно получают сообщение. Используется для: • Дымового теста разветвления по каналам (telegram/push/app — доходит ли?) • Проверки результата доставки (статус ok/failed для каждого канала в ответе). Аутентификация: передаёт ваш api_key в Core (без привлечения master-secret). Tenant привязывается самим ключом — технически невозможно отправить уведомление в чужой tenant. ⚠️ БЕЗОПАСНОСТЬ: • Текст уведомления получает префикс [TEST] — виден пользователю, защита от фишинга. • Ограничение частоты: 10 вызовов в минуту на сессию. • Каждый вызов аудируется (кто вызвал, tenant, актор, хэш содержимого) независимо от результата. • actor_id ограничен вашим tenant — попытка обратиться к чужому tenant отклоняется из-за изоляции по tenant в Core на уровне Mongo. • reply_handler НЕ поддерживается при аутентификации через api-key (Core его игнорирует). Направление следующего ответа пользователя в произвольный навык — это поверхность для повышения привилегий. Для тестов маршрутизации и вовлечения используйте ateam_test_skill.

Тестирует конвейер принятия решений (определение намерения → планирование) для навыка БЕЗ выполнения инструментов. Возвращает классификацию намерения, первое запланированное действие и время. Используйте это, чтобы отладить, почему навык неправильно классифицирует намерение или планирует неверное действие.

Отправляет тестовое сообщение в развёрнутый скилл и возвращает результат выполнения. Режимы ожидания (wait_for): • 'root' (по умолчанию, обратная совместимость) — ждать завершения корневой задачи сообщения, вернуть результат одной задачи. Быстро, игнорирует любые подскиллы, которым корневая задача делегировала через askAnySkill. • 'chain' — ждать, пока КАЖДАЯ задача в цепочке (корневая + handoffs + вызовы askAnySkill, рекурсивно) не достигнет терминального состояния, затем вернуть полное дерево цепочки. Используйте при тестировании многоскилльных потоков (оркестратор → воркеры, билдеры → суббилдеры и т.д.). Поле response.chain содержит chainJobs[] с parentJobId/relation/depth и executionSteps[] с вложенностью инструментов (opId/parentOpId/_toolDepth). Legacy: wait:false эквивалентно wait_for:'never' — сразу возвращает job_id для опроса через ateam_test_status. wait:true — то же, что и wait_for:'root' по умолчанию.

Опрашивает прогресс асинхронного теста навыка. Возвращает количество итераций, шаги вызова инструментов, статус (выполняется/завершено/ошибка) и результат по завершении. Установите include_chain:true, чтобы ТАКЖЕ включить полное дерево цепочек (каждое задание в цепочке, начиная с этого job_id, со связями родитель/потомок). Используйте, если это задание запускало подвызовы askAnySkill и вы хотите получить единый снимок состояния всех навыков вместо опроса каждого дочернего job_id по отдельности.

Симулирует голосовой разговор с развёрнутым решением. Запускает полный голосовой пайплайн (сессия → верификация вызывающего → промпт → диспетчер навыков → ответ), используя текст вместо аудио. Возвращает каждый шаг с ответом бота, статусом верификации, вызовами инструментов и сущностями. Используйте это, чтобы тестировать голосовые решения от начала до конца без телефонного звонка.

Загрузить код коннектора в Core и перезапустить - БЕЗ переразвёртывания навыков. По умолчанию СЛИВАЕТ с состоянием GitHub на `ref` (значение по умолчанию: 'dev'). Отправка частичного набора файлов ТОЛЬКО накладывает эти файлы — остальная часть коннектора сохраняется из GitHub. Чтобы полностью заменить директорию коннектора (как раньше), передайте replace:true. Режимы: • github:true (без файлов) — развернуть состояние GitHub на `ref` как есть. • github:true + files:[] — состояние GitHub на `ref` как БАЗА, ваши файлы накладываются поверх (входящие побеждают). • files:[] (без github) — по умолчанию СЛИЯНИЕ с состоянием GitHub на `ref`. Отказывается, если базы GitHub нет (никакого молчаливого удаления). • files:[] + replace:true — полная замена. Стирает директорию коннектора и записывает только переданные файлы. Используйте осознанно. Распространённые ловушки, которые предотвращает такое поведение: • Баг до исправления (2026-06-06): отправка только ui-dist HTML удаляла server.js + node_modules — коннектор ломался до полной перезагрузки. Сейчас: эти файлы сливаются с базой GitHub. • Баг до исправления: github:true молча читал из `main`, даже когда патчи были на `dev`. Сейчас: по умолчанию — dev; передайте ref:'main', чтобы использовать старый путь.

Проверяет, синхронизированы ли состояние файловой системы Builder и состояние GitHub для решения. Только чтение — НЕ запускает деплой. Возвращает: • ok: true + drifts: [], если всё совпадает • ok: false + drifts: [{path, kind}], со списком файлов, которые различаются (типы: fs_missing, gh_missing, content_differs) Расхождение может появиться, когда GitHub пишет, а Builder FS не получает обновление зеркала (сбой сети, перезапуск контейнера посередине записи). Boot-синхронизация исправляет большую часть при следующем перезапуске бэкенда; этот инструмент выявляет расхождение раньше. Запускай после серии вызовов ateam_github_patch, чтобы убедиться, что бэкенд Builder согласован с GitHub, перед тем как вызывать ateam_build_and_run.