Перейти к основному содержимому

Встроенные MCP-серверы

Платформа разрабатывает и поддерживает несколько MCP-серверов, готовых к подключению. Каждый сервер мультитенантный: один экземпляр обслуживает несколько проектов, учётные данные передаются при каждом вызове.

YCLIENTS MCP​

MCP-сервер для интеграции с YCLIENTS — CRM-платформой для салонов и сервисных бизнесов.

  • Покрытие: полный доступ к YCLIENTS REST API — 305 операций, сгруппированных в 32 инструмента
  • Категории операций: компании, услуги, мастера, расписание, клиенты, записи, складской учёт, финансовые операции, отчёты
  • Авторизация: партнёрский токен (YCLIENTS_PARTNER_TOKEN) и пользовательский токен (YCLIENTS_USER_TOKEN) передаются через переменные окружения сервера в проекте
  • Транспорт: HTTPS

Подключение​

  1. Получите партнёрский токен в Маркетплейсе YCLIENTS
  2. Добавьте MCP-сервер в проект: страница MCP серверы → MCP сервер
  3. URL сервера: предоставляется командой платформы
  4. В Переменных окружения укажите токены: 
    {
      "YCLIENTS_PARTNER_TOKEN": "ваш_партнёрский_токен",
      "YCLIENTS_USER_TOKEN": "ваш_пользовательский_токен"
    }
  5. Нажмите Проверить соединение и сохраните

После подключения 32 инструмента YCLIENTS становятся доступны агентам — например, для создания записи, поиска свободных слотов мастера или получения списка услуг.

Kontur.Diadoc MCP​

MCP-сервер для интеграции с Контур.Диадок — системой электронного документооборота (ЭДО).

  • Покрытие: 22 инструмента поверх Diadoc REST API — документы (получение, отправка, подпись, удаление), типы документов, контрагенты, группы контрагентов, организации
  • Авторизация: четыре параметра — DIADOC_CLIENT_ID, DIADOC_API_KEY, DIADOC_LOGIN, DIADOC_PASSWORD. Передаются через переменные окружения сервера в проекте
  • Транспорт: HTTPS

Подключение​

  1. Получите доступ к Diadoc API на стороне Контура (client_id и api_key)
  2. Добавьте MCP-сервер в проект: страница MCP серверы → MCP сервер
  3. URL сервера: предоставляется командой платформы
  4. В Переменных окружения укажите учётные данные: 
    {
      "DIADOC_CLIENT_ID": "...",
      "DIADOC_API_KEY": "...",
      "DIADOC_LOGIN": "...",
      "DIADOC_PASSWORD": "..."
    }
  5. Нажмите Проверить соединение и сохраните

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

ClickHouse MCP​

MCP-сервер для подключения к ClickHouse — колоночной аналитической СУБД. Платформа не хостит ClickHouse — каждая организация подключается к своему инстансу.

  • Покрытие: 8 инструментов — обзор схемы (list_databases, list_tables, describe_table, show_create_table, count_rows), выборка данных (sample_rows, column_distinct_values) и произвольные SQL-запросы (run_query с серверным лимитом времени и количества строк)
  • Авторизация: параметры подключения к ClickHouse передаются через переменные окружения — CLICKHOUSE_HOST, CLICKHOUSE_USERNAME, CLICKHOUSE_PASSWORD, CLICKHOUSE_DATABASE (опционально CLICKHOUSE_PORT, CLICKHOUSE_SECURE)
  • Соединения: кэшируются на 10 минут на одну комбинацию кредов (ротация ключа автоматически инвалидирует кэш)
  • Транспорт: HTTPS

Подключение​

  1. Создайте read-only пользователя ClickHouse — GRANT SELECT ON db.* TO mcp_user. Запись на стороне MCP не парсится — единственная защита от LLM-induced DDL/DML это ограничение грантов на стороне БД
  2. Добавьте MCP-сервер в проект: страница MCP серверы → MCP сервер
  3. URL сервера: предоставляется командой платформы
  4. В Переменных окружения укажите параметры подключения: 
    {
      "CLICKHOUSE_HOST": "ch.example.com",
      "CLICKHOUSE_USERNAME": "mcp_user",
      "CLICKHOUSE_PASSWORD": "...",
      "CLICKHOUSE_DATABASE": "analytics",
      "CLICKHOUSE_PORT": "8123",
      "CLICKHOUSE_SECURE": "false"
    }
  5. Нажмите Проверить соединение и сохраните

