Coverse + GigaChat за 15 минут
Готовый пример агента, который подключает GigaChat (нейросеть Сбера) к вашим таблицам и документам Coverse. Агент понимает запросы обычным языком и сам вызывает нужные инструменты Coverse: показывает список таблиц, читает и записывает данные, собирает отчёты.
В отличие от Claude или ChatGPT, у GigaChat нет готовой кнопки «подключить MCP-сервер» — подключение делается небольшим агентом на Python. Этот репозиторий и есть такой агент: скачайте, впишите два ключа, запустите.
Как это устроено
- GigaChat выступает «мозгом»: рассуждает и решает, какой инструмент вызвать.
- Coverse MCP — сервер Coverse, который даёт агенту инструменты для работы с таблицами и документами.
- Связь между ними обеспечивает библиотека
langchain-mcp-adapters: она превращает инструменты Coverse в функции, понятные GigaChat.
Агент подключается к серверу Coverse по HTTP и авторизуется вашим личным токеном доступа — без входа по кнопке и без OAuth. Токен передаётся серверу Coverse при каждом запросе.
Что понадобится
- Python 3.10 или новее.
- Ключ доступа к GigaChat API. Получается в личном кабинете разработчика Сбера: developers.sber.ru/studio. Нужна авторизационная строка (
GIGACHAT_CREDENTIALS). - Токен доступа Coverse. Создаётся в Coverse: Настройки → Автоматизация и API → создать токен. Токен уже содержит права на чтение и запись; если инструменту не хватает права, он вернёт ошибку доступа.
Шаг 1. Установка
git clone https://gitflic.ru/project/rivercitydev/coverse-gigachat-example.git
cd coverse-gigachat-example
python -m venv .venv
source .venv/bin/activate # Windows: .venv\Scripts\activate
pip install -r requirements.txt
Шаг 2. Настройка ключей
Скопируйте файл с примером настроек и заполните его:
cp .env.example .env
В файле .env заполните два значения:
| Переменная | Что вписать |
|---|---|
COVERSE_API_TOKEN |
Токен доступа Coverse (Настройки → Автоматизация и API). |
GIGACHAT_CREDENTIALS |
Авторизационная строка GigaChat API. |
Остальные переменные можно не трогать:
| Переменная | Значение по умолчанию | Назначение |
|---|---|---|
COVERSE_MCP_URL |
https://mcp.app.coverse.team/mcp |
Адрес MCP-сервера Coverse. |
GIGACHAT_SCOPE |
GIGACHAT_API_PERS |
Тип доступа GigaChat: GIGACHAT_API_PERS — для физлиц, GIGACHAT_API_B2B или GIGACHAT_API_CORP — для компаний. |
GIGACHAT_MODEL |
GigaChat |
Модель GigaChat (например GigaChat, GigaChat-Pro, GigaChat-Max). |
Шаг 3. Запуск
python agent.py
Появится приглашение ввести запрос. Например:
Вы: Покажи список моих таблиц
Агент: У вас 3 таблицы: «Продажи 2026», «Клиенты», «Бюджет».
Вы: В таблице «Продажи 2026» добавь строку: Иванов, 15000, оплачено
Агент: Добавляю строку в таблицу «Продажи 2026»... Готово, строка добавлена.
Для выхода введите «выход».
Подготовка к продакшену
Этот пример рассчитан на быстрый старт. Для боевого использования учтите:
- Сертификаты GigaChat. В примере проверка TLS-сертификата отключена (
verify_ssl_certs=False), чтобы запуск прошёл без настройки. Для продакшена установите корневой сертификат Минцифры и включите проверку — см. документацию GigaChat. - Безопасность токена.
COVERSE_API_TOKENдаёт доступ к вашим данным Coverse. Храните его в защищённом хранилище секретов, не коммитьте.envв репозиторий (он уже в.gitignore). - Права токена. Выдавайте токену только те права, которые нужны агенту. Если агент должен только читать данные — не давайте право на запись.