MCP-сервер портала Битрикс24
Официальный MCP конкретного портала Битрикс24: внешний агент по OAuth или токену читает и меняет задачи, сделки, встречи и письма
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- Агент по OAuth или токену может менять задачи, сделки, встречи и отправлять письма от имени портала
- Доступ действует в рамках прав авторизованного сотрудника, поэтому скомпрометированный токен раскрывает эти же права
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/mcp-server-portala-bitriks24Определит агенты на машине, проверит риск и зафиксирует версию.
Другие способы установки
У записи высокий риск, поэтому установки в один клик нет. Посмотрите код и добавьте конфиг вручную.
Выполните в терминале
claude mcp add --transport http mcp-server-portala-bitriks24 https://mcp.bitrix24.tech/mcp/Или добавьте в файл .mcp.json, в проекте
{
"mcpServers": {
"mcp-server-portala-bitriks24": {
"type": "http",
"url": "https://mcp.bitrix24.tech/mcp/"
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Добавьте в файл ~/.cursor/mcp.json, для всех проектов
{
"mcpServers": {
"mcp-server-portala-bitriks24": {
"url": "https://mcp.bitrix24.tech/mcp/"
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.
Выполните в терминале
code --add-mcp '{"name":"mcp-server-portala-bitriks24","type":"http","url":"https://mcp.bitrix24.tech/mcp/"}'Или добавьте в файл .vscode/mcp.json, в проекте
{
"servers": {
"mcp-server-portala-bitriks24": {
"type": "http",
"url": "https://mcp.bitrix24.tech/mcp/"
}
}
}Если файл уже есть, добавьте сервер внутрь ключа servers.
Выполните в терминале
codex mcp add mcp-server-portala-bitriks24 --url https://mcp.bitrix24.tech/mcp/Или добавьте в файл ~/.codex/config.toml, для всех проектов
[mcp_servers.mcp-server-portala-bitriks24]
url = "https://mcp.bitrix24.tech/mcp/"Если файл уже есть, допишите блок в конец.
Выполните в терминале
gemini mcp add -s user -t http mcp-server-portala-bitriks24 https://mcp.bitrix24.tech/mcp/Или добавьте в файл ~/.gemini/settings.json, для всех проектов
{
"mcpServers": {
"mcp-server-portala-bitriks24": {
"httpUrl": "https://mcp.bitrix24.tech/mcp/"
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов
{
"mcpServers": {
"mcp-server-portala-bitriks24": {
"serverUrl": "https://mcp.bitrix24.tech/mcp/"
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. В легаси Cascade конфиг MCP лежит в ~/.codeium/windsurf/mcp_config.json.
Бывший Windsurf.
Добавьте в файл cline_mcp_settings.json, для всех проектов
{
"mcpServers": {
"mcp-server-portala-bitriks24": {
"type": "streamableHttp",
"url": "https://mcp.bitrix24.tech/mcp/"
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.
Добавьте в файл .roo/mcp.json, в проекте
{
"mcpServers": {
"mcp-server-portala-bitriks24": {
"type": "streamable-http",
"url": "https://mcp.bitrix24.tech/mcp/"
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Форк Roo Code, папки .roo те же.
Добавьте в файл opencode.json, в проекте
{
"mcp": {
"mcp-server-portala-bitriks24": {
"type": "remote",
"url": "https://mcp.bitrix24.tech/mcp/"
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcp.
Добавьте в файл ~/.config/zed/settings.json, для всех проектов
{
"context_servers": {
"mcp-server-portala-bitriks24": {
"url": "https://mcp.bitrix24.tech/mcp/"
}
}
}Если файл уже есть, добавьте сервер внутрь ключа context_servers.
Администратор портала включает интеграции в разделе Приложения, MCP-подключения, затем для ChatGPT или Cursor выбирает OAuth и авторизуется в аккаунте Битрикс24, а для Yandex AI Studio или n8n нажимает Получить токен подключения и вставляет его в настройки MCP-сервера с адресом https://mcp.bitrix24.tech/mcp/.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Это отдельный от документационного MCP сервер: он подключает внешние ИИ-системы, например ChatGPT, Cursor, Yandex AI Studio или n8n, напрямую к данным конкретного портала Битрикс24, а не к справке по REST API. Через OAuth (для ChatGPT и Cursor) или через токен, который администратор выпускает в разделе MCP-подключений (для Yandex AI Studio и n8n), внешний агент получает доступ к задачам, сделкам и воронкам CRM, календарю, структуре компании, письмам и созданию событий из писем. Помощник Битрикс24 по имени Марта работает поверх того же MCP без ручной настройки.
Для кого. Для компаний на Битрикс24 с подпиской BitrixGPT + Маркетплейс, которые хотят подключить внешнего ИИ-агента к живым данным своего портала.
Подходит, если
- Нужно, чтобы внешний агент искал и обновлял задачи, сделки или встречи в Битрикс24
- Нужно подключить конкретный портал к ChatGPT, Cursor, Yandex AI Studio или n8n напрямую
- Нужен доступ с учетом прав конкретного сотрудника, а не общий сервисный ключ
Не подходит, если
- На портале нет подписки BitrixGPT + Маркетплейс: без нее MCP-подключения недоступны
- Нужна просто документация по REST API для написания своего кода: для этого есть отдельный MCP mcp-dev.bitrix24.com/mcp
- Администратор портала не разрешил интеграции в настройках MCP: без этого подключение не заработает
Пример запроса к агенту
Найди мои просроченные задачи в Битрикс24 и покажи сделки на стадии переговоровОграничения
Работа MCP-подключений на портале bitrix24.ru требует подписки BitrixGPT + Маркетплейс и предварительного разрешения интеграций администратором. Справка не публикует полный перечень доступных методов и границ прав для каждого способа авторизации. OAuth подходит для ChatGPT и Cursor, токен из раздела MCP-подключений для Yandex AI Studio и n8n, смешивать способы для одного клиента справка не описывает.
Как отключить. Отзовите подключение в разделе Приложения, MCP-подключения портала Битрикс24 и удалите интеграцию из настроек внешней ИИ-системы.
MCP
- Транспорт
- http
- Авторизация
- OAuth
Проверка безопасности
- Агент по OAuth или токену может менять задачи, сделки, встречи и отправлять письма от имени портала
- Доступ действует в рамках прав авторизованного сотрудника, поэтому скомпрометированный токен раскрывает эти же права
Коротко о README
Справка Битрикс24 объясняет MCP-сервер портала как способ управлять Битрикс24 из чата с внешней ИИ-системой без установки: пользователь авторизуется прямо в диалоге с агентом Марта или другим агентом. Отдельная статья про подключение внешних систем называет точный адрес https://mcp.bitrix24.tech/mcp/, два способа авторизации (OAuth для ChatGPT и Cursor, токен для Yandex AI Studio и n8n) и пошаговые инструкции для обоих. Перечислены доступные ассистенту действия: работа с задачами, сделками и воронками, отделами и командами, письмами и созданием событий из писем, все в рамках прав пользователя и подписки BitrixGPT + Маркетплейс.
Частые вопросы
Чем это отличается от MCP-сервера REST API?
MCP mcp-dev.bitrix24.com/mcp отдает справку по REST API для разработчиков, а этот сервер дает внешнему агенту прямой доступ к данным конкретного портала: задачам, сделкам, встречам.
Нужна ли отдельная подписка?
Да, на портале bitrix24.ru MCP-подключения работают в рамках подписки BitrixGPT + Маркетплейс.
Похожие
Официальный MCP-сервер Salesforce DX: работа с org, метаданными, данными, пользователями и тестами Apex из агента
Официальный набор скиллов Яндекса: каталог, цены, остатки, заказы, витрина и еженедельная ревизия магазина на Яндекс.Кит через Claude Code или Codex
YouGile MCP от Indalo
YouGile MCP
Полное покрытие API YouGile из 65 операций с настраиваемыми правами, подтверждением записи и общим лимитом на компанию
Локальный набор скиллов и только читающий CLI для Codex: превращает свою переписку в WeChat в поиск, дайджесты, напоминания о недоеденном и учет договоренностей