Créer ou réutiliser des serveurs MCP

Utilisez la décision du serveur MCP de votre plan de composants pour fournir des outils ou des ressources hébergés à distance. Le serveur MCP en cours d’exécution reste séparé du package de plug-ins. Vous devez donc implémenter ou confirmer l’exécution à distance et la connexion prise en charge à l’expérience Microsoft cible.

Réutiliser un serveur MCP

Avant de créer un serveur :

  1. Identifiez un serveur MCP approuvé qui expose les outils ou ressources requis.
  2. Examinez les définitions de l’outil, les entrées, les sorties, les erreurs, les annotations et le comportement de confirmation.
  3. Confirmez que son transport, son modèle d’authentification et ses fonctionnalités de protocole sont pris en charge par l’expérience Microsoft cible.
  4. Confirmez le propriétaire du serveur, le point de terminaison, la version, la disponibilité, la gestion des données, la prise en charge et le processus de modification.
  5. Obtenez l’accès et configurez la connexion de développement ou de test.
  6. Testez les scénarios de découverte, d’authentification, d’appel et d’échec du représentant.

Le référencement d’un serveur MCP ne transfère pas la responsabilité de son exploitation. Enregistrez le propriétaire du service et le contrat de support avant de le réutiliser.

Créer et exploiter un serveur MCP

Créer un nouveau serveur MCP lorsqu’aucun serveur approuvé ne répond à la condition.

  1. Implémenter uniquement les outils et les ressources requis par le plan de composants.
  2. Définissez des noms clairs, des descriptions, des entrées, des sorties, des erreurs et des annotations de sécurité.
  3. Implémentez l’authentification, l’autorisation, l’accès aux données et le comportement de privilège minimum.
  4. Configurez l’hébergement, la mise en réseau, les secrets, la journalisation, la surveillance, la mise à l’échelle et la réponse aux incidents.
  5. Versionnez le comportement du protocole et les attentes en matière de compatibilité des documents.
  6. Testez le serveur indépendamment avant de le connecter à une expérience Microsoft.

GitHub Copilot peut vous aider avec le code serveur, les schémas, les tests et les modifications de dépôt. Il ne fournit pas le runtime MCP, l’hébergement, l’authentification ou la connexion Microsoft 365 par lui-même.

Connecter le serveur

Utilisez l’intégration prise en charge par l’outil de développement sélectionné et l’expérience cible.

Remarque

Utilisez WIQD pour créer un plug-in qui référence un serveur MCP distant. Pour une configuration manuelle via le agentConnectors tableau dans le manifeste de l’application Microsoft 365, consultez Configurer des serveurs MCP distants pour les plug-ins Microsoft 365 Copilot. Cette configuration diffère du manifeste du plug-in MCP utilisé pour les actions d’agent déclaratif. Le support dépend de l’expérience cible.

Approche de développement Commencer par
Outils de développement Work IQ (recommandé pour les scénarios pro-code pris en charge) Créer un plugin avec Work IQ Dev Tools ; pour une action d’agent, utilisez le workflow d’action de l’agent WIQD
Projet d’agent déclaratif existant utilisant Agents Toolkit Procédure pas à pas d’intégration MCP basée sur Toolkit
Copilot Studio Documentation de Microsoft Copilot Studio
Réponse MCP interactive Ajouter des applications MCP aux agents déclaratifs
Enregistrement du serveur MCP à distance BYO avec l’interface de ligne de commande de l’Agent 365 Enregistrer un serveur MCP distant dans les outils de l’agent

Important

La route MCP BYO DE CLI d’Agent 365 est en version préliminaire et utilise un modèle d’inscription et d’administration distinct d’un plug-in MCP empaqueté pour un agent déclaratif Microsoft 365. Les clients pris en charge documentés sont Copilot Studio, Visual Studio Code, Claude Code et GitHub Copilot CLI. Les agents déclaratifs Microsoft 365 ne sont pas pris en charge par cette voie. Les administrateurs utilisent les outils de l’agent pour examiner, approuver, approuver, consentir à, bloquer et surveiller le serveur inscrit.

Outils de développement Work IQ

La wiqd plugin add connector commande ajoute un connecteur MCP distant à un package de plug-in WIQD. La configuration requise du serveur documentée est la suivante :

  • HTTPS avec TLS 1.2 ou version ultérieure.
  • Transport HTTP diffusable en continu à l’aide de JSON-RPC 2.0.
  • Prise en charge de tools/list et tools/call.
  • Les appels d’outil qui se terminent en moins de 30 secondes.

Génération de modèles automatique WIQD par rapport à la version de manifeste 1.29, où mcpToolDescription est facultatif. Si vous incluez un fichier de description d’outil, transmettez son chemin d’accès par rapport à appPackage avec wiqd plugin add connector --tool-description <relative-file-path> avec les options de connecteur requises. Le fichier référencé doit être inclus dans le ZIP. Pour connaître le comportement actuel de découverte de Cowork et les exigences de package, consultez Créer des plug-ins pour Copilot Cowork.

Pour l’authentification OAuth ou par clé API, commencez par inscrire les informations d’identification et ajoutez uniquement son identificateur de référence au package. N’écrivez pas de clés secrètes client, de clés API ou de jetons dans le manifeste. Voir la référence de création de plug-in WIQD.

Pour l’itinéraire plugin-package WIQD, configurez l’authentification et la découverte d’outils dans le manifeste de l’application Microsoft 365. Si vous ajoutez plutôt le serveur en tant qu’action MCP à un agent déclaratif, utilisez l’authentification des actions de l’agent et la découverte dynamique ou des outils épinglés pour l’agent. Suivez les exigences de l’intégration sélectionnée au lieu de copier la configuration entre les modèles de manifeste.

Confirmer que la fonctionnalité MCP fonctionne

Le serveur MCP et sa connexion sont prêts pour l’intégration lorsque :

  • Le point de terminaison est disponible dans l’environnement de développement ou de test.
  • Les outils ou ressources nécessaires peuvent être découverts par l’expérience cible.
  • Les opérations représentatives retournent les résultats structurés attendus.
  • L’authentification, l’autorisation, le consentement et les autorisations fonctionnent comme prévu.
  • Le comportement de confirmation, de délai d’attente, de service indisponible, d’entrée non valide et d’échec partiel est compréhensible.
  • Les journaux et la surveillance fournissent suffisamment d’informations pour diagnostiquer les échecs.
  • Le propriétaire du serveur, la version, le point de terminaison, l’hébergement, les dépendances, les limitations et les preuves de test sont enregistrés.

Utilisez le MCP local et le débogage d’API lorsque le serveur n’est pas accessible publiquement pendant le développement.

Continuez avec tous les autres éléments du plan. Lorsqu’ils sont terminés, intégrez et testez vos composants.