После подключения агент может исследовать структуру данных (list_databases → list_tables → describe_table), просматривать примеры значений (sample_rows), и запускать аналитические запросы (run_query с ограничением до 10 000 строк и 120 секунд на запрос).

Защита от записи

run_query пропускает SQL как есть — без парсинга. Если ClickHouse-пользователю выданы права INSERT/ALTER/DROP, агент сможет ими воспользоваться. Используйте read-only пользователя для подключения через MCP.

Google Sheets MCP​

MCP-сервер для чтения и записи Google Sheets через сервисный аккаунт Google.

  • Покрытие: 5 инструментов — list_spreadsheets (через Drive API), get_spreadsheet_metadata, read_range, append_rows, update_range
  • Авторизация: содержимое JSON-файла ключа сервисного аккаунта передаётся целиком одной переменной окружения GOOGLE_SHEETS_SERVICE_ACCOUNT_JSON
  • Scope: spreadsheets (чтение + запись) + drive.metadata.readonly (для листинга файлов)
  • Транспорт: HTTPS

Подключение​

  1. В Google Cloud Console создайте проект и включите Google Sheets API + Google Drive API
  2. IAM & Admin → Service Accounts → Create. Ролей выдавать не нужно
  3. Откройте созданный сервисный аккаунт → Keys → Add Key → JSON → скачайте файл
  4. В каждой целевой таблице нажмите Share и поделитесь с client_email из JSON-файла (Viewer для чтения, Editor для записи). Сервисный аккаунт не видит таблицы автоматически — только те, которыми с ним поделились явно
  5. Добавьте MCP-сервер в проект: страница MCP серверы → MCP сервер
  6. URL сервера: предоставляется командой платформы
  7. В Переменных окружения вставьте всё содержимое JSON-файла как одну строку: 
    {
      "GOOGLE_SHEETS_SERVICE_ACCOUNT_JSON": "{\"type\":\"service_account\",\"project_id\":\"...\",\"private_key\":\"...\",\"client_email\":\"mcp-bot@...iam.gserviceaccount.com\",...}"
    }
  8. Нажмите Проверить соединение и сохраните

После подключения агент может найти доступные таблицы (list_spreadsheets), изучить структуру листов и их размеры (get_spreadsheet_metadata), читать диапазоны в нотации A1 (read_range), дописывать строки в конец данных (append_rows) и переписывать конкретные диапазоны (update_range).

Изоляция доступа

Поскольку сервисный аккаунт видит только таблицы, расшаренные с его email, легко ограничить доступ агента: достаточно поделиться с ним конкретными файлами, а не всем Drive.

Lia Platform API MCP​

MCP-сервер для конфигурирования ботов в Lia — внутренний инструмент для агентов, которые помогают собирать сценарии, тренировать намерения и тестировать диалоги.

  • Покрытие: 75 инструментов — проекты, сценарии (scripts), намерения (intents), сущности (entities), вопросы-ответы (Q&A), сниппеты, каналы, диалоги, тестирование
  • Авторизация: DRF-токен передаётся через переменную окружения PLATFORM_API_TOKEN
  • Транспорт: HTTPS

Подключение​

  1. Получите DRF-токен от аккаунт менеджера Лии
  2. Добавьте MCP-сервер в проект: страница MCP серверы → MCP сервер
  3. URL сервера: предоставляется командой платформы
  4. В Переменных окружения укажите токен: 
    {
      "PLATFORM_API_TOKEN": "ваш_токен"
    }
  5. Нажмите Проверить соединение и сохраните

После подключения агент может работать с конфигурацией проектов: листать намерения и сущности, создавать новые тренировочные фразы, обновлять Q&A, авторить и редактировать снипеты, прогонять тестовые диалоги.

Запросить URL

URL встроенных MCP-серверов выдаётся командой платформы — обратитесь к менеджеру или в службу поддержки.

Свой MCP-сервер​

Помимо встроенных, к платформе можно подключить любой сторонний или собственный MCP-сервер по HTTP. Подробнее в разделе Настройка MCP-сервера.