Referencia de las herramientas de servidor MCP de Fabric Core

Fabric Core MCP Server proporciona herramientas que usan los agentes de IA para interactuar con Microsoft Fabric. Cada herramienta se asigna a una operación de API rest de Fabric e incluye la validación de entrada y el control de errores.

Nota:

Fabric Core MCP Server está actualmente en versión preliminar. Las herramientas disponibles y sus funcionalidades pueden cambiar antes de la disponibilidad general.

Herramientas disponibles

Herramienta Descripción
list_workspaces Enumerar todas las áreas de trabajo a las que tiene acceso
get_workspace Obtención de información detallada sobre un área de trabajo específica
create_workspace Creación de un área de trabajo en el inquilino de Fabric
update_workspace Actualizar el nombre o la descripción de un área de trabajo
delete_workspace Eliminación de un área de trabajo existente
add_workspace_role Concesión de acceso de un usuario a un área de trabajo
list_workspace_roles Enumerar todas las asignaciones de roles de un área de trabajo
get_workspace_role Obtener detalles sobre una asignación de roles específica
update_workspace_role Cambiar el rol de un usuario en un área de trabajo
delete_workspace_role Eliminación del acceso de un usuario a un área de trabajo
list_items Enumerar todos los elementos de un área de trabajo
get_item Obtener información detallada sobre un elemento específico
create_item Creación de un nuevo elemento en un área de trabajo
update_item Actualizar el nombre o la descripción de un elemento
delete_item Eliminación de un elemento de un área de trabajo
get_item_definition Obtener el esquema o la definición de un elemento
update_item_definition Actualizar la definición o el esquema de un elemento
bulk_move_items Mover varios elementos a una carpeta
create_folder Creación de una carpeta en un área de trabajo
list_folders Enumerar todas las carpetas de un área de trabajo
get_folder Obtener detalles sobre una carpeta específica
update_folder Cambiar el nombre de una carpeta
delete_folder Eliminación de una carpeta vacía
move_folder Mover una carpeta a una nueva carpeta primaria
list_capacities Enumerar todas las capacidades de Fabric a las que tiene acceso
get_operation_state Comprobación del estado de una operación de ejecución prolongada
get_operation_result Obtener el resultado de una operación completada
get_knowledge Obtener instrucciones y procedimientos recomendados para los tipos de elementos

Roles de entorno de trabajo

Fabric áreas de trabajo admiten cuatro niveles de rol:

Función Permisos
Administrador Control total, incluida la configuración del área de trabajo, las asignaciones de roles y la eliminación
Miembro Crear, editar y eliminar elementos; no puede administrar la configuración o los roles del área de trabajo
Colaborador Crear y editar elementos; no se pueden eliminar elementos
Visor Acceso de solo lectura al área de trabajo y a los elementos

Notas importantes

  • Debe tener permisos para crear áreas de trabajo en el inquilino de Fabric. Algunas organizaciones restringen la creación del área de trabajo a roles específicos.
  • Al eliminar un área de trabajo, se quitan permanentemente todos los elementos que contiene. No se puede deshacer esta operación.
  • Las carpetas deben estar vacías antes de eliminarlas. Mueva o elimine primero todos los elementos de la carpeta.
  • Agregue Microsoft Graph MCP Server para resolver las direcciones de correo electrónico automáticamente. Sin él, debe proporcionar identificadores de entidad de seguridad de usuario para las operaciones de rol.

Flujos de trabajo de ejemplo

Flujo de trabajo 1: Exploración del entorno

Descubra a qué recursos tiene acceso en Fabric.

Avisos:

  1. "Enumerar todas mis áreas de trabajo de Fabric"
  2. "Mostrarme todos los elementos del área de trabajo Sales Analytics"
  3. "¿Qué casas de lago existen en Sales Analytics?"
  4. "Obtener la definición de CustomerData lakehouse"

Flujo de trabajo 2: Creación de un entorno de desarrollo

Configure un área de trabajo de desarrollo completa con recursos y acceso al equipo.

Avisos:

  1. "Crear un área de trabajo denominada Desarrollo de Sales Analytics"
  2. "Creación de una instancia de Lakehouse denominada CustomerData_Dev en Sales Analytics Dev"
  3. "Agregar john@contoso.com como colaborador al desarrollo de Sales Analytics"
  4. "Agregar sarah@contoso.com como miembro al desarrollo de Sales Analytics"

Sugerencia

Este flujo de trabajo requiere Microsoft Graph MCP para resolver las direcciones de correo electrónico. Sin Graph MCP, proporcione identificadores principales de usuario en lugar de correos electrónicos.

Flujo de trabajo 3: Auditoría y administración de permisos

Revise y actualice el control de acceso al área de trabajo.

Avisos:

  1. "Enumerar todas las asignaciones de roles para el área de trabajo Finanzas"
  2. "¿Quién tiene acceso de administrador a Finance?"
  3. "Cambiar john@contoso.com de Visor a Colaborador en Finanzas"
  4. "Quitar contractor@contoso.com del área de trabajo Finanzas"

Solución de problemas

Error de identificador de área de trabajo no válido

Problema: El mensaje de error indica "Id. de área de trabajo no válido" al proporcionar un nombre de área de trabajo o un identificador.

Solution:

  1. Ejecute list_workspaces para obtener el identificador de área de trabajo correcto.
  2. Use el identificador del área de trabajo (formato UUID) en las operaciones posteriores.

Error de autenticación (errores 401 o 403)

Problema: Las operaciones producen errores de autorización.

Solución para VS Code:

  1. Presione Ctrl+Mayús+P y seleccione MCP: Quitar servidor, elija tejido.
  2. Presione Ctrl+Mayús+P y seleccione MCP: Agregar HTTP del servidor>.
  3. Escriba https://api.fabric.microsoft.com/v1/mcp/core y complete la autenticación del explorador.

Solución para Claude Desktop y otros clientes:

  1. Genere un nuevo token de acceso:

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

  2. Actualice la configuración del cliente con el nuevo token.

Tiempo de espera de la operación de ejecución prolongada

Problema: La operación parece que se ha agotado el tiempo de espera o no se completa.

Solución: Use las herramientas de operaciones para supervisar las operaciones asincrónicas:

  1. Anote el operation-id devuelto de la operación inicial.
  2. Comprobar el estado: "Comprobar el estado de la operación {operation-id}"
  3. Una vez que el estado es "Correcto", obtenga el resultado: "Obtener el resultado de la operación {operation-id}"

Detalles de conexión

  • Punto final:https://api.fabric.microsoft.com/v1/mcp/core
  • Auth: OAuth 2.0 a través de Microsoft Entra ID
  • Alcance:https://api.fabric.microsoft.com/.default

Contenido relacionado

  • Last updated on