Introducción al servidor MCP de Fabric Core

Conecte el agente de IA al servidor MCP de Fabric core y, a continuación, use lenguaje natural para administrar áreas de trabajo y elementos de Fabric.

Tiempo de finalización: 5-10 minutos

Prerrequisitos

Antes de comenzar, asegúrese de que tiene:

  • Acceso a Microsoft Fabric: una cuenta profesional o educativa en Microsoft Entra ID que puede acceder al menos a un área de trabajo de Fabric
  • Cliente MCP: un host de MCP o su propio agente, que admite el transporte HTTP de streaming y el inicio de sesión con Microsoft Entra ID (se recomienda VS Code con GitHub Copilot).

Agregar Servidor MCP Principal de Fabric Core

Seleccione cómo conectarse: VS Code con GitHub Copilot, otro host de MCP o su propio agente.

Seleccione Instalar el servidor MCP Core de Fabric en VS Code. VS Code agrega el servidor con el nombre fabric. Cuando se inicie el servidor, inicie sesión con la cuenta de Microsoft Entra ID.

Agregue el servidor usted mismo

Agregue lo siguiente a .vscode/mcp.json y, a continuación, inicie el servidor fabric e inicie sesión con la cuenta de Microsoft Entra ID:

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

Para ver otras formas de agregar, iniciar y administrar servidores, consulte Usar servidores MCP en VS Code.

Verifique la conexión

Después de configurar el agente de IA, compruebe que Fabric servidor MCP Core está conectado:

En GitHub Copilot Chat, escriba el siguiente prompt:

List all my Fabric workspaces

Copilot usa Fabric Core MCP Server y enumera las áreas de trabajo a las que puede acceder.

Probar mensajes de ejemplo

Importante

Algunos ejemplos crean recursos o cambian los permisos de acceso. Revise las llamadas a herramientas propuestas y la configuración de aprobación de su cliente antes de permitir los cambios. Para obtener más instrucciones, consulte Seguridad y cumplimiento.

Explorar recursos:

Show me all items in the Sales Analytics workspace
Show the OneLake data access roles for the Sales lakehouse. Don't change any roles.

Crear recursos:

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

Administrar permisos:

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

Sugerencia

Para conceder acceso por dirección de correo electrónico, como en el ejemplo anterior, también conéctese a Microsoft MCP Server for Enterprise. Sin él, proporcione el identificador de objeto del usuario.

Troubleshoot

En VS Code u otro host de MCP

Problema Solución
No se le pide que inicie sesión o se produce un error al iniciar sesión. Asegúrese de que el host de MCP admite Microsoft Entra ID inicio de sesión e inicie sesión con su cuenta profesional o educativa. En VS Code, quite el servidor Fabric y vuelva a agregarlo.
El inicio de sesión solicita la aprobación del administrador. Su organización requiere que un administrador apruebe la aplicación con la que usted inicia sesión. Pida al administrador que lo apruebe. El nombre de la aplicación aparece en la pantalla de inicio de sesión.
El agente notifica un identificador de área de trabajo no válido. Pida al agente que enumere los espacios de trabajo y, a continuación, consulte el espacio de trabajo por su identificador.
El agente no puede encontrar un área de trabajo o un elemento esperado. Compruebe el nombre o el identificador y compruebe que puede acceder al área de trabajo o al elemento en Fabric.
Una herramienta que esperaba no está disponible. Las herramientas pueden cambiar con el tiempo. Actualice la lista de herramientas del servidor en el host de MCP o vea la referencia de herramientas.

En su propio agente

Cuando se produce un error en una llamada de herramienta, el error suele aparecer en el resultado de la herramienta, con isError establecido en true, en lugar de como un error HTTP. El resultado incluye un código de error y un mensaje.

Error Causa y solución
401 con "errorCode": "TokenIsMissing" y "Access token is required" La solicitud no incluía un token de acceso. Envíe el token en el encabezado Authorization: Bearer.
401 con JSON-RPC error -32600 y "Unable to process the request" El token no es válido. Adquiera un nuevo token para https://api.fabric.microsoft.com.
"Invalid arguments for tool <name>" Compruebe los argumentos con el esquema de entrada de la herramienta en la respuesta tools/list.
"errorCode": "WorkspaceNotFound" o "EntityNotFound" No se encontró el área de trabajo o el elemento. Compruebe que el identificador es correcto.
error -32602 de JSON-RPC y "Tool <name> not found" El nombre de la herramienta es incorrecto o ya no existe. Vuelva a enumerar las herramientas del servidor.

Si se pone en contacto con Microsoft soporte técnico, incluya la hora del error, el cliente MCP que usa y el identificador de solicitud si el error muestra uno.

Limpieza

Para quitar la conexión del servidor MCP principal de Fabric:

Quite el servidor Fabric de la configuración de MCP de VS Code. Para obtener más información, consulte Use MCP servers in VS Code.

Pasos siguientes