MCP Fusion/Reference/CLI
CLI
Cada comando do mcpfusion explicado: scaffold, dev, yaml, inspect, lock, deploy, remote e token, do primeiro scaffold à hospedagem gratuita no Vinkius Cloud.
A CLI mcpfusion cobre todo o ciclo de vida de um conector: scaffold, desenvolvimento, inspeção, lock e deploy. Esta página é a referência; cada comando aponta para a página que explica o conceito por trás dele.
Comandos
| Comando | O que faz |
|---|---|
mcpfusion create my-server | Cria a estrutura de um novo projeto, incluindo SKILL.md e arquivos de regras para agentes |
mcpfusion dev --server ./src/server.ts | Roda localmente com hot reload |
mcpfusion yaml dev | Roda um toolset YAML sem código com @mcpfusion/yaml |
mcpfusion inspect | Dashboard TUI em tempo real para um servidor em execução |
mcpfusion lock | Gera o capability lockfile |
mcpfusion lock --check ./dist/server.js | Portão de CI: falha se a superfície divergir |
mcpfusion deploy | Empacota e hospeda na Vinkius Edge, de graça |
mcpfusion remote --server-id <id> --token <token> | Vincula um conector implantado ao seu projeto |
mcpfusion token <token> | Guarda um token de conexão para a configuração do cliente |
Opções de scaffold
npx @mcpfusion/core create my-server \
--transport stdio \
--vector prisma \
--target vercel \
--testing| Flag | Valores | Efeito |
|---|---|---|
--transport | stdio, http, stateless | Como os clientes conversam com o servidor localmente |
--vector | vanilla, prisma, n8n, openapi, oauth | Integração inicial para o scaffold |
--target | vercel, cloudflare | Já prepara o adapter correspondente, veja Self hosting |
--testing / --no-testing | boolean | Inclui o harness @mcpfusion/testing |
--yes | boolean | Aceita todos os padrões |
Inspect
mcpfusion inspectinspect se conecta a um servidor em execução e transmite um dashboard ao vivo: tools listadas, chamadas chegando, latências, erros. Ele usa um canal fora de banda, porque o transporte stdio pertence ao cliente MCP e não pode ser poluído. É a forma mais rápida de observar a saída de um Presenter enquanto um cliente conversa com seu servidor.
Deploy e além
mcpfusion deploy
mcpfusion remote --server-id a1b2c3 --token vk_live_…
mcpfusion token vk_live_…deploy é o caminho de hospedagem gratuita descrito em Deploy. remote lembra qual conector implantado pertence a este projeto, então deploys posteriores não precisam de argumentos. token mantém o token de conexão local para a configuração do cliente.
Coloque mcpfusion lock --check no CI antes de mcpfusion deploy. O lockfile prova que a superfície que você testou é a superfície que você publica. Veja Governance.
Próximos passos
- Installation: como obter a CLI e os pacotes
- Deploy: o que o deploy realmente provisiona
- Testing: o outro portão de CI
