D365 F&O MCP Server
MCP-сервер знает все классы, таблицы и формы вашего кода D365FO и сверяет сигнатуры X++ до того, как агент пишет код
- 171 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Записывает метаданные и файлы X++ в проект, регистрирует их в .rnrproj и запускает сборку MSBuild, синхронизацию базы и тесты
- Опциональные инструменты читают AxDB и снимают трассу AOS, а restartAos перезапускает локальную среду выполнения
Установка
- Работает в
Ручная установка
npm install -g d365fo-mcp
d365fo-mcp setupДля виртуальной машины D365FO, нужен Node.js 24 или новее. Мастер спросит, где хранить индекс, и соберет мост на C#.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Записывает метаданные и файлы X++ в проект, регистрирует их в .rnrproj и запускает сборку MSBuild, синхронизацию базы и тесты
- Опциональные инструменты читают AxDB и снимают трассу AOS, а restartAos перезапускает локальную среду выполнения
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер заранее индексирует установку Dynamics 365 Finance and Operations, свыше 580 тысяч символов из стандартных, ISV и собственных моделей, и отдает агенту 22 инструмента. Агент ищет классы, таблицы, формы, EDT, перечисления, метки и объекты безопасности, смотрит обертки Chain of Command и цепочку «роль, обязанность, привилегия, точка входа», а перед записью кода проверяет каждый идентификатор по индексу. Запись защищена шлюзами: выданный токен подтверждает, что поиск был, validate_code проверяет ссылки и синтаксис, а метаданные пишет мост на C# через родной IMetadataProvider Microsoft. Форму сервер собирает по каталогу шаблонов форм Microsoft: клонирует эталонную форму, проверяет правила FP001–FP010 и блокирует запись при нарушении структуры. Дополнительно есть сборка MSBuild с разбором диагностик, синхронизация базы, `xppbp`, запуск SysTestRunner, база знаний по X++ и два отключенных по умолчанию инструмента: axdb_sql для чтения AxDB и trace_d365fo для разбора ETW-трассы AOS.
Для кого. X++-разработчикам и техническим консультантам Dynamics 365 F&O, которые пишут расширения с GitHub Copilot или Claude Code на виртуальной машине разработки.
Подходит, если
- Агент придумывает несуществующие методы X++, и код не компилируется
- Для стандартного метода требуется найти готовые Chain of Command обертки в своем и ISV-коде
- Новую форму хочется собрать строго по шаблонам Microsoft, без ручного XML
- Метки @SYS и @MODULE ищутся среди 20 миллионов строк, и руками это долго
- Цепочку безопасности роли надо проследить до точки входа за один вызов
Не подходит, если
- Разработка идет не на Dynamics 365 F&O: сервер знает только X++ и метаданные AOT
- Нет виртуальной машины разработки или каталога PackagesLocalDirectory, индексировать нечего
- Машине не хватает памяти: каждый stdio-процесс загружает индекс размером около 1,5 ГБ
Пример запроса к агенту
Найди все обертки Chain of Command для SalesFormLetter.run и покажи, какие поля таблицы SalesLine затронутыMCP
- Транспорт
- stdio, http
- Авторизация
- API-ключ
Переменные окружения
D365FO_WORKSPACE_PATH- Путь вида PackagesLocalDirectory\Package\Model, из него выводятся пакет и модель.
DB_PATHобязательная- Абсолютный путь к базе SQLite с индексом символов, обязателен в режиме stdio.
LABELS_DB_PATHобязательная- Абсолютный путь к базе меток, обязателен в режиме stdio.
Ограничения
Для установки на свою машину нужны Windows-виртуальная машина D365FO, Node.js 24 или новее и Visual Studio: с обновления платформы 10.0.49 поддерживается Visual Studio 2026, раньше 2022 версии 17.14 и выше. Файл с инструкциями для агента обязателен, без него правила маршрутизации инструментов не работают. Запись метаданных идет только через мост на C# и шлюзы проверки, но агент все равно меняет проект на диске. Инструменты axdb_sql и trace_d365fo не публикуются, пока их не настроят, и работают только на машине разработки.
Как отключить. Уберите запись d365fo-mcp-tools из конфигурации клиента, для Claude Code выполните `claude mcp remove d365fo-mcp-tools`. Пакет удаляется командой `npm uninstall -g d365fo-mcp`.
Частые вопросы
Как подключить D365FO MCP к Claude Code?
Если команда уже развернула общий сервер, выполните `npx d365fo-mcp connect https://адрес-сервера --client claude`. Для своей виртуальной машины поставьте пакет командой `npm install -g d365fo-mcp` и запустите `d365fo-mcp setup`.
Чем сервер отличается от обычного поиска по коду?
Он знает метаданные AOT и проверяет каждый идентификатор в сгенерированном коде по индексу до записи на диск. Ошибочные поля и типы до проекта не доходят.
Нужна ли отдельная установка на каждого разработчика?
Нет. Команда может развернуть один сервер в Azure с индексом в Blob Storage, а разработчики подключаются командой `connect`. Для локальной работы подходит режим stdio на своей виртуальной машине.
С какими агентами работает?
README ориентирован на GitHub Copilot и Claude Code, а для VS Code и Cursor есть кнопки установки, подключающие уже развернутый сервер.
Можно ли читать базу AxDB через сервер?
Да, но инструмент axdb_sql по умолчанию выключен. После настройки он выполняет только один проверенный SELECT внутри транзакции, которая всегда откатывается, и работает на машине разработки с проверкой подлинности Windows.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер, который дает агенту читать файлы, искать по коду и запускать команды в рабочей папке
SAP Fiori MCP Server — приложения Fiori с ИИ
SAP Fiori MCP Server
Официальный MCP-сервер SAP: агент создает и правит приложения SAP Fiori elements по описанию на обычном языке
Граф метаданных и кода конфигурации 1С в Neo4j с MCP-инструментами, веб-консолью и встроенным агентом поиска
АИ Финансист: MCP-сервер для 1С
mcp_1c (AI Финансист)
Связка MCP-сервера, OData-клиента 1С и локальной языковой модели с чатом на Gradio для вопросов по данным 1С и загруженным PDF
MCP-сервер на 69 инструментов для баз .accdb: формы, VBA, таблицы, запросы и элементы управления через COM, только Windows
MCP-сервер для Claude Code: полнотекстовый поиск по XML+BSL выгрузкам нескольких конфигураций 1С в локальной SQLite-базе с FTS5
Коротко о README
README объясняет, зачем модели нужен индекс собственной кодовой базы X++, показывает таблицу «без сервера, с сервером», возможности и конвейер разработки форм. Дальше идут быстрый старт для PowerShell, подключение к общему серверу, развертывание в Azure и ссылки на документацию. Лицензия MIT.