Générateur de connecteur MCP Power Platform
Générez un connecteur personnalisé Power Platform complet avec intégration Model Context Protocol (MCP) pour Microsoft Copilot Studio. Ce prompt crée tous les fichiers nécessaires en suivant les normes de connecteur Power Platform avec support HTTP MCP streamable.
Instructions
Créez une implémentation de serveur MCP complet qui :
-
Utilise le modèle MCP Copilot Studio :
- Implémentez
x-ms-agentic-protocol: mcp-streamable-1.0 - Supportez le protocole de communication JSON-RPC 2.0
- Fournissez un endpoint HTTP streamable à
/mcp - Suivez la structure de connecteur Power Platform
- Implémentez
-
Exigences de conformité du schéma :
- PAS de types de référence dans les entrées/sorties des outils (filtrés par Copilot Studio)
- Valeurs de type unique uniquement (pas de tableaux de plusieurs types)
- Évitez les énumérations en entrée (interprétées comme string, pas enum)
- Utilisez les types primitifs : string, number, integer, boolean, array, object
- Assurez-vous que tous les endpoints retournent des URIs complètes
-
Composants MCP à inclure :
- Tools : Fonctions que le modèle de langage peut appeler (✅ Supporté dans Copilot Studio)
- Resources : Sorties de données de type fichier des outils (✅ Supporté dans Copilot Studio - doit être en sortie d'outil pour être accessible)
- Prompts : Modèles prédéfinis pour des tâches spécifiques (❌ Pas encore supporté dans Copilot Studio)
-
Structure d'implémentation :
/apiDefinition.swagger.json (schéma de connecteur Power Platform) /apiProperties.json (métadonnées de connecteur et configuration) /script.csx (transformations de code personnalisé et logique) /server/ (implémentation du serveur MCP) /tools/ (outils MCP individuels) /resources/ (gestionnaires de ressources MCP)
Variables de contexte
- Objectif du serveur : [Décrivez ce que le serveur MCP doit accomplir]
- Outils nécessaires : [Liste des outils spécifiques à implémenter]
- Ressources : [Types de ressources à fournir]
- Authentification : [Méthode auth : none, api-key, oauth2]
- Environnement d'hébergement : [Azure Function, Express.js, FastAPI, etc.]
- APIs cibles : [APIs externes à intégrer]
Sortie attendue
Générez :
-
apiDefinition.swagger.json avec :
- Bon
x-ms-agentic-protocol: mcp-streamable-1.0 - Endpoint MCP à POST
/mcp - Définitions de schéma conformes (pas de types de référence)
- Définitions McpResponse et McpErrorResponse
- Bon
-
apiProperties.json avec :
- Métadonnées et branding du connecteur
- Configuration d'authentification
- Modèles de politique si nécessaire
-
script.csx avec :
- Code C# personnalisé pour les transformations requête/réponse
- Logique de gestion des messages JSON-RPC MCP
- Fonctions de validation et de traitement des données
- Capacités de gestion des erreurs et journalisation
-
Code du serveur MCP avec :
- Gestionnaire de requêtes JSON-RPC 2.0
- Enregistrement et exécution des outils
- Gestion des ressources (en sortie d'outil)
- Gestion d'erreur appropriée
- Vérifications de compatibilité Copilot Studio
-
Outils individuels qui :
- Acceptent uniquement des entrées de type primitif
- Retournent des sorties structurées
- Incluent les ressources en sortie si nécessaire
- Fournissent des descriptions claires pour Copilot Studio
-
Configuration de déploiement pour :
- Environnement Power Platform
- Intégration d'agent Copilot Studio
- Test et validation
Liste de contrôle de validation
Assurez-vous que le code généré :
- [ ] Pas de types de référence dans les schémas
- [ ] Tous les champs type sont des types simples
- [ ] Gestion enum via string avec validation
- [ ] Ressources disponibles via sorties d'outil
- [ ] Endpoints URI complets
- [ ] Conformité JSON-RPC 2.0
- [ ] En-tête x-ms-agentic-protocol approprié
- [ ] Schémas McpResponse/McpErrorResponse
- [ ] Descriptions d'outils claires pour Copilot Studio
- [ ] Compatible avec Generative Orchestration
Exemple d'utilisation
Objectif du serveur : Gestion et analyse des données client
Outils nécessaires :
- searchCustomers
- getCustomerDetails
- analyzeCustomerTrends
Ressources :
- Profils client
- Rapports d'analyse
Authentification : oauth2
Environnement d'hébergement : Azure Function
APIs cibles : API REST système CRM