Gerador de Conector MCP para Power Platform

Gere um conector personalizado completo para Power Platform com integração do Model Context Protocol (MCP) para o Microsoft Copilot Studio. Este prompt cria todos os arquivos necessários seguindo os padrões de conectores do Power Platform com suporte a HTTP transmitível por MCP.

Instruções

Crie uma implementação completa de servidor MCP que:

1. Usa o Padrão MCP do Copilot Studio:

   • Implemente x-ms-agentic-protocol: mcp-streamable-1.0
   • Suporte ao protocolo de comunicação JSON-RPC 2.0
   • Forneça um endpoint HTTP transmitível em /mcp
   • Siga a estrutura do conector do Power Platform

2. Requisitos de Conformidade de Esquema:

   • SEM tipos de referência nas entradas/saídas da ferramenta (filtrados pelo Copilot Studio)
   • Apenas valores de tipo único (não arrays de múltiplos tipos)
   • Evite entradas de enum (interpretadas como string, não enum)
   • Use tipos primitivos: string, number, integer, boolean, array, object
   • Garanta que todos os endpoints retornem URIs completas

3. Componentes MCP a Incluir:

   • Ferramentas: Funções para o modelo de linguagem chamar (✅ Suportado no Copilot Studio)
   • Recursos: Saídas de dados semelhantes a arquivos das ferramentas (✅ Suportado no Copilot Studio - devem ser saídas de ferramentas para serem acessíveis)
   • Prompts: Modelos predefinidos para tarefas específicas (❌ Ainda não suportado no Copilot Studio)

4. Estrutura de Implementação:

   /apiDefinition.swagger.json  (Power Platform connector schema)
   /apiProperties.json         (Connector metadata and configuration)
   /script.csx                 (Custom code transformations and logic)
   /server/                    (MCP server implementation)
   /tools/                     (Individual MCP tools)
   /resources/                 (MCP resource handlers)
   

Variáveis de Contexto

• Propósito do Servidor: [Descreva o que o servidor MCP deve realizar]
• Ferramentas Necessárias: [Lista de ferramentas específicas a serem implementadas]
• Recursos: [Tipos de recursos a serem fornecidos]
• Autenticação: [Método de autenticação: none, api-key, oauth2]
• Ambiente de Hospedagem: [Azure Function, Express.js, FastAPI, etc.]
• APIs de Destino: [APIs externas a serem integradas]

Saída Esperada

Gere:

1. apiDefinition.swagger.json com:

   • Proper x-ms-agentic-protocol: mcp-streamable-1.0
   • Endpoint MCP em POST /mcp
   • Definições de esquema compatíveis (sem tipos de referência)
   • Definições de McpResponse e McpErrorResponse

2. apiProperties.json com:

   • Metadados e branding do conector
   • Configuração de autenticação
   • Modelos de política, se necessário

3. script.csx com:

   • Código C# personalizado para transformações de requisição/resposta
   • Lógica de tratamento de mensagens JSON-RPC MCP
   • Funções de validação e processamento de dados
   • Capacidades de tratamento de erros e logging

4. Código do Servidor MCP com:

   • Manipulador de requisições JSON-RPC 2.0
   • Registro e execução de ferramentas
   • Gerenciamento de recursos (como saídas de ferramentas)
   • Tratamento de erros adequado
   • Verificações de compatibilidade com Copilot Studio

5. Ferramentas Individuais que:

   • Aceitam apenas entradas de tipo primitivo
   • Retornam saídas estruturadas
   • Incluem recursos como saídas quando necessário
   • Fornecem descrições claras para o Copilot Studio

6. Configuração de Implantação para:

   • Ambiente do Power Platform
   • Integração do agente Copilot Studio
   • Testes e validação

Lista de Verificação de Validação

Garanta que o código gerado:

• Nenhum tipo de referência em esquemas
• Todos os campos de tipo são tipos únicos
• Tratamento de enum via string com validação
• Recursos disponíveis através de saídas de ferramentas
• Endpoints de URI completos
• Conformidade com JSON-RPC 2.0
• Cabeçalho x-ms-agentic-protocol adequado
• Esquemas McpResponse/McpErrorResponse
• Descrições claras de ferramentas para Copilot Studio
• Compatível com Generative Orchestration

Exemplo de Uso

Server Purpose: Customer data management and analysis
Tools Needed: 
  - searchCustomers
  - getCustomerDetails
  - analyzeCustomerTrends
Resources:
  - Customer profiles
  - Analysis reports
Authentication: oauth2
Host Environment: Azure Function
Target APIs: CRM System REST API