Свой код: инструменты сайта на Битриксе из Python, бота или крона

Подключение по шагам

1. Создайте ключ под задачу

   В кабинете на странице «Подключить ассистента» выберите «свой код». Отчёт по остаткам: «только чтение», один сайт, срок год. Обновление остатков из таблицы: «чтение и изменения», один сайт, срок 90 дней. Назовите ключ по задаче, чтобы в журнале было понятно, кто что делал.

2. Установите SDK

   pip install mcp. Пакет даёт клиент Streamable HTTP и сессию с методами списка и вызова инструментов.

3. Получите список инструментов

   Скрипт ниже подключается к https://mcp.bxmcp.ru/mcp с заголовком авторизации, инициализирует сессию и печатает имена инструментов с описаниями. Имена стабильны, например bitrix_list_sites, bitrix_list_elements, bitrix_get_stock, bitrix_set_stock.

4. Вызовите инструмент

   await session.call_tool("bitrix_list_sites", {}) возвращает текст и структурированные данные. Аргументы описаны в схеме каждого инструмента из списка; поле site можно не передавать, если у ключа один сайт.

5. Обрабатывайте отказы

   Ключ «только чтение» получит отказ на изменение с понятным текстом, истёкший ключ 401, превышение бесплатного лимита чтения сообщение с адресом тарифов. Логируйте эти ответы и не повторяйте вызов в цикле.

import asyncio
from mcp import ClientSession
from mcp.client.streamable_http import streamablehttp_client

URL = "https://mcp.bxmcp.ru/mcp"
HEADERS = {"Authorization": "Bearer ВАШ_КЛЮЧ"}

async def main():
    async with streamablehttp_client(URL, headers=HEADERS) as (read, write, _):
        async with ClientSession(read, write) as session:
            await session.initialize()
            tools = await session.list_tools()
            for t in tools.tools:
                print(t.name, "-", (t.description or "")[:60])
            sites = await session.call_tool("bitrix_list_sites", {})
            print(sites.content[0].text)

asyncio.run(main())

Что это даёт по сравнению с REST или прямым SQL

Инструменты уже описаны и проверяют права: код не может случайно обновить не тот сайт или удалить лишнее, потому что у ключа есть границы, а у шлюза журнал и откат на 30 дней. Не нужно писать и поддерживать собственный API на сайте клиента, открывать базу или держать отдельный REST-модуль. Набор инструментов общий с ChatGPT и Claude, поэтому то, что менеджер делает в чате, скрипт делает теми же вызовами.

Ограничения тоже общие: только отмеченные в модуле разделы, до 500 элементов за одно изменение, 200 карточек за одну замену текста, никакого доступа к коду и файлам сайта. Для массовых загрузок по тысячам товаров это медленнее прямого импорта, зато безопасно и с откатом.

Первые фразы

• bitrix_list_sitesКопировать

  Первый вызов: сайт и режим ключа.

• bitrix_list_elements с фильтром по разделу и страницей 100Копировать

  Проход по каталогу страницами; поля карточки в ответе.

• bitrix_get_stock по разделуКопировать

  Остатки для сводки или сверки с таблицей.

• bitrix_set_stock по одному товаруКопировать

  Нужен ключ с изменениями. Запись в журнал, откат из кабинета 30 дней.