Power Platform MCP Connector Suite

Gere implementações completas de conectores personalizados do Power Platform com integração do Model Context Protocol para o Microsoft Copilot Studio.

Capacidades do MCP no Copilot Studio

Atualmente Suportado:

• ✅ Ferramentas: Funções que o LLM pode chamar (com aprovação do usuário)
• ✅ Recursos: Dados semelhantes a arquivos que os agentes podem ler (devem ser saídas de ferramentas)

Ainda Não Suportado:

• ❌ Prompts: Modelos pré-escritos (prepare-se para suporte futuro)

Geração de Conector

Crie um conector completo do Power Platform com:

Arquivos Principais:

• apiDefinition.swagger.json com x-ms-agentic-protocol: mcp-streamable-1.0
• apiProperties.json com metadados do conector e autenticação
• script.csx com transformações personalizadas em C# para tratamento de MCP JSON-RPC
• readme.md com documentação do conector

Integração MCP:

• Endpoint POST /mcp para comunicação JSON-RPC 2.0
• Definições de esquema McpResponse e McpErrorResponse
• Conformidade com restrições do Copilot Studio (sem tipos de referência, tipos únicos)
• Integração de recursos como saídas de ferramentas (Recursos e Ferramentas suportados; Prompts ainda não suportados)

Validação de Esquema e Solução de Problemas

Valide esquemas para conformidade com o Copilot Studio:

• ✅ Sem tipos de referência ($ref) em entradas/saídas de ferramentas
• ✅ Apenas valores de tipo único (não ["string", "number"])
• ✅ Tipos primitivos: string, number, integer, boolean, array, object
• ✅ Recursos como saídas de ferramentas, não entidades separadas
• ✅ URIs completas para todos os endpoints

Problemas comuns e correções:

• Ferramentas filtradas → Remova tipos de referência, use primitivos
• Erros de tipo → Tipos únicos com lógica de validação
• Recursos indisponíveis → Inclua nas saídas de ferramentas
• Falhas de conexão → Verifique o cabeçalho x-ms-agentic-protocol

Variáveis de Contexto

• Nome do Conector: [Nome de exibição para o conector]
• Propósito do Servidor: [O que o servidor MCP deve realizar]
• Ferramentas Necessárias: [Lista de ferramentas MCP a serem implementadas]
• Recursos: [Tipos de recursos a serem fornecidos]
• Autenticação: [nenhuma, api-key, oauth2, basic]
• Ambiente de Hospedagem: [Azure Function, Express.js, etc.]
• APIs de Destino: [APIs externas a serem integradas]

Modos de Geração

Modo 1: Conector Completamente Novo

Gere todos os arquivos para um novo conector MCP do Power Platform do zero, incluindo configuração de validação CLI.

Modo 2: Validação de Esquema

Analise e corrija esquemas existentes para conformidade com o Copilot Studio usando paconn e ferramentas de validação.

Modo 3: Solução de Problemas de Integração

Diagnostique e resolva problemas de integração MCP com o Copilot Studio usando ferramentas de depuração CLI.

Modo 4: Conector Híbrido

Adicione capacidades MCP a um conector existente do Power Platform com fluxos de trabalho de validação adequados.

Modo 5: Preparação para Certificação

Prepare o conector para envio de certificação da Microsoft com metadados completos e conformidade de validação.

Modo 6: Fortalecimento de Segurança OAuth

Implemente autenticação OAuth 2.0 aprimorada com melhores práticas de segurança MCP e validação avançada de tokens.

Saída Esperada

1. apiDefinition.swagger.json

• Formato Swagger 2.0 com extensões da Microsoft
• Endpoint MCP: POST /mcp com cabeçalho de protocolo adequado
• Definições de esquema compatíveis (apenas tipos primitivos)
• Definições McpResponse/McpErrorResponse

2. apiProperties.json

• Metadados e branding do conector (iconBrandColor obrigatório)
• Configuração de autenticação
• Modelos de política para transformações MCP

3. script.csx

• Tratamento de mensagens JSON-RPC 2.0
• Transformações de solicitação/resposta
• Lógica de conformidade do protocolo MCP
• Tratamento de erros e validação

4. Orientação de Implementação

• Padrões de registro e execução de ferramentas
• Estratégias de gerenciamento de recursos
• Etapas de integração com o Copilot Studio
• Procedimentos de teste e validação

Lista de Verificação de Validação

Conformidade Técnica

• x-ms-agentic-protocol: mcp-streamable-1.0 no endpoint MCP
• Sem tipos de referência em nenhuma definição de esquema
• Todos os campos de tipo são tipos únicos (não arrays)
• Recursos incluídos como saídas de ferramentas
• Conformidade JSON-RPC 2.0 em script.csx
• Endpoints de URI completos em todo o conector
• Descrições claras para agentes do Copilot Studio
• Autenticação configurada corretamente
• Modelos de política para transformações MCP
• Compatibilidade com Generative Orchestration

Validação CLI

• paconn validate: paconn validate --api-def apiDefinition.swagger.json passa sem erros
• pac CLI pronto: O conector pode ser criado/atualizado com pac connector create/update

…