# ALM X++ MCP Server

MCP-сервер ALM X++ MCP Server для Claude Code даёт доступ к кодовой базе Dynamics 365 F&O через 90 инструментов. Находит объекты AOT, перекрёстные ссылки и переводы меток.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5 у репозитория
- Автор: alimbenhelal-pro
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/alimbenhelal-pro/ALM-XPP-MCP
- Обновлён: 2026-09-04
- Проверка безопасности: автоматическая, 2026-11-17 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/mcp/alm-x-mcp-server

## Что делает

Сервер запрашивает данные из готового индекса стандартного кода D365 F&O. Туда включены более 200K объектов AOT, свыше 25M перекрёстных ссылок и 24M переводов меток на 74 языка. Каждый ответ содержит имя объекта AOT и модель, поэтому результат легко найти в Visual Studio.

Для работы нужен API-токен с сайта `almxpp.com`, который передаётся в заголовке `X-API-Key`. Если требуется искать в собственном коде, сервер подключает метаданные через заголовок `D365-Custom-Model-Path` либо выкачивает репозиторий из Azure DevOps по переданным переменным проекта и PAT. Метаданные индексируются на время сессии и не используются для обучения моделей.

Облачный вариант сервера не компилирует X++ и не видит локальные бинарники на вашей машине. Для прямого обращения к данным среды или логам телеметрии передаются реквизиты Entra ID для D365FO и Application Insights.

## Требования
- Нужно: Node.js (команды через npx)
- Удалённый сервер: `https://api.almxpp.com/mcp`
- Переменные окружения: `ALMXPPMCP_API_KEY` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

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

1. **Командой платформы: удалённый сервер**
```bash
claude mcp add --transport http alm-xpp-mcp https://api.almxpp.com/mcp
```

2. **Командой платформы**
```bash
claude mcp add --env ALMXPPMCP_API_KEY=<ALMXPPMCP_API_KEY> --transport stdio alm-x-mcp-server -- npx -y almxppmcp
```
Вместо <…> подставьте свои значения

### Codex

1. **Командой платформы: удалённый сервер**
```bash
codex mcp add alm-x-mcp-server --url https://api.almxpp.com/mcp
```

2. **Командой платформы**
```bash
codex mcp add alm-x-mcp-server --env ALMXPPMCP_API_KEY=<ALMXPPMCP_API_KEY> -- npx -y almxppmcp
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "alm-x-mcp-server": {
            "url": "https://api.almxpp.com/mcp"
        }
    }
}
```
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "alm-x-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "almxppmcp"
            ],
            "env": {
                "ALMXPPMCP_API_KEY": "<ALMXPPMCP_API_KEY>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "alm-x-mcp-server": {
            "type": "http",
            "url": "https://api.almxpp.com/mcp"
        }
    }
}
```
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "alm-x-mcp-server": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "almxppmcp"
            ],
            "env": {
                "ALMXPPMCP_API_KEY": "<ALMXPPMCP_API_KEY>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

1. **Командой платформы: удалённый сервер**
```bash
gemini mcp add -t http alm-x-mcp-server https://api.almxpp.com/mcp
```

2. **Командой платформы**
```bash
gemini mcp add -e ALMXPPMCP_API_KEY=<ALMXPPMCP_API_KEY> alm-x-mcp-server npx -y almxppmcp
```
Вместо <…> подставьте свои значения

## Когда брать
- найти ссылки на объекты AOT в кодовой базе Dynamics 365
- проверить переводы меток на 74 языках
- подключить анализ собственных расширений через Azure DevOps
- выполнять вызовы к OData и DMF в рабочей среде D365FO

## Примеры запросов агенту
- Найди все ссылки на таблицу CustTable в стандартных моделях D365
- Покажи перевод метки @SYS12345 на немецкий и французский языки
- Проверь методы класса SalesTableType через инструменты ALM X++

## Похожие
- [D365FO MCP Server](https://affpapa.org/nevibecode/mcp/d365fo-mcp-server.md) — MCP-сервер · ★ 42 у репозитория
- [d365fo-connector](https://affpapa.org/nevibecode/mcp/d365fo-connector.md) — MCP-сервер · ★ 10 у репозитория
- [business-central-development](https://affpapa.org/nevibecode/skills/business-central-development.md) — скилл · 802 установки
- [d365-solution-blueprint](https://affpapa.org/nevibecode/skills/d365-solution-blueprint.md) — скилл · 13 установок
- [Dynamics 365 Business Central Admin](https://affpapa.org/nevibecode/mcp/dynamics-365-business-central-admin.md) — MCP-сервер · ★ 13 у репозитория
- [dataverse](https://affpapa.org/nevibecode/plugins/dataverse.md) — плагин · ★ 262 у репозитория

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