Модель или инструмент: два способа подключения
Когда GigaChat работает моделью агента, весь диалог, код и вызовы инструментов идут в API Сбера. Так GigaChat ставят за OpenCode, Codex или Claude Code, и тогда агент на GigaChat сам вызывает подключенные MCP-серверы и читает скиллы.
Во втором варианте модель агента любая, а GigaChat приходит отдельной функцией через MCP-сервер.
Как подключить GigaChat к OpenCode
У GigaChat API собственный формат запросов, который с OpenAI совместим лишь частично. Разницу закрывает gpt2giga, прокси из GitHub-организации ai-forever, где Сбер публикует свои открытые проекты. Он принимает запросы в форматах OpenAI, Anthropic и Gemini и пересылает их в GigaChat.
Прокси ставят командой pip install gpt2giga или uv tool install gpt2giga, а для сервера есть Docker Compose. Клиенты в стиле OpenAI ходят на http://localhost:8090/v1. Отдельный плагин для OpenCode не нужен. В корне репозитория лежит пример opencode.json, где GigaChat описан провайдером с пакетом @ai-sdk/openai-compatible и адресом прокси.
Авторы gpt2giga ведут журнал проверок. 26 июня 2026 года связку проверили с Codex 0.142.1 и Claude Code 2.1.187, а OpenCode пока стоит в списке совместимых клиентов без датированной проверки.
На Windows удобнее gigachat-bridge, у которого скрипты быстрого старта и установки сертификатов написаны на PowerShell. Он отдает GigaChat в форматах OpenAI и Anthropic и сам обновляет токен.
npx skillfoxx add cli/gigachat-bridge
Ключ GigaChat API и сертификат
Ключ создают в личном кабинете Studio Сбера. В проекте GigaChat API откройте «Настройки API» и нажмите «Получить ключ». Окно один раз покажет ключ авторизации (Authorization Key), а также идентификатор и секрет приложения (Client ID и Client Secret). В кабинете они не сохраняются.
По ключу авторизации запрашивают токен доступа на ngw.devices.sberbank.ru:9443/api/v2/oauth. Физическим лицам нужна область доступа (scope) GIGACHAT_API_PERS. Токен живет 30 минут, и прокси обновляют его без вашего участия. Для обмена данными с API нужен корневой сертификат НУЦ Минцифры, иначе запрос токена падает с ошибкой проверки защищенного соединения (TLS).
С 1 сентября 2026 года новые клиенты оплачивают работу с моделями на платформе Cloud.ru. Докупать пакеты у Сбера могут только действующие клиенты.
MCP-серверы и скиллы для GigaChat
Сам GigaChat умеет работать с MCP-серверами как агент. У Сбера есть пошаговый пример на langchain-gigachat, langchain_mcp_adapters и LangGraph с локальным подключением по stdio, когда сервер запущен на той же машине, и удаленным по SSE, когда он работает по сети. Готовые серверы и скиллы для агентов закрывают другие задачи.
- Проверка текста на признаки генерации методом детекции Сбера. MCP Giga Checker опубликован в организации ai-forever и работает только на тарифах для юрлиц со scope
GIGACHAT_API_CORP. - Генерация изображений из агента. Сервер в Docker-образе получает ключ через переменную
GIGACHAT_CREDENTIALS. Параметры генерации в README не описаны. - Один адрес для двух российских моделей. MCP Gateway при ошибке GigaChat уходит на YandexGPT, а телефоны, ИНН и СНИЛС прячет еще до отправки.
- Обращение к модели прямо из агента. MCP-сервер для API GigaChat автор проверял на OpenCode под Windows.
- Код интеграций. Восемь скиллов GigaChat помогают выбрать между SDK, langchain-gigachat и gpt2giga, настроить scope и сертификаты, подключить RAG.
- Переезд с OpenAI. Скилл миграции для Cursor определяет стек проекта, ставит нужный адаптер и прогоняет тесты до и после.
Что уходит в GigaChat и чем рискуете
Если GigaChat стоит моделью агента, в облако Сбера уходит весь контекст сессии вместе с кодом. У gigachat-bridge проверка TLS по умолчанию выключена, ее включают переменной GIGACHAT_VERIFY_SSL после установки сертификата. У gpt2giga для рабочей среды авторы требуют GIGACHAT_VERIFY_SSL_CERTS=True и отдельный ключ доступа к самому прокси.
Скиллы GigaChat получили минимальный уровень доступа, потому что это инструкции и справочники. У прокси и большинства MCP-серверов уровень расширенный, потому что они тратят платные токены по вашему ключу. Широкий доступ у ИИконы: расширение ставится в рабочую базу 1С и отправляет ее данные выбранной модели, в том числе GigaChat.