MCP-сервер Bitrix24 на OAuth-приложении
Bitrix24 MCP Server
MCP-сервер Битрикс24 на локальном OAuth-приложении: CRM, задачи, скрам-эпики, база знаний 2.0 и структура компании
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- Создает, обновляет и закрывает задачи, а также создает и редактирует страницы базы знаний
- OAuth-приложение получает права на портал согласно выданным при создании scopes
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/ostor-bitrix24-mcp-serverОпределит агенты на машине, проверит риск и зафиксирует версию.
Другие способы установки
У записи высокий риск, поэтому установки в один клик нет. Посмотрите код и добавьте конфиг вручную.
Выполните в терминале
claude mcp add --transport stdio bitrix24 -- npx -y @modelcontextprotocol/inspector http://your-server-address:3000/sseИли добавьте в файл .mcp.json, в проекте
{
"mcpServers": {
"bitrix24": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/inspector",
"http://your-server-address:3000/sse"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Добавьте в файл ~/.cursor/mcp.json, для всех проектов
{
"mcpServers": {
"bitrix24": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/inspector",
"http://your-server-address:3000/sse"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.
Выполните в терминале
code --add-mcp '{"name":"bitrix24","type":"stdio","command":"npx","args":["-y","@modelcontextprotocol/inspector","http://your-server-address:3000/sse"]}'Или добавьте в файл .vscode/mcp.json, в проекте
{
"servers": {
"bitrix24": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/inspector",
"http://your-server-address:3000/sse"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа servers.
Выполните в терминале
codex mcp add bitrix24 -- npx -y @modelcontextprotocol/inspector http://your-server-address:3000/sseИли добавьте в файл ~/.codex/config.toml, для всех проектов
[mcp_servers.bitrix24]
command = "npx"
args = ["-y", "@modelcontextprotocol/inspector", "http://your-server-address:3000/sse"]Если файл уже есть, допишите блок в конец.
Добавьте в файл ~/.gemini/settings.json, для всех проектов
{
"mcpServers": {
"bitrix24": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/inspector",
"http://your-server-address:3000/sse"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов
{
"mcpServers": {
"bitrix24": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/inspector",
"http://your-server-address:3000/sse"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. В легаси Cascade конфиг MCP лежит в ~/.codeium/windsurf/mcp_config.json.
Бывший Windsurf.
Добавьте в файл cline_mcp_settings.json, для всех проектов
{
"mcpServers": {
"bitrix24": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/inspector",
"http://your-server-address:3000/sse"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.
Добавьте в файл .roo/mcp.json, в проекте
{
"mcpServers": {
"bitrix24": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/inspector",
"http://your-server-address:3000/sse"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Форк Roo Code, папки .roo те же.
Добавьте в файл opencode.json, в проекте
{
"mcp": {
"bitrix24": {
"type": "local",
"command": [
"npx",
"-y",
"@modelcontextprotocol/inspector",
"http://your-server-address:3000/sse"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcp.
Добавьте в файл ~/.config/zed/settings.json, для всех проектов
{
"context_servers": {
"bitrix24": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/inspector",
"http://your-server-address:3000/sse"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа context_servers.
Добавьте в файл .codeassistant/mcp.json, в проекте
{
"mcpServers": {
"bitrix24": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/inspector",
"http://your-server-address:3000/sse"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Создай локальное приложение в Битрикс24 с правами crm, task, tasks_extended, note и user, склонируй Ostor/bitrix24-mcp-server, заполни .env с client id, secret и адресом портала, запусти npm run build && npm start и подключи http://адрес:3000/sse в Claude Desktop.
Другие способы из описания автора
git clone https://github.com/Ostor/bitrix24-mcp-server.git && cd bitrix24-mcp-server && npm install && npm run build && npm startПеред запуском заполните .env с BITRIX24_CLIENT_ID, BITRIX24_CLIENT_SECRET и BITRIX24_PORTAL_URL.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер работает через SSE-транспорт по HTTP и подключается к порталу не входящим вебхуком, а полноценным локальным OAuth-приложением с client id и secret. Дает агенту чтение сделок и контактов CRM, чтение, список, создание, обновление, закрытие задач и комментарии к ним, просмотр эпиков скрама и привязку задач к ним, работу с базой знаний 2.0 (чтение баз, структуры и страниц в Markdown, создание и редактирование страниц) и данные о сотрудниках компании: текущий пользователь, поиск и список коллег. Разворачивается через Node.js или Docker Compose и слушает порт 3000 для SSE-подключений.
Для кого. Для команд, которым помимо CRM и задач важна работа с базой знаний 2.0 Битрикс24 через агента.
Подходит, если
- Нужна не только CRM, но и база знаний 2.0: чтение и редактирование страниц в Markdown
- Нужны эпики скрама и привязка задач к ним
- Готовы настроить полноценное OAuth-приложение, а не только входящий вебхук
Не подходит, если
- Нужна простая настройка на входящем вебхуке без OAuth-приложения
- Нужны лиды и другие CRM-сущности кроме сделок и контактов: их инструментов нет
- Нет доступа администратора портала для создания локального приложения
Пример запроса к агенту
Создай страницу в базе знаний с чек-листом для нового сотрудника и привяжи задачу настройки доступа к текущему эпикуОграничения
CRM покрывает только чтение сделок и контактов, без создания и без лидов. Для удаленного доступа из Claude Desktop нужен проброс порта или reverse proxy на nginx, README прямо описывает это как отдельный шаг. Требует прав администратора портала для создания локального приложения.
Как отключить. Остановите процесс сервера (pm2 stop или docker-compose down) и удалите локальное приложение в разделе Разработчикам портала.
MCP
- Транспорт
- http
- Авторизация
- OAuth
| Переменные окружения | |
|---|---|
| BITRIX24_CLIENT_ID обязательная, секрет | Код локального приложения Битрикс24 |
| BITRIX24_CLIENT_SECRET обязательная, секрет | Ключ локального приложения Битрикс24 |
| BITRIX24_PORTAL_URL обязательная | Адрес портала Битрикс24 |
Проверка безопасности
- Создает, обновляет и закрывает задачи, а также создает и редактирует страницы базы знаний
- OAuth-приложение получает права на портал согласно выданным при создании scopes
Коротко о README
Двуязычное README (английская и русская версии) описывает создание локального приложения в Битрикс24 с нужными правами, настройку .env с client id, secret и адресом портала, запуск через Node.js с pm2 или Docker Compose и подключение к Claude Desktop через SSE, включая проброс порта для удаленного сервера. Дан список инструментов по CRM, задачам, скраму, базе знаний и структуре компании. Лицензия MIT.
Частые вопросы
Нужен ли входящий вебхук?
Нет, сервер использует локальное OAuth-приложение с client id и client secret вместо вебхука.
Можно ли редактировать базу знаний 2.0?
Да, инструменты позволяют читать структуру, создавать и редактировать страницы в формате Markdown.
Похожие
Официальный MCP-сервер Salesforce DX: работа с org, метаданными, данными, пользователями и тестами Apex из агента
Официальный набор скиллов Яндекса: каталог, цены, остатки, заказы, витрина и еженедельная ревизия магазина на Яндекс.Кит через Claude Code или Codex
YouGile MCP от Indalo
YouGile MCP
Полное покрытие API YouGile из 65 операций с настраиваемыми правами, подтверждением записи и общим лимитом на компанию
Официальный MCP конкретного портала Битрикс24: внешний агент по OAuth или токену читает и меняет задачи, сделки, встречи и письма