Справочник по средствам Fabric Core MCP Server

Fabric Core MCP Server предоставляет средства, используемые агентами ИИ для взаимодействия с Microsoft Fabric. Каждое средство сопоставляется с Fabric операцией REST API и включает входную проверку и обработку ошибок.

Замечание

Fabric Core MCP Server в настоящее время находится в предварительной версии. Доступные средства и их возможности могут изменяться до общедоступной доступности.

Доступные средства

инструмент Описание
list_workspaces Вывод списка всех рабочих областей, к которых у вас есть доступ
get_workspace Получение подробных сведений о конкретной рабочей области
create_workspace Создание рабочей области в клиенте Fabric
update_workspace Обновление имени или описания рабочей области
delete_workspace Удаление существующей рабочей области
add_workspace_role Предоставление пользователю доступа к рабочей области
list_workspace_roles Вывод списка всех назначений ролей для рабочей области
get_workspace_role Получение сведений о назначении определенной роли
update_workspace_role Изменение роли пользователя в рабочей области
delete_workspace_role Удаление доступа пользователя к рабочей области
list_items Вывод списка всех элементов в рабочей области
get_item Получение подробных сведений об определенном элементе
create_item Создание нового элемента в рабочей области
update_item Обновление имени или описания элемента
delete_item Удаление элемента из рабочей области
get_item_definition Получение схемы или определения элемента
update_item_definition Обновление определения или схемы элемента
bulk_move_items Перемещение нескольких элементов в папку
create_folder Создание папки в рабочей области
list_folders Вывод списка всех папок в рабочей области
get_folder Получение сведений о определенной папке
update_folder Переименование папки
delete_folder Удаление пустой папки
move_folder Перемещение папки в новую родительскую папку
list_capacities Перечислить все Fabric емкости, к которых у вас есть доступ
get_operation_state Проверка состояния длительной операции
get_operation_result Получение результата завершенной операции
get_knowledge Получение рекомендаций и рекомендаций по типам элементов

Роли рабочего пространства

рабочие области Fabric поддерживают четыре уровня ролей:

Роль Разрешения
Администратор Полный контроль, включая параметры рабочей области, назначения ролей и удаление
Член Создание, изменение и удаление элементов; Не удается управлять параметрами рабочей области или ролями
Contributor Создание и изменение элементов; Не удается удалить элементы
Зритель Доступ только для чтения к рабочей области и элементам

Важные примечания

  • У вас должны быть разрешения на создание рабочих областей в клиенте Fabric. Некоторые организации ограничивают создание рабочей области определенными ролями.
  • Удаление рабочей области окончательно удаляет все элементы в ней. Отменить эту операцию невозможно.
  • Папки должны быть пустыми перед удалением. Сначала переместите или удалите все элементы в папке.
  • Добавьте Microsoft Graph MCP Server для автоматического разрешения адресов электронной почты. Без этого необходимо предоставить идентификаторы субъектов-пользователей для операций ролей.

Примеры рабочих процессов

Рабочий процесс 1. Изучение среды

Узнайте, к каким ресурсам у вас есть доступ в Fabric.

Запросы:

  1. Перечисление всех моих рабочих областей Fabric"
  2. "Показать все элементы в рабочей области "Аналитика продаж"
  3. "Какие лейкхаусы существуют в Аналитике продаж?"
  4. "Получение определения озера CustomerData"

Рабочий процесс 2. Создание среды разработки

Настройте полную рабочую область разработки с ресурсами и доступом к команде.

Запросы:

  1. Создание рабочей области с именем Sales Analytics Dev
  2. Создание lakehouse с именем CustomerData_Dev в Sales Analytics Dev
  3. "Добавление john@contoso.com в качестве участника в разработку аналитики продаж"
  4. "Добавление sarah@contoso.com члена в разработку аналитики продаж"

Подсказка

Для разрешения адресов электронной почты этот рабочий процесс требует Microsoft Graph MCP. Без Graph MCP предоставьте идентификаторы субъектов-пользователей вместо сообщений электронной почты.

Рабочий процесс 3. Аудит разрешений и управление ими

Просмотрите и обновите управление доступом к рабочей области.

Запросы:

  1. Перечисление всех назначений ролей для рабочей области Finance
  2. "У кого есть доступ администратора к финансам?"
  3. "Изменение john@contoso.com от средства просмотра к участнику в финансах"
  4. "Удалить contractor@contoso.com из рабочей области Finance"

Troubleshooting

Недопустимая ошибка идентификатора рабочей области

Проблема: Сообщение об ошибке указывает "Недопустимый идентификатор рабочей области" при указании имени или идентификатора рабочей области.

Solution:

  1. Выполните команду list_workspaces , чтобы получить правильный идентификатор рабочей области.
  2. Используйте идентификатор рабочей области (формат UUID) в последующих операциях.

Сбой проверки подлинности (ошибки 401 или 403)

Проблема: Операции завершаются ошибкой авторизации.

Решение для VS Code:

  1. Нажмите клавиши CTRL+SHIFT+P и выберите MCP: Удалить сервер, выберите структуру.
  2. Нажмите клавиши CTRL+SHIFT+P и выберите MCP: добавить HTTP сервера>.
  3. Введите https://api.fabric.microsoft.com/v1/mcp/core и завершите проверку подлинности браузера.

Решение для Claude Desktop и других клиентов:

  1. Создайте новый маркер доступа:

    az account get-access-token --resource https://api.fabric.microsoft.com

  2. Обновите конфигурацию клиента с помощью нового маркера.

Время ожидания длительной операции

Проблема: Операция, как представляется, истекает или не завершается.

Решение: Используйте средства операций для мониторинга асинхронных операций:

  1. Обратите внимание на operation-id возвращаемую из начальной операции.
  2. Проверка состояния: "Проверка состояния операции {operation-id}"
  3. После получения состояния "Успешно" получите результат: "Получить результат операции {operation-id}"

Сведения о подключении

  • Конечная точка:https://api.fabric.microsoft.com/v1/mcp/core
  • Auth: OAuth 2.0 через Microsoft Entra ID
  • Размах:https://api.fabric.microsoft.com/.default

Связанный контент

  • Last updated on