d365fo-connector — MCP-сервер для Claude Code: обзор и запуск
Подключает AI-ассистента к Microsoft Dynamics 365 F&O через OData. Помогает изучать схемы сущностей и безопасно запрашивать данные.
claude mcp add d365fo-connector -e D365_TENANT_ID=<D365_TENANT_ID> -e D365_CLIENT_ID=<D365_CLIENT_ID> -e D365_CLIENT_SECRET=<D365_CLIENT_SECRET> -e D365_ENVIRONMENT_URL=<D365_ENVIRONMENT_URL> -- npx -y @zhound/d365fo-mcp-serverЧто делает d365fo-connector
Сервер связывает модели Claude с окружениями Dynamics 365 Finance & Operations. Внутри заложено 22 инструмента: выполнение OData-запросов, подсчёт агрегатов и поиск дрейфа схем между инстансами. Найденные структуры таблиц кэшируются локально на 24 часа.
Параметры подключения задаются через переменные окружения или файл d365-environments.json сразу для нескольких контуров. Любая запись в боевую среду заблокирована архитектурно, поэтому создать или удалить строки выйдет только в dev-песочницах и UAT.
Для авторизации нужно зарегистрировать приложение в Azure AD и получить секрет клиента. Без корректных ключей доступа и URL инстанса сервер отклонит попытку соединения при старте.
Какие задачи решает
- смотреть схемы сущностей и связи D365 прямо в диалоге
- выгружать результаты OData-запросов в файлы CSV или JSON
- сравнивать структуры таблиц между UAT и продакшеном
- выполнять пакетные CRUD-операции на dev-песочницах
Примеры запросов агенту
- Покажи схему сущности CustCustomerV3Entity из контура dev
- Сравни продажи за текущий и прошлый квартал через compare_periods
- Проверь статус подключения ко всем инстансам через dashboard
Как установить d365fo-connector
Командой платформы
claude mcp add d365fo-connector -e D365_TENANT_ID=<D365_TENANT_ID> -e D365_CLIENT_ID=<D365_CLIENT_ID> -e D365_CLIENT_SECRET=<D365_CLIENT_SECRET> -e D365_ENVIRONMENT_URL=<D365_ENVIRONMENT_URL> -- npx -y @zhound/d365fo-mcp-serverВместо <…> подставьте свои значения
Командой платформы
codex mcp add d365fo-connector --env D365_TENANT_ID=<D365_TENANT_ID> --env D365_CLIENT_ID=<D365_CLIENT_ID> --env D365_CLIENT_SECRET=<D365_CLIENT_SECRET> --env D365_ENVIRONMENT_URL=<D365_ENVIRONMENT_URL> -- npx -y @zhound/d365fo-mcp-serverВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"d365fo-connector": {
"command": "npx",
"args": [
"-y",
"@zhound/d365fo-mcp-server"
],
"env": {
"D365_TENANT_ID": "<D365_TENANT_ID>",
"D365_CLIENT_ID": "<D365_CLIENT_ID>",
"D365_CLIENT_SECRET": "<D365_CLIENT_SECRET>",
"D365_ENVIRONMENT_URL": "<D365_ENVIRONMENT_URL>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"d365fo-connector": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@zhound/d365fo-mcp-server"
],
"env": {
"D365_TENANT_ID": "<D365_TENANT_ID>",
"D365_CLIENT_ID": "<D365_CLIENT_ID>",
"D365_CLIENT_SECRET": "<D365_CLIENT_SECRET>",
"D365_ENVIRONMENT_URL": "<D365_ENVIRONMENT_URL>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e D365_TENANT_ID=<D365_TENANT_ID> -e D365_CLIENT_ID=<D365_CLIENT_ID> -e D365_CLIENT_SECRET=<D365_CLIENT_SECRET> -e D365_ENVIRONMENT_URL=<D365_ENVIRONMENT_URL> d365fo-connector npx -y @zhound/d365fo-mcp-serverВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о d365fo-connector
Как установить d365fo-connector в Claude Code?
Выполните команду в терминале: `claude mcp add d365fo-connector -e D365_TENANT_ID=<D365_TENANT_ID> -e D365_CLIENT_ID=<D365_CLIENT_ID> -e D365_CLIENT_SECRET=<D365_CLIENT_SECRET> -e D365_ENVIRONMENT_URL=<D365_ENVIRONMENT_URL> -- npx -y @zhound/d365fo-mcp-server`. Замените значения в скобках на параметры из Azure AD.
Можно ли случайно перезаписать данные в продакшене?
Нет. Среды с типом production работают строго в режиме чтения. Инструменты создания, правки и пакетного удаления заблокированы для боевых контуров.
Что нужно подготовить перед запуском?
Требуется зарегистрировать приложение в Azure Active Directory. Для подключения понадобятся Tenant ID, Client ID, секрет приложения и URL инстанса Dynamics 365.
