Uso del servidor MCP para compilar aplicaciones con un agente de codificación

Se aplica a: Desarrollador

El servidor MCP de SharePoint Embedded es un servidor de protocolo de contexto de modelo de código abierto que permite a los clientes de IA compatibles con MCP configurar y administrar aplicaciones de SharePoint Embedded a través del lenguaje natural. Los clientes admitidos incluyen GitHub Copilot en Visual Studio Code o CLI, Claude Desktop, Cursor y Fundición de IA de Azure. Se distribuye como el @microsoft/spe-mcp paquete npm y se ejecuta localmente en la máquina como una herramienta para desarrolladores.

En lugar de hacer clic a través de portales y unir microsoft Graph y Azure comandos de la CLI a mano, se describe lo que quiere ("crear un tipo de contenedor de prueba para mi aplicación") y el cliente de inteligencia artificial llama a las herramientas del servidor para hacerlo.

Nota:

El servidor MCP de SharePoint Embedded es una herramienta para desarrolladores de código abierto publicada en versión preliminar. Su código fuente, la referencia completa de la herramienta y el seguimiento de problemas se ejecutan en el repositorio microsoft/SharePoint-Embedded-MCP-Server en GitHub.

Importante

Para empezar a compilar con SharePoint Embedded, necesitará acceso administrativo a un inquilino de Microsoft 365.

Si aún no tiene un inquilino, puede obtener el suyo propio con el Programa para desarrolladores de Microsoft 365, experiencia digital del cliente de Microsoft o una evaluación gratuita de una licencia de Microsoft 365 E3.

Lo que puede hacer con él

El servidor expone herramientas a las que un cliente de inteligencia artificial puede llamar en su nombre, agrupadas por tarea:

  • Aprovisionamiento y estado: compruebe la identidad y preparación de aprovisionamiento que ha iniciado sesión, cree la aplicación Microsoft Entra ID propietaria y cree, registre, enumere, actualice o elimine contenedores y tipos de contenedor. Una sola project_provision herramienta puede ejecutar toda la secuencia (tipo de contenedor de → aplicación → facturación → registro → contenedor) en una sola llamada.
  • Facturación: elija una suscripción de Azure y un grupo de recursos, registre el Microsoft.Syntex proveedor de recursos, vincule un tipo de contenedor a la facturación estándar e inspeccione la clasificación de facturación o la expiración de la prueba.
  • Scaffolding, ejecución e implementación: genere una aplicación de referencia que se pueda ejecutar (una aplicación React de página única con Azure Functions o una aplicación web de C#), escriba su configuración en tiempo de ejecución desde el estado de aprovisionamiento, el contenido de ejemplo de inicialización, ejecútelo localmente e impleméntelo en Azure.
  • Operaciones de contenido (participación): después de un consentimiento explícito y independiente, cargue archivos, cree carpetas, busque, obtenga una vista previa, administre el uso compartido y los permisos, y archive o restaure contenedores.
  • Documentación: busque y capture la documentación oficial de SharePoint Embedded y Microsoft Graph, fundamentada en el servidor MCP de Microsoft Learn.

Para obtener la lista completa con versiones de herramientas, marcas de CLI y variables de entorno, consulte el archivo LÉAME del servidor.

Requisitos previos

  • Node.js versión 22 o posterior.
  • CLI de Azure, ha iniciado sesión con az login --allow-no-subscriptions. La --allow-no-subscriptions marca es necesaria para los inquilinos de Microsoft 365 solo que no tienen Azure suscripción.
  • Acceso de inquilino y administrador de inquilinos de Microsoft 365 (administrador global o administrador de aplicaciones).
  • Un cliente compatible con MCP, como Visual Studio Code con GitHub Copilot, Claude Desktop o Cursor.

Instalar y configurar

Los clientes MCP inician el servidor con npx, por lo que no hay ninguna instalación global independiente. Agregue una entrada de servidor a la configuración de MCP del cliente.

Visual Studio Code

Agregue una entrada de servidor MCP a .vscode/mcp.json en el área de trabajo:

{
  "servers": {
    "spe": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@microsoft/spe-mcp", "start"]
    }
  }
}

