Скилл-пак Битрикс24 REST
Bitrix24 Agent Skill Pack
Скилл Битрикс24 REST с разбивкой по модулям, allowlist методов, подтверждением рискованных действий и аудит-логом
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- Дает агенту транзакционную запись в CRM, задачи, чаты и бизнес-процессы портала
- Вебхук хранит секретный ключ в URL, права зависят от того, что выдано при его создании
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/bitrix24-agent-skill-packОпределит агенты на машине, проверит риск и зафиксирует версию.
Другие способы установки
Выполните в терминале в папке проекта
npx skills add vrtalex/bitrix24-skill --skill bitrix24-agent -a claude-code -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Без сторонних утилит, из коммита 73e781d
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/vrtalex/bitrix24-skill.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/bitrix24-agent/
git -C "$tmp" checkout 73e781d48d2023f75f6e20afb5220d19bbd53e1a
mkdir -p .claude/skills
cp -R "$tmp/skills/bitrix24-agent" .claude/skills/bitrix24-agentКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Выполните в терминале в папке проекта
npx skills add vrtalex/bitrix24-skill --skill bitrix24-agent -a cursor -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Без сторонних утилит, из коммита 73e781d
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/vrtalex/bitrix24-skill.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/bitrix24-agent/
git -C "$tmp" checkout 73e781d48d2023f75f6e20afb5220d19bbd53e1a
mkdir -p .agents/skills
cp -R "$tmp/skills/bitrix24-agent" .agents/skills/bitrix24-agentКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Выполните в терминале в папке проекта
npx skills add vrtalex/bitrix24-skill --skill bitrix24-agent -a github-copilot -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Без сторонних утилит, из коммита 73e781d
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/vrtalex/bitrix24-skill.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/bitrix24-agent/
git -C "$tmp" checkout 73e781d48d2023f75f6e20afb5220d19bbd53e1a
mkdir -p .github/skills
cp -R "$tmp/skills/bitrix24-agent" .github/skills/bitrix24-agentКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Выполните в терминале в папке проекта
npx skills add vrtalex/bitrix24-skill --skill bitrix24-agent -a codex -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Без сторонних утилит, из коммита 73e781d
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/vrtalex/bitrix24-skill.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/bitrix24-agent/
git -C "$tmp" checkout 73e781d48d2023f75f6e20afb5220d19bbd53e1a
mkdir -p .agents/skills
cp -R "$tmp/skills/bitrix24-agent" .agents/skills/bitrix24-agentКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Выполните в терминале в папке проекта
npx skills add vrtalex/bitrix24-skill --skill bitrix24-agent -a gemini-cli -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Без сторонних утилит, из коммита 73e781d
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/vrtalex/bitrix24-skill.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/bitrix24-agent/
git -C "$tmp" checkout 73e781d48d2023f75f6e20afb5220d19bbd53e1a
mkdir -p .agents/skills
cp -R "$tmp/skills/bitrix24-agent" .agents/skills/bitrix24-agentКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Выполните в терминале в папке проекта
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/vrtalex/bitrix24-skill.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/bitrix24-agent/
git -C "$tmp" checkout 73e781d48d2023f75f6e20afb5220d19bbd53e1a
mkdir -p .devin/skills
cp -R "$tmp/skills/bitrix24-agent" .devin/skills/bitrix24-agentКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Бывший Windsurf.
Выполните в терминале в папке проекта
npx skills add vrtalex/bitrix24-skill --skill bitrix24-agent -a cline -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Без сторонних утилит, из коммита 73e781d
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/vrtalex/bitrix24-skill.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/bitrix24-agent/
git -C "$tmp" checkout 73e781d48d2023f75f6e20afb5220d19bbd53e1a
mkdir -p .cline/skills
cp -R "$tmp/skills/bitrix24-agent" .cline/skills/bitrix24-agentКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Выполните в терминале в папке проекта
npx skills add vrtalex/bitrix24-skill --skill bitrix24-agent -a roo -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Без сторонних утилит, из коммита 73e781d
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/vrtalex/bitrix24-skill.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/bitrix24-agent/
git -C "$tmp" checkout 73e781d48d2023f75f6e20afb5220d19bbd53e1a
mkdir -p .roo/skills
cp -R "$tmp/skills/bitrix24-agent" .roo/skills/bitrix24-agentКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Форк Roo Code, папки .roo те же.
Выполните в терминале в папке проекта
npx skills add vrtalex/bitrix24-skill --skill bitrix24-agent -a opencode -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Без сторонних утилит, из коммита 73e781d
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/vrtalex/bitrix24-skill.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/bitrix24-agent/
git -C "$tmp" checkout 73e781d48d2023f75f6e20afb5220d19bbd53e1a
mkdir -p .agents/skills
cp -R "$tmp/skills/bitrix24-agent" .agents/skills/bitrix24-agentКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Выполните в терминале в папке проекта
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/vrtalex/bitrix24-skill.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/bitrix24-agent/
git -C "$tmp" checkout 73e781d48d2023f75f6e20afb5220d19bbd53e1a
mkdir -p .agents/skills
cp -R "$tmp/skills/bitrix24-agent" .agents/skills/bitrix24-agentКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Выполните в терминале в папке проекта
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/vrtalex/bitrix24-skill.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/bitrix24-agent/
git -C "$tmp" checkout 73e781d48d2023f75f6e20afb5220d19bbd53e1a
mkdir -p .agents/skills
cp -R "$tmp/skills/bitrix24-agent" .agents/skills/bitrix24-agentКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Склонируй vrtalex/bitrix24-skill, прочитай skills/bitrix24-agent/SKILL.md и references/packs.md, настрой вебхук или OAuth портала Битрикс24 в .env и подключи нужные capability packs под задачу.
Другие способы из описания автора
git clone https://github.com/vrtalex/bitrix24-skill.gitПосле клонирования настройте .env с вебхуком или OAuth портала Битрикс24 и прочитайте SKILL.md.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Скилл дает агенту безопасный по умолчанию доступ к REST API Битрикс24 через вебхук или OAuth: вместо одного огромного allowlist методы разбиты на модульные наборы (core, comms, automation, collab и другие), каждый со своими справочниками и готовыми цепочками вызовов. Скрипт bitrix24_client.py проверяет метод по method_risk.json и required_params.json перед вызовом, рискованные операции требуют явного подтверждения, а offline_sync_worker.py умеет работать в режиме отложенной синхронизации. README подробно объясняет модель авторизации: входящий вебхук для одного портала, OAuth-приложение для мультипортального сценария, исходящий вебхук как точка входа для событий, и отдельно поясняет, когда для точности методов стоит использовать официальный MCP-сервер Битрикс24, а не этот скилл.
Для кого. Для команд на Битрикс24, которым важна безопасность транзакционных вызовов агента: allowlist, подтверждения и аудит вместо доверия на слово.
Подходит, если
- Нужен агент с реальными правами на запись в Битрикс24, но с allowlist и подтверждением рискованных методов
- Нужны готовые цепочки вызовов по модулям: CRM и задачи, чаты и телефония, бизнес-процессы, рабочие группы
- Нужен аудит-лог того, какие методы и с какими параметрами вызывал агент
Не подходит, если
- Нужен только справочник методов и полей для точной генерации кода: для этого лучше официальный MCP-сервер Битрикс24
- Не готовы разбираться с моделью авторизации вебхук против OAuth и выбирать правильный вариант
- Нужна мультипортальная работа с ротацией токенов без настройки OAuth-приложения
Пример запроса к агенту
Создай сделку по новому лиду и поставь задачу ответственному менеджеру, запроси подтверждение перед изменением стадииОграничения
Внешние подключения ИИ к Битрикс24 должен включить администратор портала в настройках MCP servers. Вебхук дает права, заданные при его создании, и хранит секретный ключ прямо в URL, поэтому его нельзя класть в публичный или фронтенд-код. Скилл не заменяет официальный MCP Битрикс24 для точного справочника методов, а служит governed-слоем для транзакционных записей.
Как отключить. Удалите skills/bitrix24-agent из установки агента и отзовите вебхук или OAuth-подключение в разделе Apps - MCP connections портала Битрикс24.
Проверка безопасности
- Дает агенту транзакционную запись в CRM, задачи, чаты и бизнес-процессы портала
- Вебхук хранит секретный ключ в URL, права зависят от того, что выдано при его создании
Коротко о README
README на английском подробно объясняет модель авторизации Битрикс24 (вебхук, OAuth, исходящий вебхук, MCP) с таблицей, когда что использовать, и дает пошаговую административную инструкцию включения внешних ИИ-подключений в настройках портала. Описана модель capability packs вместо одного большого allowlist, структура проекта со скриптами bitrix24_client.py и offline_sync_worker.py, и правила безопасности вебхуков: не публиковать секретный ключ, следить за вкладками Integrations и Statistics.
Частые вопросы
Чем этот скилл отличается от официального MCP Битрикс24?
MCP лучше подходит для обнаружения методов и полей при генерации кода, а этот скилл governed-слой для реальных транзакционных записей с allowlist и подтверждением.
Что покрывает пакет core?
CRM, задачи tasks.task, пользователей, события и batch-вызовы, это базовый набор для большинства сценариев.
Похожие
Официальный MCP-сервер Salesforce DX: работа с org, метаданными, данными, пользователями и тестами Apex из агента
Официальный набор скиллов Яндекса: каталог, цены, остатки, заказы, витрина и еженедельная ревизия магазина на Яндекс.Кит через Claude Code или Codex
YouGile MCP от Indalo
YouGile MCP
Полное покрытие API YouGile из 65 операций с настраиваемыми правами, подтверждением записи и общим лимитом на компанию
Официальный MCP конкретного портала Битрикс24: внешний агент по OAuth или токену читает и меняет задачи, сделки, встречи и письма