Crea y despliega tu propio servidor MCP en Adios

Proceso de compilación

Trata el servidor MCP como un backend pequeño que puedas inspeccionar.

La primera versión debe ser sencilla y predecible: límites claros del proceso, un pequeño conjunto de herramientas, una configuración predecible y registros suficientes para depurar las llamadas de los clientes.

Elige el transporte de producción

Los servidores MCP de escritorio suelen empezar con stdio. Un servidor MCP alojado debe ofrecer un transporte compatible con HTTP, una ruta de estado y una URL HTTPS estable.

Define herramientas con funciones acotadas

Empieza con un pequeño conjunto de herramientas que correspondan a acciones reales del producto. Define para cada herramienta un esquema de entrada claro, validaciones, un tiempo de espera máximo y un formato de error.

Mantén las credenciales fuera del código fuente

Guarda las claves de proveedores, las URL de bases de datos, los secretos de webhooks y los secretos de cliente de OAuth como secretos de Adios y después haz referencia a ellos desde adios.yaml.

Ejecútalo como una API

Añade comandos de compilación, inicio y comprobación de estado. Prueba la ruta MCP en local, comprueba los registros y asegúrate de que los fallos de las dependencias hagan fallar la comprobación de disponibilidad.

Despliega y conecta los clientes

Despliega el servidor en Adios, asocia una ruta o un dominio personalizado y configura los clientes MCP compatibles para que utilicen la URL de producción.

Estructura del proyecto

Mantén separados el código del protocolo, las herramientas, la autenticación y la configuración de despliegue.

package.json

Dependencias del entorno de ejecución, scripts y adaptador del SDK de MCP.

src/server.ts

Servidor HTTP, adaptador de transporte MCP, herramientas y recursos.

src/tools/*.ts

Manejadores de herramientas pequeños con validación de entradas y tiempos de espera máximos.

src/auth.ts

Comprobaciones opcionales con tokens bearer, OAuth o solicitudes firmadas.

scripts/healthcheck.js

Sonda de disponibilidad utilizada por Adios.

adios.yaml

Referencias de compilación, inicio, puerto, estado, región y secretos.

adios.yaml

Despliega el servidor MCP con comandos explícitos para el entorno de ejecución.

Este ejemplo parte de un servidor MCP en Node o TypeScript que ofrece un transporte HTTP en `PORT`. Usa el mismo patrón para Python, Go u otro entorno de ejecución.

Consulta la referencia del manifiesto Sigue la guía de inicio rápido

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

Ciclo de desarrollo

Compila en local y después verifica el resultado a través de la ruta desplegada.

Pruebas de herramientas locales

Llama a cada manejador de herramientas con entradas válidas e inválidas. El servidor debe devolver errores estructurados, no trazas de la pila.

Vista previa en Adios

Despliega una vista previa, comprueba los registros del entorno de ejecución y verifica el endpoint de estado antes de conectar clientes reales.

Puesta en producción

Asocia la ruta definitiva, rota los secretos a través de Adios y aplica el mismo flujo de despliegue a los cambios futuros de las herramientas.

FAQ

Preguntas sobre servidores MCP personalizados.

¿Mi servidor MCP alojado debería usar stdio?

No para el alojamiento en producción. Stdio es útil para las integraciones locales de escritorio, pero un servidor alojado debe ofrecer un transporte compatible con HTTP y una ruta de estado protegidos por HTTPS.

¿Puedo desplegar un servidor MCP escrito en TypeScript o Python?

Sí. Adios ejecuta procesos de aplicación normales y de larga duración. Usa el entorno de ejecución y el comando de inicio que necesita tu servidor MCP y después expón el puerto configurado.

¿Cómo debo proteger las herramientas MCP?

Trata las herramientas MCP como endpoints de API. Valida las entradas, exige credenciales con permisos acotados, establece tiempos de espera máximos, evita los tokens de administrador con permisos amplios y mantén los secretos fuera del código fuente.

¿En qué se diferencia de la página de la plataforma MCP de Adios?

Esta guía explica cómo crear y desplegar tu propio servidor MCP. La página /mcp explica cómo usar Adios a través de su endpoint MCP.