Часто задаваемые вопросы о подключении к Dataverse с помощью протокола контекста модели

В этой статье приведены ответы на часто задаваемые вопросы об использовании Microsoft Dataverse с сервером контекста модели (MCP).

Я не могу пройти проверку подлинности. В чем проблема?

Убедитесь, что URL-адрес среды Dataverse в конфигурации клиента MCP правильно. Перейдите в Power Apps, выберите нужную среду, а затем выберите Параметры (значок шестеренки) >Сведения о сеансе, чтобы проверить URL-адрес экземпляра.

Кроме того, убедитесь, что используется клиент MCP в Центре администрирования Power Platform. Дополнительные сведения: настройка и управление сервером Dataverse MCP в среде

Какие средства MCP доступны и что они делают?

Сервер Dataverse MCP предоставляет средства для распространенных операций с данными, таких как запросы записей, создание и обновление строк и описание схем таблиц. Полный список инструментов и описаний см. в разделе "Подключение к Dataverse с помощью протокола контекста модели".

Можно ли ограничить доступ к таблицам или записям через сервер MCP?

Да. Сервер Dataverse MCP учитывает роли безопасности Dataverse и безопасность на уровне строк. Пользователи могут получать доступ только к тем таблицам и записям, к которым разрешает их роль безопасности. Кроме стандартной конфигурации безопасности Dataverse не требуются дополнительные средства управления доступом, зависящие от MCP.

Существуют ли затраты, связанные с использованием сервера Dataverse MCP?

Начиная с 15 декабря 2025 года, взимается плата за использование инструментов Dataverse MCP при доступе агентов ИИ, созданных за пределами Microsoft Copilot Studio. Если у вас есть соответствующие лицензии Dynamics 365 Premium или пользовательская лицензия на подписку Microsoft 365 Copilot (USL), с вас не взимается плата за доступ к данным Dynamics 365. Сведения о тарифах выставления счетов см. в разделе Подключение к Dataverse с помощью протокола контекста модели.

Можно ли использовать сервер Dataverse MCP с несколькими средами?

Да. Каждая среда Dataverse может иметь собственную конфигурацию сервера MCP. Вы можете подключиться к нескольким средам, настроив отдельные записи сервера MCP в клиенте, каждый из которых указывает на другой URL-адрес среды.

Подсказка

Если вы используете Microsoft Copilot Studio, вы можете использовать мастер подключения MCP для подключения агента к серверам Dataverse MCP в нескольких средах. Мастер поможет вам выполнить настройку сервера и настройку проверки подлинности. Дополнительные сведения: подключение агента к существующему серверу MCP

Что делать, если средство Dataverse MCP возвращает ошибку?

Если средство возвращает ошибку, попробуйте повторить повторную отправку запроса и отправить его еще раз. Используйте более конкретный язык, чтобы описать то, что вы хотите достичь. Если ошибка сохраняется, убедитесь, что у вас есть соответствующие разрешения Dataverse для операции, которую вы пытаетесь выполнить.

Что случилось с describe_table, list_tablesи fetch инструментами?

Область инструментов сервера Dataverse MCP обновляется. Предыдущие инструменты describe_table, list_tables и fetch удалены, а их функциональность обеспечивается другими инструментами:

Удален инструмент	Replacement
describe_table	describe
list_tables	describe
fetch	describe

Предыдущее search средство для поиска данных Dataverse было переименовано в search_data. Текущее search средство выполняет поиск метаданных Dataverse, чтобы помочь агентам найти соответствующие таблицы и приложения.

Если клиент MCP поддерживает списки разрешений или запретов по имени средства, просмотрите и обновите конфигурацию таким образом, чтобы новые имена инструментов соответствовали вашим предполагаемым разрешениям.

Полный список инструментов см. в разделе "Подключение к dataverse" с помощью протокола контекста модели.

Почему я не вижу инструмент search_data в сервере Dataverse MCP?

Средство search_data доступно, только если для вашей среды включен поиск Dataverse. Если поиск Dataverse не включён, инструмент search_data не отображается в списке доступных инструментов MCP. Чтобы включить поиск Dataverse, перейдите к разделу "Настройка поиска Dataverse" для вашей среды.

Почему в точках доступа /api/mcp и /api/mcp_preview отображаются различные средства?

Конечная точка /api/mcp предоставляет общедоступный набор инструментов MCP Dataverse. Конечная точка /api/mcp_preview включает дополнительные инструменты предварительной версии, которые проходят оценку до общей доступности. Средства предварительной версии могут изменяться или удаляться без уведомления. Чтобы получить доступ к средствам предварительной версии, администратор должен включить параметры предварительных версий в Центре администрирования Power Platform. Дополнительные сведения: использование средств предварительной версии и предстоящих функций на сервере Dataverse MCP

Как включить ведение журнала отладки для локального прокси-сервера?

При возникновении проблем с локальным прокси-сервером (@microsoft/dataverse) можно включить ведение журнала отладки для записи подробных выходных данных для устранения неполадок. Добавьте аргументы --log-level и --log-file в команду прокси-сервера.

npx @microsoft/dataverse mcp https://yourorg.crm.dynamics.com --log-level Debug --log-file

Файл журнала записывается во временный каталог системы. Расположение по умолчанию зависит от операционной системы:

Операционная система	Расположение файла журнала
Windows	C:\Users\<username>\AppData\Local\Temp\
Linux	/tmp/
macOS	Каталог, указанный переменной $TMPDIR среды, обычно /var/folders/.../T/. Запустите echo $TMPDIR в терминале, чтобы найти точный путь.

Вы можете поделиться файлом выходного журнала с Microsoft при создании инцидента поддержки, чтобы помочь диагностировать проблему.