La -y marca permite Visual Studio Code iniciar el servidor de forma no interactiva. Una vez registrado el servidor, use Copilot Chat en modo de agente para llamar a sus herramientas.

escritorio de Claude

Agregue el servidor a %APPDATA%\Claude\claude_desktop_config.json (Windows) o ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

{
  "mcpServers": {
    "spe": {
      "command": "npx",
      "args": ["-y", "@microsoft/spe-mcp", "start"]
    }
  }
}

Cursor y otros clientes MCP

Cualquier cliente que admita servidores MCP a través del transporte stdio puede ejecutar el servidor con el mismo npx -y @microsoft/spe-mcp start comando. Consulte la documentación del cliente para ver dónde registrar servidores MCP.

Elegir cómo se autentica el servidor

El servidor admite dos modos de ejecución.

  • Modo de arranque (recomendado para empezar): no se requiere ningún registro de aplicación. El servidor usa la sesión de la CLI de Azure para el plano de control y aprovisiona la aplicación propietaria Microsoft Entra ID a petición. Inicie sesión una vez e inicie el servidor sin ningún identificador de cliente:

    az login --allow-no-subscriptions

  • Modo de aplicación aprovisionada previamente: pase una aplicación de Microsoft Entra ID de cliente público existente que ya tenga permisos delegados con consentimiento del administrador para FileStorageContainer.Selected, FileStorageContainerType.Manage.Ally FileStorageContainerTypeReg.Manage.All. Proporcione el identificador de aplicación y el identificador de inquilino a través de las SPE_CLIENT_ID variables de entorno y SPE_TENANT_ID (o las --client-id marcas y --tenant-id ):

    {
  "servers": {
    "spe": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@microsoft/spe-mcp", "start"],
      "env": {
        "SPE_CLIENT_ID": "your-client-id",
        "SPE_TENANT_ID": "your-tenant-id"
      }
    }
  }
}

En el modo de arranque, la primera llamada a SharePoint Embedded abre un explorador para obtener un consentimiento único y almacena en caché el token, por lo que no se necesita ningún paso de terminal independiente. Para obtener información sobre la cascada de autenticación completa, los detalles del almacenamiento de tokens y la guía de automatización o sin cabeza, consulte EL ARCHIVO LÉAME del servidor.

Probarlo

Con el servidor registrado en el cliente y un inicio de sesión de la CLI de Azure completado, pida al cliente de inteligencia artificial que trabaje con SharePoint Embedded. Por ejemplo, en Copilot Chat:

  • "Enumerar los tipos de contenedor de SharePoint Embedded".
  • "Cree un tipo de contenedor de prueba llamado Contoso Docs para el identificador de aplicación abc-123".
  • "Aprovisionar una nueva aplicación de SharePoint Embedded y aplicar scaffolding a un ejemplo de React."

El cliente llama a las herramientas coincidentes, le pide su consentimiento la primera vez e informa de los resultados.

Controlar lo que puede hacer el servidor

El servidor incluye controles para limitar qué herramientas se exponen y se pueden llamar, útiles cuando se desea que un cliente de inteligencia artificial explore el entorno sin realizar cambios:

  • Modo de solo lectura: anuncie y permita solo las herramientas de lectura, lista, obtención y búsqueda, y rechace cualquier llamada mutante. Establezca la --read-only marca o la variable de SPE_READ_ONLY entorno.
  • Perfiles de herramientas: restrinja las herramientas expuestas a un perfil (readOnly, docsOnly, provisioning, contento admin) o a una lista separada por comas de nombres de herramientas, mediante la --tools marca o la variable de SPE_TOOLS entorno.

Las herramientas de operaciones de contenido también se bloquean detrás de un consentimiento explícito y independiente, por lo que un cliente de inteligencia artificial no puede leer ni cambiar archivos en los contenedores hasta que no lo acepte. Para ver el modelo de seguridad completo, consulte controles de seguridad en el repositorio del servidor.

Contenido relacionado

  • Last updated on