Все статьи

3 сентября 2026 г.

MCP-сервер для 1С: Графон — точный срез кода для AI-агентов (Claude Code, Cursor)

Революция в разработке 1С: от слепых переписей к точечным срезам

Разработчику, работающему с современными ИИ-ассистентами, известна извечная боль: попытка загрузить в контекст окно LLM базовую конфигурацию (ERP, УТ, КА) приводит к мгновенному переполнению буфера. Типовой обмен данными с базами 1С содержит гигабайты XML-метаданных. Если просто скормить агенту папку Configuration, вы получите не решение, а дорогого галлюцинирующего гостя, который путает методы менеджеров объектов и «выдумывает» несуществующие синтаксические конструкции BSL.

Графон — это локальный MCP (Model Context Protocol) сервер, который решает проблему масштаба данных. Он не загружает весь код, а строит индексируемый граф зависимостей. Когда агент запрашивает контекст, Графон возвращает только те файлы, сигнатуры и подписки на события, которые реально связаны с текущей задачей. Это снижает потребление токенов до 10 раз и гарантирует факт-чек: агент видит только то, что существует.

Архитектура взаимодействия: Агент — MCP — Графон — 1С

Протокол MCP позволяет стандартизировать обмен данными между LLM и внешними инструментами. В связке с Графоном архитектура выглядит следующим образом:

  1. Инициация запроса: Пользователь просит Claude Code или Cursor найти логику обработки документа «Реализация товаров».
  2. Маршрутизация через MCP: Агент отправляет структурированный запрос к локальному MCP-серверу Графона (TCP/stdio).
  3. Анализ графа: Графон мгновенно ищет в локальном индексе узлы: форму документа, модуль менеджера, связанные менеджер и используемые общие модули.
  4. Возврат среза: Сервер отправляет назад только текст необходимых функций и сигнатуры методов, которые они вызывают.
  5. Генерация ответа: LLM формирует код или архитектурное решение на основе точных данных.

#### Сравнительный анализ: Работа с «сырыми» файлами vs Графон

| Характеристика | БезГрафона (RAG по всей базе) | С Графон (MCP Graph) |
| :--- | :--- | :--- |
| Потребление токенов | ~500k–2M токенов на контекст | ~50k–200k токенов |
| Точность (Hallucination rate) | Высокий риск выдуманных методов | Минимальный риск (факт-чек по графу) |
| Скорость реакции | Медленный поллинг по файлам | Мгновенный доступ по индексу |
| Актуальность данных | Зависит от частоты обновления векторов | Срабатывает на лету при изменении кода |

Настройка и подключение к Claude Code

Для подключения Графона в Claude Code необходимо зарегистрировать сервер в конфигурационном файле MCP. Графон работает локально, обеспечивая безопасность корпоративных данных — код вашей конфигурации не покидает контур разработки.

  1. Подготовка индекса:
  2. Запустите графопостроитель на вашей конфигурации 1С. Графон будет разбирать метаданные и формировать DAG (ориентированный ациклический граф) связей.
  1. Конфигурация MCP:
  2. Откройте файл ~/.claude/claude_desktop_config.json (или профиль конкретной установки) и добавьте запись:
{
  "mcpServers": {
    "grafon_1c": {
      "command": "grafon-mcp-server",
      "args": ["--start", "--port", "8081"],
      "env": {
        "GRAFON_DB_PATH": "/opt/grafon/indexes"
      }
    }
  }
}
  1. Проверка работы:
  2. В окне Claude Code введите команду: «Покажи мне все методы менеджера объекта Объект[СчетаФактуры], которые используют механизм агрегаций». Агент запросит у Графона точечный срез кода и вернет ответ с прямыми ссылками на строки.

Практические сценарии для разработчиков

Сценарий 1: Поиск пересечения логики
Задача: Найти все места, где вызывается общая функция CalculateAggregation из общего модуля Utils.
Решение: Агент выполняет запрос к Графону. Вместо сканирования 5000 файлов, он получает список из 12 методов и 3 моделей данных.

Сценарий 2: Создание нового интерфейса
Задача: Добавить кнопку с обработчиком на форме документа.
Решение: Агент запрашивает сигнатуры текущих обработчиков форм. Графон предоставляет структуру ОткрытьИнформационноеСообщение(...) и другие параметры. Агент пишет новый код на BSL в соответствии с существующими стандартами проекта.

Разбор рабочего кода через Графон:

// Фрагмент, который может запросить AI через MCP
// Агент видит не весь файл, а только сигнатуры


Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка) Экспорт
	#Если Сервер Тогда
		// Графон показывает, что здесь вызывается UDT
		УправляемаяСоставнаяМодель.Заполнить();
	КонецЕсли;
КонецПроцедуры



Функция ПолучитьАгрегат(Количество) Экспорт
	// Агент видит, что этот метод используется в 5 інших местах
	Возврат КалькуляторЦен.Цена * Количество;
КонецФункции

Безопасность и производительность

Критическим преимуществом решения на базе Графона является локальность. В отличие от облачных RAG-сервисов, где XML-данные конфигурации могли бы быть отправлены на удаленные серверы, Графон индексирует данные на жестком диске разработчика или локальном контейнере. Это соответствует требованиям информационной безопасности банков, ритейла и госсектора.

Кроме того, использование протокола MCP унифицирует процесс интеграции. Если завтра вы перейдете с Claude Code на Windsurf или Roo Code, архитектура обмена с 1С не изменится. Вашему агенту достаточно знать команды Графона. Это снижает стоимость поддержки AI-инфраструктуры и позволяет централизованно управлять доступом к «экспертному мнению», извлеченному из конфигурации.

Заключение

Внедрение MCP-сервера Графона — это переход от работы с 1С как с «чёрным ящиком» к работе с ней как с машиночитаемой программной средой. Для архитектора это возможность быстро оценить влияние изменений (circular dependencies), а для рядового разработчика — способ получить контекстную помощь ИИ без риска потери актуальности кода. Настройка занимает менее 10 минут, а экономия бюджета на токены и времени на отладку окупает затраты с первой же сессии.

Попробовать Графон бесплатно