Utilizar o servidor MCP para criar aplicações com um agente de codificação

Aplica-se a: Programador

O servidor MCP do SharePoint Embedded é um servidor de Protocolo de Contexto de Modelo open source que permite aos clientes de IA compatíveis com MCP configurar e gerir aplicações Do SharePoint Embedded através de linguagem natural. Os clientes suportados incluem GitHub Copilot no Visual Studio Code ou na CLI, Claude Desktop, Cursor e Fábrica de IA do Azure. É distribuído como o @microsoft/spe-mcp pacote npm e executado localmente no seu computador como uma ferramenta de programador.

Em vez de clicar nos portais e juntar manualmente o Microsoft Graph e Azure comandos da CLI, descreve o que pretende — "criar um tipo de contentor de avaliação para a minha aplicação") e o cliente de IA chama as ferramentas do servidor para o fazer.

Observação

O servidor MCP do SharePoint Embedded é uma ferramenta de programador open source lançada em pré-visualização. O código fonte, a referência completa de ferramentas e o controlador de problemas estão em direto no repositório microsoft/SharePoint-Embedded-MCP-Server no GitHub.

Importante

Para começar a criar com o SharePoint Embedded, precisará de acesso administrativo a um inquilino do Microsoft 365.

Se ainda não tiver um inquilino, pode obter o seu próprio inquilino com o Programa para Programadores do Microsoft 365, aExperiência Digital do Cliente da Microsoft ou uma avaliação gratuita de uma licença de Microsoft 365 E3.

O que pode fazer com isto

O servidor expõe as ferramentas que um cliente de IA pode chamar em seu nome, agrupadas por tarefa:

  • Aprovisionamento e status: verifique a identidade com sessão iniciada e a preparação do aprovisionamento, crie a aplicação proprietária Microsoft Entra ID e crie, registe, liste, atualize ou elimine contentores e tipos de contentor. Uma única project_provision ferramenta pode executar toda a sequência — tipo de contentor → aplicação → → registo → contentor — numa chamada.
  • Faturação: escolha uma subscrição Azure e um grupo de recursos, registe o Microsoft.Syntex fornecedor de recursos, ligue um tipo de contentor à faturação padrão e inspecione a classificação de faturação ou a expiração da versão de avaliação.
  • Estruturar, executar e implementar: gere uma aplicação de referência executável (um React aplicação de página única com Azure Functions ou uma aplicação Web C#), escreva a respetiva configuração de runtime a partir do estado de aprovisionamento, conteúdo de exemplo de sementes, execute-o localmente e implemente-o no Azure.
  • Operações de conteúdo (opt-in): após um consentimento explícito e separado, carregue ficheiros, crie pastas, pesquise, pré-visualize, faça a gestão da partilha e das permissões e arquive ou restaure contentores.
  • Documentação: pesquise e obtenha a documentação oficial do SharePoint Embedded e do Microsoft Graph, com base no servidor MCP do Microsoft Learn.

Para obter a lista completa e com versões de ferramentas, sinalizadores da CLI e variáveis de ambiente, veja README do servidor.

Pré-requisitos

  • Node.js versão 22 ou posterior.
  • CLI do Azure, iniciou sessão com az login --allow-no-subscriptions. O --allow-no-subscriptions sinalizador é necessário para inquilinos apenas do Microsoft 365 que não tenham Azure subscrição.
  • Um inquilino do Microsoft 365 e acesso de administrador inquilino (Administrador Global ou Administrador de Aplicações).
  • Um cliente compatível com MCP, como Visual Studio Code com GitHub Copilot, Claude Desktop ou Cursor.

Instalar e configurar

Os clientes MCP iniciam o servidor com npx, pelo que não existe uma instalação global separada. Adicione uma entrada de servidor à configuração mcP do cliente.

Visual Studio Code

Adicione uma entrada de servidor MCP à .vscode/mcp.json área de trabalho:

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

O -y sinalizador permite Visual Studio Code iniciar o servidor de forma não interativa. Depois de o servidor ser registado, utilize Copilot Chat no modo de agente para chamar as ferramentas.

Claude Desktop

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

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

Cursor e outros clientes MCP

Qualquer cliente que suporte servidores MCP através do transporte stdio pode executar o servidor com o mesmo npx -y @microsoft/spe-mcp start comando. Veja a documentação do cliente para saber onde registar servidores MCP.

Escolher como o servidor se autentica

O servidor suporta dois modos de execução.

  • Modo bootstrap (recomendado para começar): Não é necessário registo de aplicações. O servidor utiliza a sessão da CLI Azure para o plano de controlo e aprovisiona a aplicação proprietária Microsoft Entra ID a pedido. Inicie sessão uma vez e inicie o servidor sem ID de cliente:

    az login --allow-no-subscriptions

  • Modo de aplicação pré-aprovisionada: transmita uma aplicação de cliente público Microsoft Entra ID existente que já tenha permissões delegadas de consentimento do administrador para FileStorageContainer.Selected, FileStorageContainerType.Manage.Alle FileStorageContainerTypeReg.Manage.All. Indique o ID da aplicação e o ID do inquilino através das SPE_CLIENT_ID variáveis de ambiente e SPE_TENANT_ID (ou dos --client-id sinalizadores e --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"
      }
    }
  }
}

No modo bootstrap, a primeira chamada do SharePoint Embedded abre um browser para obter um consentimento único e coloca o token em cache, pelo que não é necessário nenhum passo de terminal separado. Para obter a cascata de autenticação completa, detalhes de armazenamento de tokens e orientações de automatização/sem cabeça, veja o servidor README.

Experimente

Com o servidor registado no cliente e um início de sessão da CLI Azure concluído, peça ao cliente de IA para trabalhar com o SharePoint Embedded. Por exemplo, no Copilot Chat:

  • "Listar os meus tipos de contentor do SharePoint Embedded."
  • "Crie um tipo de contentor de avaliação denominado Contoso Docs para o ID da aplicação abc-123."
  • "Aprovisione uma nova aplicação Do SharePoint Embedded e estilize um React exemplo."

O cliente chama as ferramentas correspondentes, pede-lhe consentimento pela primeira vez e comunica os resultados.

Controlar o que o servidor pode fazer

O servidor inclui controlos para limitar as ferramentas que são expostas e callable— úteis quando pretende que um cliente de IA explore o seu ambiente sem fazer alterações:

  • Modo só de leitura: anuncie e permita apenas ferramentas de leitura, lista, obtenção e pesquisa e rejeite qualquer chamada em mutação. Defina o --read-only sinalizador ou a variável de SPE_READ_ONLY ambiente.
  • Perfis de ferramentas: restrinja as ferramentas expostas a um perfil (readOnly, docsOnly, provisioning, contentou admin) ou a uma lista separada por vírgulas de nomes de ferramentas, utilizando o --tools sinalizador ou a variável de SPE_TOOLS ambiente.

As ferramentas de operações de conteúdo também estão protegidas por um consentimento explícito e separado, pelo que um cliente de IA não pode ler ou alterar ficheiros nos seus contentores até optar ativamente por participar. Para obter o modelo de segurança completo, veja controlos de segurança no repositório do servidor.

Conteúdo relacionado

  • Last updated on