Microsoft 365 Copilot et Copilot Studio¶
Microsoft 365 Copilot ne lit pas de fichier mcp.json local. La voie la plus simple et supportée consiste à déclarer le serveur MCP Canopsis comme outil d’un agent Copilot Studio. Le flux "Agent 365 BYO" (Bring Your Own), à l’échelle du tenant, est en préversion et nécessite une approbation administrateur.
Dans les exemples ci-dessous, MCP_URL désigne l’URL publique complète du serveur et CANOPSIS_AUTHKEY une authkey Canopsis dédiée (voir Sécurité et audit). Ne committez jamais une authkey en clair.
Références officielles :
- Connect Copilot Studio to an existing MCP server
- Extend a Copilot Studio agent with MCP
- Microsoft 365 BYO MCP server registration
Accessibilité réseau
Le point d’accès MCP Canopsis doit être joignable depuis Microsoft en HTTPS avec un certificat de confiance. localhost et les adresses privées ne peuvent pas être atteintes par Copilot Studio.
Configuration directe dans Copilot Studio¶
- Ouvrez Copilot Studio et créez ou sélectionnez un agent.
- Activez Generative orchestration pour l’agent.
- Ouvrez Tools, puis Add a tool > New tool > Model Context Protocol.
- Renseignez :
- Server name :
Canopsis - Description : Read and manage Canopsis alarms through MCP
- Server URL :
MCP_URL(URL publique) - Sélectionnez l’authentification API key.
- Sélectionnez Header, avec le nom d’en-tête
Authorization. - Sélectionnez Create, puis Create a new connection.
- Pour la valeur de la clé, indiquez l’authkey Canopsis. Le serveur accepte aussi bien la valeur brute que
Bearer CANOPSIS_AUTHKEY: utilisez la valeur brute si le connecteur ne permet pas d’ajouter le préfixe. - Sélectionnez Add to agent.
- Depuis la page Tools de l’agent, ouvrez le serveur MCP Canopsis et désactivez les outils de mutation que l’agent ne doit pas utiliser. Pour un déploiement en lecture seule, désactivez les cinq outils de mutation actuels.
- Testez dans le panneau de test de l’agent, puis publiez après avoir vérifié ses permissions et sa politique de données.
Ressources MCP et Copilot Studio
Copilot Studio peut découvrir les tools et resources MCP, mais son intégration actuelle des resources exige qu’une ressource soit renvoyée comme sortie d’un tool. Les lectures d’alarme Canopsis sont aujourd’hui exposées comme des resources MCP, pas comme des tools de lecture : elles ne sont donc pas forcément orchestrables directement par Copilot Studio. Les tools de mutation restent, eux, disponibles. Si des agents Microsoft 365 doivent pouvoir consulter des alarmes de façon autonome, il faudrait exposer côté serveur des tools de lecture équivalents aux resources actuelles.
Configuration gouvernée par le tenant (Agent 365, préversion)¶
À réserver aux organisations qui exigent une approbation et une observabilité centralisées.
- Installez le CLI Agent 365 (version 1.1.165-preview ou ultérieure) et provisionnez son principal de service.
- Assurez-vous que le point d’accès MCP est joignable publiquement en HTTPS.
- Enregistrez le serveur avec une authentification par clé API en en-tête, en ne déclarant que les tools qui doivent être disponibles :
a365 develop-mcp register-external-mcp-server \
--server-name "Canopsis" \
--server-url "MCP_URL" \
--publisher "YOUR_ORGANIZATION" \
--description "Manage Canopsis alarms" \
--auth-type APIKey \
--api-key-location Header \
--api-key-name Authorization \
--tools "create_alarm,ack_alarm,comment_alarm,snooze_alarm,associate_ticket_to_alarm"
- Demandez à un administrateur IA ou un administrateur global d’ouvrir Microsoft 365 admin center > Agents > Tools > Requests, de vérifier les tools déclarés, d’approuver la demande et de donner son consentement.
- Comptez jusqu’à 30 minutes avant que le serveur n’apparaisse dans Copilot Studio.
- Dans Copilot Studio, ouvrez l’agent, sélectionnez Tools > MCP Server, choisissez
Canopsis, puis complétez la connexion avec l’authkey Canopsis.
Ce flux BYO est en préversion, et les agents déclaratifs Microsoft 365 ne sont pas actuellement une surface client MCP BYO supportée : utilisez Copilot Studio.