Б24

Битрикс24

в очереди неофициальный

Сделки, лиды, задачи и товарные позиции — вызов из агента напрямую.

Отдельного адреса у магазина нет: он вызывается через общий эндпоинт аргументом server="bitrix24".

Ещё не подключён Манифест JSON

категория

CRM

тип сервера

неофициальный

авторизация

OAuth 2.0

происхождение

РФ

статус

в очереди

Об источнике

Что это за источник

Битрикс24 — CRM и корпоративный портал: сделки, лиды, контакты, задачи и общение с клиентами. Многие интернет-магазины ведут в нём заказы и обращения покупателей.

Что будет доступно после подключения

Найти клиента по телефону или почте и показать историю его сделок.
Создать сделку с товарными позициями по заказу, собранному агентом, — с подтверждением человеком.
Добавить в карточку клиента комментарий по итогам разговора с агентом.
Поставить задачу менеджеру, когда вопрос покупателя требует участия человека.

Что есть в API

REST API доступен двумя способами. Для своего портала проще всего входящий вебхук: адрес с ключом, созданный в настройках и ограниченный нужными правами. Для приложения, которое устанавливается на чужие порталы, используется OAuth 2.0.

Границы

В CRM лежат персональные данные покупателей и история переговоров с ними. Поэтому подключать портал имеет смысл с правами только на нужные разделы, а менять сделки и карточки — после подтверждения человеком. Удаление записей агенту не нужно ни в одном из сценариев выше.

Статус подключения

Не подключён, работа не начиналась. Для подключения к одному порталу достаточно входящего вебхука с ограниченными правами; OAuth понадобится, если источник будут подключать сразу несколько компаний.

Установка

# Битрикс24 ещё не подключён (в очереди).
# Ниже — как это будет выглядеть.

# ~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "e-suppy": {
      "url": "https://mcp.e-suppy.com/mcp"
    }
  }
}

# Битрикс24 ещё не подключён (в очереди).
# Ниже — как это будет выглядеть.

curl -X POST https://mcp.e-suppy.com/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
        "params":{"name":"search_products",
                  "arguments":{"query":"сметана 15%"}}}'

# Битрикс24 ещё не подключён (в очереди).
# Ниже — как это будет выглядеть.

from mcp.client.streamable_http import streamablehttp_client

async with streamablehttp_client("https://mcp.e-suppy.com/mcp") as (r, w, _):
    async with ClientSession(r, w) as s:
        await s.initialize()
        await s.call_tool("search_products", {"query": "bitrix24"})

Типовые операции в API категории

Так эти операции обычно называются у вендоров категории. Агенту они не видны: в e-suppy источник вызывается через общие инструменты роутера, и их набор при подключении не меняется.

create_dealСделка с товарными позициямиwrite

find_contactПоиск клиента по телефону или emailread

add_noteПримечание в карточкуwrite

Пример ответа

{
  "deal_id": 60411,
  "stage": "payment_pending",
  "amount": 4190,
  "_meta": { "created_by": "agent" }
}