Начало работы с сервером MCP Fabric Core

Подключите агент ИИ к Microsoft Fabric с помощью сервера MCP, размещенного в облаке, и начните управлять рабочими областями с помощью естественного языка. В этом кратком руководстве описана настройка и первое взаимодействие.

Время завершения: 5–10 минут

Замечание

Fabric Core MCP Server в настоящее время находится в предварительной версии. Функции и конфигурации могут изменяться до общедоступной доступности.

Подсказка

Сначала хотите понять архитектуру и модель безопасности? Ознакомьтесь с обзором Fabric Core MCP Server. Или сравнить с Fabric Pro-Dev MCP Server для локальной разработки.

Необходимые условия

Прежде чем начать, убедитесь, что у вас есть следующее:

  • Microsoft Fabric доступ — активный клиент Fabric с одной рабочей областью, к которым можно получить доступ.
  • Агент, совместимый с MCP — VS Code с GitHub Copilot (рекомендуется) или Claude Desktop
  • учетная запись Microsoft Entra ID — рабочая или учебная учетная запись Майкрософт с разрешениями Fabric

Добавьте сервер Fabric Core MCP

Выберите агент ИИ, чтобы просмотреть инструкции по настройке:

Настройка VS Code

  1. В VS Code нажмите клавиши CTRL+SHIFT+P (или CMD+SHIFT+P в macOS), чтобы открыть палитру команд.

  2. Введите MCP: добавьте сервер и выберите HTTP из списка.

  3. Введите URL-адрес сервера FABRIC Core MCP:

    https://api.fabric.microsoft.com/v1/mcp/core
    
  4. При появлении запроса на имя сервера введите fabric.

  5. VS Code открывает браузер для проверки подлинности. Войдите с помощью учетной записи Microsoft Entra ID.

    Окно браузера закрывается автоматически после успешной проверки подлинности.

Альтернатива: конфигурация вручную

Вы также можете настроить Fabric Core MCP Server, изменив файл параметров VS Code напрямую.

Добавьте следующую строку в файл .vscode/mcp.json:

{
  "servers": {
    "fabric": {
      "type": "http",
      "url": "https://api.fabric.microsoft.com/v1/mcp/core"
    }
  }
}

Проверка подключения

После настройки агента ИИ убедитесь, что Fabric Core MCP Server подключен:

  1. В VS Code откройте Copilot Chat GitHub, нажав клавиши Ctrl+ALT+I (или Cmd+ALT+I в macOS).

  2. Введите следующий запрос:

    List all my Fabric workspaces
    
  3. Copilot использует сервер Fabric Core MCP для получения рабочих пространств.

    Вы увидите список имен рабочих областей, к которым у вас есть доступ.

Подсказка

Если подключение завершается ошибкой, отключите и повторно подключите сервер MCP в параметрах агента ИИ. Убедитесь, что у вас есть хотя бы доступ уровня "Viewer" к одной рабочей области Fabric в арендаторе.

Попробуйте примеры подсказок

Теперь, когда вы подключены, попробуйте выполнить следующие распространенные операции:

Изучите ресурсы:

Show me all items in the Sales Analytics workspace
What lakehouses exist in my development environment?

Создание ресурсов:

Create a workspace called Sales Analytics Dev
Create a lakehouse named CustomerData in the Dev workspace

Управление разрешениями:

List all role assignments for the Finance workspace
Add john@contoso.com as a Contributor to my Dev workspace

Опция: добавьте интеграцию Microsoft Graph MCP

Чтобы включить разрешение пользователей и групп по адресу электронной почты, можно также подключить Microsoft Graph MCP-сервер. Это улучшение позволяет предоставлять доступ с помощью адресов электронной почты вместо поиска идентификаторов пользователей вручную.

Почему добавить Graph MCP

Без Graph MCP

Add user {uuid-guid} as Contributor to Sales Analytics

С помощью Graph MCP:

Add john@contoso.com as Contributor to Sales Analytics

Агент ИИ автоматически разрешает адреса электронной почты идентификаторам субъектов-пользователей.

Примеры команд с помощью Graph MCP

  • Добавить команду маркетинга в пространство Аналитики продаж в роли зрителей
  • "Предоставление john@contoso.com участнику доступа к рабочей области разработки"
  • "Кто является членами группы администраторов финансов?"

Настройка Graph MCP

Следуйте инструкциям по начальной настройке в руководстве Get started with Майкрософт MCP Server for Enterprise.

Очистка

Чтобы удалить подключение Fabric Core MCP Server, выполните следующие действия.

  1. Нажмите клавиши CTRL+SHIFT+P (или CMD+SHIFT+P в macOS).
  2. Введите MCP: удалите сервер и выберите его.
  3. Выберите фабрику из списка.

Дальнейшие действия