MCP Dataverse

Самый полный MCP-сервер для Microsoft Dataverse.

79 инструментов · 4 ресурса · 10 руководств по рабочим процессам · Три режима аутентификации

npm npm downloads Node 20+ TypeScript License: MIT

Зачем нужен MCP Dataverse?

ИИ-агенты часто галлюцинируют со схемой, угадывают имена столбцов и создают нерабочие OData-запросы. Этот сервер предоставляет им доступ в реальном времени к вашей среде Dataverse — схеме, записям, метаданным, решениям — через Model Context Protocol.

Три режима аутентификации — код устройства (локально), учетные данные клиента (CI/CD), управляемое удостоверение (хостинг в Azure)
Работает с любым MCP-клиентом — VS Code, Claude, Cursor, Windsurf, Gemini, Codex CLI
Атомарные инструменты — каждый инструмент хорошо выполняет одну задачу; ИИ выбирает подходящий
Структурированные ответы — каждый ответ возвращает {summary, data, suggestions}
Защитные барьеры — деструктивные операции требуют явного подтверждения
Зашифрованные токены — учетные данные кэшируются с использованием AES-256-GCM и никогда не записываются в логи

Установка

npx mcp-dataverse install

Интерактивный мастер настроит вашу среду, зарегистрирует сервер в VS Code и выполнит аутентификацию вашей учетной записи Microsoft менее чем за 2 минуты.

Требуется Node.js 20+. Для других клиентов (Claude, Cursor, Windsurf…) см. Настройка для нескольких клиентов.

Аутентификация

Три режима — выбирайте в зависимости от того, где запущен сервер:

Режим	Когда использовать
Код устройства (по умолчанию)	Локальная разработка — интерактивный вход в Microsoft, токен кэшируется на диске
Учетные данные клиента	Без участия пользователя: CI/CD, Docker, службы Azure — `authMethod: "client-credentials"` + Регистрация приложения
Управляемое удостоверение	Хостинг в Azure (App Service, Container Apps) — без секретов, `authMethod: "managed-identity"`

Быстрый старт с кодом устройства: аутентификация запускается при первом вызове инструмента.

Откройте View → Output → MCP — появится код для входа
Перейдите на https://microsoft.com/devicelogin, введите код и войдите под своей рабочей учетной записью
Токен кэшируется в зашифрованном виде — все последующие запуски происходят автоматически

Информацию о настройке учетных данных клиента и управляемого удостоверения см. в документации по аутентификации.

Возможности

Категория	Кол-во	Описание
Метаданные	9	Таблицы, схема, связи, наборы параметров, ключи сущностей
Запросы	3	OData, FetchXML, постраничное получение
CRUD	6	Получение, создание, обновление, удаление, upsert, назначение
Связи	4	Связывание, массовое связывание, разрыв связей, запрос связей
Действия и функции	6	Связанные/несвязанные действия и функции Dataverse
Пакетная обработка	1	До 1000 операций атомарно
Решения	2	Публикация настроек, создание карты сайта
Поиск	1	Полнотекстовый поиск (Relevance Search)
Пользователи и команды	4	Пользователи, роли, команды, назначение ролей
RBAC	7	Права ролей: список, назначение, удаление, добавление, замена, получение, команда
Файлы	2	Загрузка/скачивание файлов и столбцов изображений
Аудит и трассировка	3	Журнал аудита, журналы трассировки плагинов, журналы трассировки рабочих процессов
Аннотации	2	Заметки и вложения файлов
Настройка	4	Пользовательские действия, плагины, переменные среды, ссылки на подключения
Атрибуты	4	Создание, обновление, удаление столбцов; тип столбца подстановки
Схема (запись)	2	Создание пользовательских таблиц и связей
Доступ к записям	4	Проверка, предоставление, отзыв общего доступа к записям; объединение записей
Помощь	2	Маршрутизатор инструментов, теги инструментов
+ еще	…	Дельта-синхронизация, олицетворение, представления, бизнес-единицы, обнаружение дубликатов

→ Полный справочник возможностей

HTTP-транспорт

Запуск в качестве HTTP-сервера для использования несколькими клиентами:

MCP_TRANSPORT=http MCP_HTTP_PORT=3000 MCP_HTTP_SECRET=mysecret node dist/server.js

Подключитесь с помощью VS Code / Copilot, используя:

{
  "servers": {
    "dataverse": {
      "type": "http",
      "url": "http://localhost:3000/mcp",
      "headers": {
        "Authorization": "Bearer mysecret"
      }
    }
  }
}

Устранение неполадок

Симптом	Решение
Нет запроса на вход	Откройте View → Output → MCP — там отображается код устройства
`No MSAL accounts found`	Запустите `npx mcp-dataverse-auth`, затем перезапустите сервер
`Authentication timed out`	Перезапустите MCP-сервер — новый код будет сгенерирован автоматически
Сервер не появляется в режиме агента	Запустите `npx mcp-dataverse install` или `npx mcp-dataverse doctor`
Ошибки HTTP	Запустите `npx mcp-dataverse doctor` для диагностики конфигурации и подключения

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

MCP Dataverse разработан как комплексное решение, но большинство ИИ-моделей лучше работают с меньшим количеством инструментов в контексте. Снимите выбор с инструментов, которые вам не нужны, в средстве выбора инструментов вашего клиента (например, на панели чата VS Code), чтобы агент оставался сфокусированным и отзывчивым.

Дорожная карта

Версия	Функция	Статус
v0.4	HTTP-транспорт + управление атрибутами + согласованность схемы	✅ Выпущено
v0.5	Корпоративная аутентификация (Client Credentials, Managed Identity, Entra JWT)	✅ Выпущено
v0.6	MCP Prompts (5 шаблонов) + MCP Resources (4)	✅ Выпущено
v0.7	Запись схемы (создание таблицы/связи) + Доступ к записям (общий доступ, объединение)	✅ Выпущено (v0.7.5)

→ Полная дорожная карта

MCP Dataverse

MCP Dataverse

Зачем нужен MCP Dataverse?

Установка

Аутентификация

Возможности

HTTP-транспорт

Устранение неполадок

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

Дорожная карта

Лицензия

Resources

Latest Blog Posts

MCP directory API