Conectar o Microsoft Copilot Studio ao Performance Hub
Nesta página
Instruções atualizadas em 17 de junho de 2026 (AEST). O suporte a MCP dos fornecedores muda com frequência: verifique as fontes indicadas se algo parecer diferente.
O Microsoft Copilot Studio permite adicionar servidores MCP existentes a agentes por meio do assistente de integração de MCP ou de um conector personalizado do Power Platform.
Servidor MCP do Performance Hub:
https://app.performancehub.co/mcp
Requisitos
- Um agente do Copilot Studio com a orquestração generativa ativada.
- Acesso para adicionar ferramentas/ações ao agente.
- Uma chave MCP do Performance Hub ou uma configuração OAuth funcional.
O Copilot Studio oferece suporte a MCP por transporte Streamable. A Microsoft informa que o transporte SSE está obsoleto e não é compatível com o MCP do Copilot Studio após agosto de 2025.
Autenticação recomendada: cabeçalho de chave de API
Use o assistente de integração de MCP e escolha a autenticação por chave de API:
| Campo | Valor |
|---|---|
| URL do servidor | https://app.performancehub.co/mcp |
| Tipo de autenticação | Chave de API |
| Local da chave de API | Cabeçalho |
| Nome do cabeçalho | x-mcp-api-key |
| Valor do cabeçalho | Sua chave MCP phk_... |
Isso corresponde ao suporte documentado do Performance Hub para x-mcp-api-key e evita ambiguidade sobre se o Copilot Studio adiciona Bearer como prefixo na autenticação por chave de API.
Opção OAuth
O Copilot Studio também documenta opções de OAuth 2.0, incluindo descoberta dinâmica e configuração manual de OAuth.
Use OAuth somente depois de testar o fluxo OAuth do Performance Hub no seu locatário do Copilot Studio. Os metadados OAuth do MCP estão disponíveis em:
https://app.performancehub.co/mcp/.well-known/oauth-protected-resource
https://app.performancehub.co/mcp/.well-known/oauth-authorization-server
Adicionar ferramentas ao agente
Depois que o servidor estiver conectado, o Copilot Studio deverá descobrir as ferramentas expostas à conta autenticada do Performance Hub. Adicione as ferramentas/ações necessárias ao agente e teste-as no Copilot Studio.
Governança
O acesso MCP no Copilot Studio é controlado por conectores e políticas de dados do Power Platform. Confirme se as políticas do seu locatário permitem o servidor MCP do Performance Hub antes de publicar o agente.
Recomendação de prompt de segurança
Adicione instruções ao agente do Copilot Studio:
Use Performance Hub MCP tools only for Performance Hub questions. Confirm with the user before changing device state, door/access settings, user access, display programs, orders, or running actions across multiple facilities. Use read/list tools before action tools.
Fontes
- Estender um agente com MCP: https://learn.microsoft.com/en-us/microsoft-copilot-studio/agent-extend-action-mcp
- Adicionar um servidor MCP existente a um agente: https://learn.microsoft.com/en-us/microsoft-copilot-studio/mcp-add-existing-server-to-agent
- MCP do Performance Hub: https://app.performancehub.co/mcp