# d365fo-connector

Подключает AI-ассистента к Microsoft Dynamics 365 F&O через OData. Помогает изучать схемы сущностей и безопасно запрашивать данные.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 10
- Автор: zhound420
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/zhound420/D365FO-claude-connector
- Обновлён: 2026-03-15
- HTML: https://affpapa.org/nevibecode/mcp/d365fo-connector

## Что делает

Сервер связывает модели Claude с окружениями Dynamics 365 Finance & Operations. Внутри заложено 22 инструмента: выполнение OData-запросов, подсчёт агрегатов и поиск дрейфа схем между инстансами. Найденные структуры таблиц кэшируются локально на 24 часа.

Параметры подключения задаются через переменные окружения или файл `d365-environments.json` сразу для нескольких контуров. Любая запись в боевую среду заблокирована архитектурно, поэтому создать или удалить строки выйдет только в dev-песочницах и UAT.

Для авторизации нужно зарегистрировать приложение в Azure AD и получить секрет клиента. Без корректных ключей доступа и URL инстанса сервер отклонит попытку соединения при старте.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `D365_TENANT_ID`, `D365_CLIENT_ID`, `D365_CLIENT_SECRET`, `D365_ENVIRONMENT_URL` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
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

**Командой платформы**
```bash
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
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "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>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "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 CLI

**Командой платформы**
```bash
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
```
Вместо <…> подставьте свои значения

## Когда брать
- смотреть схемы сущностей и связи D365 прямо в диалоге
- выгружать результаты OData-запросов в файлы CSV или JSON
- сравнивать структуры таблиц между UAT и продакшеном
- выполнять пакетные CRUD-операции на dev-песочницах

## Примеры запросов агенту
- Покажи схему сущности CustCustomerV3Entity из контура dev
- Сравни продажи за текущий и прошлый квартал через compare_periods
- Проверь статус подключения ко всем инстансам через dashboard

## Похожие
- [D365FO MCP Server](https://affpapa.org/nevibecode/mcp/d365fo-mcp-server.md) — MCP-сервер · ★ 40
- [netsuite-ai-connector-instructions](https://affpapa.org/nevibecode/skills/netsuite-ai-connector-instructions.md) — скилл · 778 установок
- [business-central-development](https://affpapa.org/nevibecode/skills/business-central-development.md) — скилл · 749 установок
- [d365-solution-blueprint](https://affpapa.org/nevibecode/skills/d365-solution-blueprint.md) — скилл · 13 установок
- [dataverse](https://affpapa.org/nevibecode/plugins/dataverse.md) — плагин · ★ 246
- [ms365-tenant-manager](https://affpapa.org/nevibecode/skills/ms365-tenant-manager.md) — скилл · 783 установки

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md