Servidor MCP

O servidor MCP (Model Context Protocol) publica operações do motor do Aseptic como tools para clientes de IA (Claude Code, Claude Desktop, Cursor…). É a mesma superfície que o copiloto da app usa. As tools são geradas do registo de operações, por isso MCP e CLI não divergem.

Hoje publica 92 tools, 2 resources e 6 prompts de fluxo.

Superfície curada

Não é um despejo do registo (115 operações): a IA opera o laboratório —iniciar, testar, fazer mock, depurar— e edita o catálogo (micros, cenários, mocks, bibliotecas e ligações de BD). O que fica de fora são as definições da máquina —workspace, credenciais, arranque pessoal—, que são da pessoa, e o trânsito de ficheiros de catálogo entre máquinas. Nada se perde: o oculto continua em aseptic ops, no CLI e no control server.

Ligação por stdio (a habitual)

O cliente lança aseptic mcp como processo filho. Requer o motor compilado (npm run build:electron) e convém caminhos absolutos e um -p explícito (a pasta do projeto com .aseptic/).

Claude Code:

claude mcp add aseptic -- node C:\ferramentas\aseptic\bin\aseptic.js mcp -p C:\projetos\o-meu-projeto

Claude Desktop / Cursor (claude_desktop_config.json ou .cursor/mcp.json):

{
  "mcpServers": {
    "aseptic": {
      "command": "node",
      "args": ["C:\\ferramentas\\aseptic\\bin\\aseptic.js", "mcp", "-p", "C:\\projetos\\o-meu-projeto"]
    }
  }
}

Com o executável global (npm link), basta "command": "aseptic", "args": ["mcp", "-p", "..."].

Ligação por HTTP (motor vivo)

Com um motor vivo (a app aberta ou o daemon), o mesmo servidor está disponível por Streamable HTTP na rota /mcp do control server, para clientes que não lançam processos. O URL e o token saem de control.json; cada pedido leva Authorization: Bearer <token>.

O que publica

• Tools — 90, agrupadas por domínio (ciclo de vida do cenário, depuração, Docker, catálogo, git, bibliotecas, mocks…). Cada uma leva anotações readOnlyHint ou destructiveHint quando se aplica, para que o cliente decida o que executar sem confirmação.
• Resources — aseptic://guide (guia de operação para IAs, em markdown) e aseptic://status (snapshot JSON: versão, caminhos, motor vivo, cenário ativo e estado dos seus micros).
• Prompts — seis receitas de fluxo, uma por fase: preparar-entorno, levantar-y-probar, arreglar-y-reintentar, adoptar-escenario, mockear-dependencia e depurar-micro.

Modelo de execução

Igual ao CLI: se houver motor vivo, a tool executa-se contra ele (mesmo estado que a UI); se não, as tools sem estado correm in-proc. scenario_up_and_wait lança o daemon se faltar; os micros sobrevivem à sessão MCP (fechar o cliente de IA não os detém; para os parar, scenario_stop).

Acesso

Em projetos com início de sessão, o MCP exige a capacidade mcp (independente de cli). Sem ela, stdio termina com exit 5 e HTTP responde 403. Ver Capacidades.

Ver também

• Copiloto — a mesma superfície dentro da app.
• Control server · Comandos do CLI