Crie e implante seu próprio servidor MCP no Adios

Caminho de compilação

Trate o servidor MCP como um backend pequeno que pode ser inspecionado.

A primeira versão deve ser simples e previsível: um limite claro de processo, poucas ferramentas, configuração previsível e logs suficientes para depurar chamadas dos clientes.

Escolha o transporte de produção

Servidores MCP locais costumam usar stdio. Um servidor MCP hospedado deve expor um transporte compatível com HTTP, uma rota de saúde e uma URL HTTPS estável.

Defina ferramentas com escopo restrito

Comece com um pequeno conjunto de ferramentas que correspondam a ações reais do produto. Dê a cada ferramenta um schema de entrada claro, validação, timeout e formato de erro.

Mantenha as credenciais fora do código-fonte

Armazene chaves de provedores, URLs de bancos de dados, secrets de webhooks e secrets de clientes OAuth como secrets do Adios. Depois, referencie-os em adios.yaml.

Execute como uma API

Adicione comandos de compilação, inicialização e saúde. Teste a rota MCP localmente, consulte os logs e confirme que dependências não saudáveis fazem a verificação de prontidão falhar.

Implantar e conectar clientes

Implante o servidor no Adios, vincule uma rota ou domínio personalizado e configure os clientes MCP compatíveis para usar a URL de produção.

Estrutura do projeto

Mantenha o código do protocolo, as ferramentas, a autenticação e a configuração de implantação separadas.

package.json

Dependências do ambiente de execução, scripts e adaptador do SDK MCP.

src/server.ts

Servidor HTTP, adaptador de transporte MCP, ferramentas e recursos.

src/tools/*.ts

Pequenos handlers de ferramentas com validação de entrada e timeouts.

src/auth.ts

Verificações opcionais de token bearer, OAuth ou solicitações assinadas.

scripts/healthcheck.js

Sonda de prontidão usada pelo Adios.

adios.yaml

Compilação, inicialização, porta, saúde, região e referências a secrets.

adios.yaml

Implante o servidor MCP com comandos explícitos do ambiente de execução.

Este exemplo pressupõe um servidor MCP em Node ou TypeScript que expõe um transporte HTTP em `PORT`. Use o mesmo padrão para Python, Go ou outro ambiente de execução.

Leia a referência do manifesto Siga o guia 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 desenvolvimento

Crie localmente e depois verifique pela rota implantada.

Testes de ferramentas locais

Chame cada handler de ferramenta com entradas válidas e inválidas. O servidor deve retornar erros estruturados, não stack traces.

Prévia no Adios

Implante uma prévia, consulte os logs do ambiente de execução e verifique o endpoint de saúde antes de conectar clientes reais.

Implantação em produção

Vincule a rota final, faça a rotação de secrets pelo Adios e mantenha as futuras alterações de ferramentas no mesmo fluxo de implantação.

FAQ

Perguntas sobre servidores MCP personalizados.

Meu servidor MCP hospedado deve usar stdio?

Não para hospedagem em produção. Stdio é útil para integrações locais em aplicativos desktop, mas um servidor hospedado deve expor um transporte compatível com HTTP e uma rota de saúde protegidos por HTTPS.

Posso implantar um servidor MCP em TypeScript ou Python?

Sim. O Adios executa processos comuns de aplicativos de longa duração. Use o ambiente de execução e o comando de inicialização necessários ao servidor MCP e exponha a porta configurada.

Como devo proteger as ferramentas MCP?

Trate ferramentas MCP como endpoints de API. Valide entradas, exija credenciais com escopo restrito, defina timeouts, evite tokens amplos de administrador e mantenha secrets fora do código-fonte.

Qual é a diferença em relação à página da plataforma Adios MCP?

Este guia trata da criação e implantação do seu próprio servidor MCP. A página /mcp explica como usar a própria plataforma Adios pelo endpoint Adios MCP.