Créer un paquet MCP distant
Création depuis le code source : ces commandes nécessitent la compilation où la création est activée. Elles ne figurent pas dans l’installateur actuel.
Choisissez MCP distant si le serveur existe déjà et si le paquet doit décrire la connexion de l’agent. La création enregistre l’URL sans la contacter. Avant de transmettre le paquet, vous devez connaître le transport et les exigences d’authentification du service.
Indiquez explicitement le point de terminaison
https://mcp.example.com/mcp est un exemple de documentation. Remplacez-le par le véritable point de terminaison MCP de votre service. La commande accepte l’URL comme configuration ; elle ne vérifie ni que l’adresse propose MCP ni que votre compte peut l’utiliser.
agentplugins author init ./docs-service \
--template mcp-remote \
--name docs-service \
--description 'Connect to the team documentation MCP service' \
--url https://mcp.example.com/mcpLa destination doit être absente, sous un dossier parent existant. Le modèle exige une URL HTTPS absolue, ou HTTP sur l’interface de bouclage. Il n’accepte pas d’identifiants, de fragments ni de paramètres d’URL non résolus en entrée. N’insérez pas de mot de passe dans l’URL.
Comprenez les fichiers
docs-service/
plugin.json
mcp.json
README.md
.gitignoreLe manifeste racine définit l’identité du paquet. mcp.json décrit le serveur sous mcpServers ; ce modèle utilise type: streamable-http et l’URL indiquée. Il ne génère pas de serveur et n’ajoute pas de Skill. Choisissez un paquet hybride si vous avez aussi besoin de consignes sur l’emploi de ses outils.
Examinez le README et décrivez le rôle du service, les prérequis de compte et les instructions d’authentification. Gardez les secrets hors du paquet. Une URL dans un fichier conforme ne prouve pas que le service fonctionne.
Vérifiez la configuration et les cibles
agentplugins author validate ./docs-service
agentplugins author inspect ./docs-service --target codex,claude
agentplugins author test ./docs-service
agentplugins author compat ./docs-service --target codex,claude
agentplugins author doctor ./docs-serviceinspect affiche les composants et les exigences non résolues. compat évalue la prise en charge statique des adaptateurs des clients choisis. Ces commandes n’exigent pas leur installation. doctor ne contacte pas le service. Pour une connexion MCP explicite depuis le code source, consultez les vérifications d’exécution ; un serveur distant nécessite --allow-network.
Indiquez le travail restant
Les preuves statiques doivent identifier le transport et les clients visés. L’installateur destinataire évalue encore sa propre politique et fournit les instructions d’activation. Une connexion au compte, une approbation d’accès ou une nouvelle session peuvent être nécessaires. La découverte et les appels d’outils à l’exécution demandent des preuves distinctes.
Si une vérification statique échoue, corrigez d’abord la configuration enregistrée. Si le service devient inaccessible ensuite, examinez le service ou la connexion du client ; un nouveau test statique réussi ne démontre pas la connectivité.
Poursuivez avec l’interprétation des rapports et la transmission au planificateur.