Suite de connecteurs MCP Power Platform

Générez des implémentations complètes de connecteurs personnalisés Power Platform avec intégration du protocole Model Context Protocol pour Microsoft Copilot Studio.

Capacités MCP dans Copilot Studio

Actuellement supportées :

• ✅ Tools : Fonctions que le LLM peut appeler (avec approbation de l'utilisateur)
• ✅ Resources : Données de type fichier que les agents peuvent lire (doivent être des outputs de tools)

Pas encore supportées :

• ❌ Prompts : Modèles pré-écrits (préparation pour support futur)

Génération de connecteurs

Créez un connecteur Power Platform complet avec :

Fichiers essentiels :

• apiDefinition.swagger.json avec x-ms-agentic-protocol: mcp-streamable-1.0
• apiProperties.json avec métadonnées de connecteur et authentification
• script.csx avec transformations C# personnalisées pour la gestion MCP JSON-RPC
• readme.md avec documentation du connecteur

Intégration MCP :

• Endpoint POST /mcp pour communication JSON-RPC 2.0
• Définitions de schémas McpResponse et McpErrorResponse
• Conformité aux contraintes de Copilot Studio (pas de types références, types uniques)
• Intégration de ressources comme outputs de tools (Resources et Tools supportés ; Prompts pas encore supportés)

Validation de schémas et résolution de problèmes

Validez les schémas pour la conformité à Copilot Studio :

• ✅ Pas de types références ($ref) dans les inputs/outputs de tools
• ✅ Valeurs de type uniques uniquement (pas ["string", "number"])
• ✅ Types primitifs : string, number, integer, boolean, array, object
• ✅ Ressources comme outputs de tools, pas entités séparées
• ✅ URIs complètes pour tous les endpoints

Problèmes courants et corrections :

• Tools filtrés → Supprimez les types références, utilisez des primitifs
• Erreurs de type → Types uniques avec logique de validation
• Ressources indisponibles → Incluez dans les outputs de tools
• Défaillances de connexion → Vérifiez l'en-tête x-ms-agentic-protocol

Variables de contexte

• Connector Name : [Nom d'affichage du connecteur]
• Server Purpose : [Ce que le serveur MCP doit accomplir]
• Tools Needed : [Liste des tools MCP à implémenter]
• Resources : [Types de ressources à fournir]
• Authentication : [none, api-key, oauth2, basic]
• Host Environment : [Azure Function, Express.js, etc.]
• Target APIs : [APIs externes à intégrer]

Modes de génération

Mode 1 : Connecteur nouveau complet

Générez tous les fichiers pour un connecteur MCP Power Platform nouveau à partir de zéro, incluant configuration de validation CLI.

Mode 2 : Validation de schéma

Analysez et corrigez les schémas existants pour la conformité à Copilot Studio avec paconn et outils de validation.

Mode 3 : Résolution de problèmes d'intégration

Diagnostiquez et résolvez les problèmes d'intégration MCP avec Copilot Studio en utilisant les outils de débogage CLI.

Mode 4 : Connecteur hybride

Ajoutez des capacités MCP à un connecteur Power Platform existant avec workflows de validation appropriés.

Mode 5 : Préparation à la certification

Préparez le connecteur pour la soumission de certification Microsoft avec métadonnées complètes et conformité de validation.

Mode 6 : Durcissement de sécurité OAuth

Implémentez une authentification OAuth 2.0 renforcée avec les meilleures pratiques de sécurité MCP et validation avancée de tokens.

Résultat attendu

1. apiDefinition.swagger.json

• Format Swagger 2.0 avec extensions Microsoft
• Endpoint MCP : POST /mcp avec en-tête de protocole approprié
• Définitions de schémas conformes (types primitifs uniquement)
• Définitions McpResponse/McpErrorResponse

2. apiProperties.json

• Métadonnées et branding du connecteur (iconBrandColor obligatoire)
• Configuration d'authentification
• Templates de politiques pour transformations MCP

3. script.csx

• Gestion des messages JSON-RPC 2.0
• Transformations request/response
• Logique de conformité au protocole MCP
• Gestion d'erreurs et validation

4. Guide d'implémentation

• Modèles d'enregistrement et d'exécution de tools
• Stratégies de gestion des ressources
• Étapes d'intégration de Copilot Studio
• Procédures de test et validation

Liste de contrôle de validation

Conformité technique

• [ ] x-ms-agentic-protocol: mcp-streamable-1.0 dans l'endpoint MCP
• [ ] Pas de types références dans aucune définition de schéma
• [ ] Tous les champs de type sont des types uniques (pas de tableaux)
• [ ] Ressources incluses comme outputs de tools
• [ ] Conformité JSON-RPC 2.0 dans script.csx
• [ ] URIs complètes dans tous les endpoints
• [ ] Descriptions claires pour les agents de Copilot Studio
• [ ] Authentification correctement configurée
• [ ] Templates de politiques pour transformations MCP
• [ ] Compatibilité avec orchestration générative

Validation CLI

• [ ] paconn validate : paconn validate --api-def apiDefinition.swagger.json passe sans erreurs
• [ ] pac CLI prêt : Connecteur peut être créé/mis à jour avec pac connector create/update
• [ ] Validation du script : script.csx passe la validation automatique lors du téléchargement pac CLI
• [ ] Validation du package : ConnectorPackageValidator.ps1 s'exécute avec succès

Exigences OAuth et sécurité

• [ ] OAuth 2.0 renforcé : OAuth 2.0 standard avec implémentation des meilleures pratiques de sécurité MCP
• [ ] Validation de tokens : Implémentez la validation d'audience de token pour prévenir les attaques de passthrough
• [ ] Logique de sécurité personnalisée : Validation renforcée dans script.csx pour conformité MCP
• [ ] Protection des paramètres de state : Paramètres de state sécurisés pour prévention CSRF
• [ ] Application HTTPS : Tous les endpoints de production utilisent HTTPS uniquement
• [ ] Pratiques de sécurité MCP : Implémentez la prévention des attaques de deputy confus dans OAuth 2.0

Exigences de certification

• [ ] Métadonnées complètes : settings.json avec informations produit et service
• [ ] Conformité de l'icône : Format PNG, dimensions 230x230 ou 500x500
• [ ] Documentation : Readme prêt pour certification avec exemples complets
• [ ] Conformité de sécurité : OAuth 2.0 renforcé avec pratiques de sécurité MCP, politique de confidentialité
• [ ] Flux d'authentification : OAuth 2.0 avec validation de sécurité personnalisée correctement configuré

Exemple d'utilisation

Mode: Complete New Connector
Connector Name: Customer Analytics MCP
Server Purpose: Customer data analysis and insights
Tools Needed:
  - searchCustomers: Find customers by criteria
  - getCustomerProfile: Retrieve detailed customer data
  - analyzeCustomerTrends: Generate trend analysis
Resources:
  - Customer profiles (JSON data)
  - Analysis reports (structured data)
Authentication: oauth2
Host Environment: Azure Function
Target APIs: CRM REST API