📚 BusinessPlatform Docs

MCP-сервер

📘 Раздел для разработчиков. MCP позволяет AI-ассистентам (Claude, ChatGPT и др.) управлять вашим бизнесом через текстовые команды. Если хотите попробовать — включите AI-помощник прямо в кабинете, всё уже настроено.

BusinessPlatform выставляет Model Context Protocol endpoint — JSON-RPC 2.0 поверх HTTP Streamable. Подключайте Claude Code, Claude Desktop или любой MCP-клиент и управляйте бизнесом через диалог с AI: создавать записи, искать клиентов, смотреть расписание.

📹 ВидеоЗа 40 сек: `claude mcp add` с Bearer-токеном, `claude mcp list` показывает `businessplatform ✓ Connected`, затем просим AI «покажи записи на завтра» — он вызывает `list_appointments` и отвечает списком.
MCP-клиентClaude Code / Desktop / Cursor
JSON-RPC → /mcpinitialize, tools/call
АвторизацияBearer MCP-токен
Вызов toollist_appointments, create_appointment…
Ответcontent[].text с JSON, isError

Endpoint

POST https://irisaicrm.shop/mcp
Authorization: Bearer <ваш MCP-токен>
Content-Type: application/json

Как подключить Claude Code

claude mcp add businessplatform \
  --transport http \
  https://irisaicrm.shop/mcp \
  --header "Authorization: Bearer <ваш MCP-токен>"

После добавления в новой сессии Claude Code появятся tools с префиксом businessplatform:*.

Получение токена

Войдите в Control Panel и откройте Настройки → MCP-токены — там можно создать сколько угодно токенов (по одному на каждое устройство/клиент), увидеть когда они использовались последний раз, и отозвать ненужные. Полный текст токена показывается один раз при создании — сохраните его сразу.

Подробности и безопасность — см. справку по MCP-токенам.

📷 СкриншотРаздел «Настройки → MCP-токены» в кабинете: список токенов с колонками «Название», «Префикс», «Последнее использование», «Статус», кнопка «Создать токен» и «Отозвать» рядом с каждым.
Управление MCP-токенами в кабинете: создание и отзыв

Для bootstrap / dev остаётся fallback на appsettings.json → Mcp:Tokens, но в продакшене используйте UI — каждый токен привязан к конкретному пользователю и ротация в один клик.

Доступные tools

Чтение

Запись

Платежи

Protocol-версия

Сервер поддерживает MCP 2025-06-18 (и эхо-отвечает предыдущие версии). Session-id не требуется, каждый запрос stateless.

Формат ответа tool

{
  "jsonrpc": "2.0",
  "id": 3,
  "result": {
    "content": [
      { "type": "text", "text": "<JSON-serialized результат>" }
    ],
    "isError": false
  }
}

В случае ошибки tool-вызова (нет доступа, невалидные данные) isError: true, и text содержит человекочитаемое описание.

Пример curl: handshake + вызов

# 1. initialize
curl -X POST https://irisaicrm.shop/mcp \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"0"}}}'

# 2. tools/list
curl -X POST https://irisaicrm.shop/mcp \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

# 3. tools/call
curl -X POST https://irisaicrm.shop/mcp \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"list_businesses","arguments":{}}}'

Безопасность