Créer et déployer votre propre serveur MCP sur Adios

Processus de compilation

Traitez le serveur MCP comme un petit backend que vous pouvez inspecter.

La première version doit rester simple et prévisible : un périmètre de processus clair, peu d’outils, une configuration prévisible et assez de journaux pour déboguer les appels clients.

Choisir le transport de production

Les serveurs MCP de bureau utilisent souvent stdio au départ. Un serveur MCP hébergé doit proposer un transport compatible HTTP, une route de santé et une URL HTTPS stable.

Définir des outils au périmètre précis

Commencez par quelques outils correspondant à des actions réelles du produit. Prévoyez pour chaque outil un schéma d’entrée clair, une validation, un délai d’expiration et un format d’erreur.

Garder les identifiants hors du code source

Stockez les clés des fournisseurs, les URL des bases de données, les secrets de webhooks et les secrets clients OAuth dans Adios Secrets, puis référencez-les dans adios.yaml.

Exécutez-le comme une API

Ajoutez les commandes de compilation et de démarrage ainsi que les contrôles de santé. Testez la route MCP en local, vérifiez les journaux et assurez-vous que des dépendances défaillantes font échouer le contrôle de disponibilité.

Déployer et connecter les clients

Déployez le serveur sur Adios, associez une route ou un domaine personnalisé et configurez les clients MCP compatibles pour utiliser l’URL de production.

Structure du projet

Séparez le code du protocole, les outils, l’authentification et la configuration de déploiement.

package.json

Dépendances d’exécution, scripts et adaptateur du SDK MCP.

src/server.ts

Serveur HTTP, adaptateur de transport MCP, outils et ressources.

src/tools/*.ts

Petits gestionnaires d’outils avec validation des entrées et délais d’expiration.

src/auth.ts

Vérifications facultatives par jeton bearer, OAuth ou requêtes signées.

scripts/healthcheck.js

Sonde de disponibilité utilisée par Adios.

adios.yaml

Compilation, démarrage, port, santé, région et références aux secrets.

adios.yaml

Déployez le serveur MCP avec des commandes d’exécution explicites.

Cet exemple suppose un serveur MCP Node ou TypeScript proposant un transport HTTP sur `PORT`. Suivez le même modèle pour Python, Go ou un autre environnement d’exécution.

Consulter la référence du manifeste Suivez le démarrage rapide

name: product-mcp-server
region: de

build_cmd: npm ci && npm run build
start_cmd: node dist/server.js

runtime:
  name: node@24
  port: 8080
  health_path: /healthz

env:
  MCP_AUTH_TOKEN: secret://MCP_AUTH_TOKEN
  DATABASE_URL: secret://DATABASE_URL
  PROVIDER_API_KEY: secret://PROVIDER_API_KEY

Boucle de développement

Développez en local, puis vérifiez le résultat via la route déployée.

Tests locaux des outils

Appelez chaque gestionnaire d'outils avec une entrée valide et non valide. Le serveur doit renvoyer des erreurs structurées, et non des traces de pile.

Aperçu sur Adios

Déployez un aperçu, vérifiez les journaux d’exécution et le point de terminaison de santé avant de connecter de vrais clients.

Mise en production

Associez la route définitive, renouvelez les secrets via Adios et suivez le même processus de déploiement pour les futurs changements d’outils.

FAQ

Questions sur les serveurs MCP personnalisés.

Mon serveur MCP hébergé doit-il utiliser stdio ?

Non pour l’hébergement en production. Stdio est utile pour les intégrations locales sur ordinateur, mais un serveur hébergé doit proposer un transport compatible HTTP et une route de santé accessibles via HTTPS.

Puis-je déployer un serveur MCP TypeScript ou Python ?

Oui. Adios exécute des processus applicatifs classiques de longue durée. Utilisez l’environnement d’exécution et la commande de démarrage nécessaires à votre serveur MCP, puis exposez le port configuré.

Comment protéger les outils MCP ?

Traitez les outils MCP comme des points de terminaison API. Validez les entrées, exigez des identifiants à portée limitée, définissez des délais d’expiration, évitez les jetons d’administration étendus et conservez les secrets hors du code source.

Quelle différence avec la page de la plateforme Adios MCP ?

Ce guide explique comment créer et déployer votre propre serveur MCP. La page /mcp présente l’utilisation d’Adios lui-même via son point de terminaison MCP.