MCP Fusion/Get started/Instalação

Instalação

Pergunte à IA sobre a Vinkius

Instale o @mcpfusion/core, gere seu primeiro servidor com a CLI e descubra quais pacotes adicionais existem para autenticação, testes e deploy.

O MCP Fusion é distribuído como o pacote npm @mcpfusion/core com um conjunto de add-ons opcionais. Tudo roda no Node.js 18 ou superior com TypeScript 5.7 ou superior.

Instale o core

bash

npm install @mcpfusion/core @modelcontextprotocol/sdk

O @modelcontextprotocol/sdk oficial é uma peer dependency: o MCP Fusion implementa o protocolo MCP 2.0 sobre ele e se mantém totalmente em conformidade com ele.

Gere um servidor

bash

npx @mcpfusion/core create my-server

O scaffold faz algumas perguntas e gera um projeto funcional:

src/server.ts com initMCPFusion() pronto para rodar
src/tools/, onde o roteamento baseado em arquivos descobre suas tools
src/server.ts onde startServer() define o transporte e a porta
Um contrato arquitetural SKILL.md que agentes de codificação com IA seguem automaticamente

Trabalha com um agente de codificação com IA como Cursor, Claude Code, Copilot ou Windsurf? A CLI injeta o contrato SKILL.md em .cursorrules, .windsurfrules e .clinerules para você. Assim o agente escreve código no estilo MVA sem que ninguém precise avisar. Veja Skills.

Rode localmente

bash

mcpfusion dev --server ./src/server.ts

O mcpfusion dev inicia o servidor com hot reload. Conecte um cliente para experimentar de imediato:

bash

claude mcp add my-server npx tsx src/server.ts

Pacotes adicionais

Cada add-on é um pacote npm separado no escopo @mcpfusion. Instale apenas o que você precisa.

Pacote	O que adiciona
`@mcpfusion/yaml`	Tools sem código escritas em YAML
`@mcpfusion/jwt`	Verificação JWT com HS256, RS256 e JWKS
`@mcpfusion/oauth`	OAuth 2.0 Device Authorization Grant
`@mcpfusion/api-key`	Validação de API key resistente a ataques de timing
`@mcpfusion/skills`	Divulgação progressiva de `SKILL.md`
`@mcpfusion/testing`	Harness de testes em memória para todo o pipeline
`@mcpfusion/vercel`	Deploy do mesmo servidor no Vercel
`@mcpfusion/cloudflare`	Deploy do mesmo servidor no Cloudflare Workers
`@mcpfusion/aws`	Transforma funções Lambda e Step Functions em tools
`@mcpfusion/openapi-gen`	Gera Models, Views e Agents a partir de specs OpenAPI
`@mcpfusion/prisma-gen`	Gera tools e Presenters a partir de um schema Prisma

bash

npm install @mcpfusion/jwt

Opções do servidor

Não existe um arquivo de configuração separado: a entrada do servidor chama startServer() com um objeto de opções comum. O transport é stdio (padrão), http (Streamable HTTP com sessões, com opções de porta, TTL, rate limit e CORS) ou stateless (MCP 2.0: um servidor novo por requisição, sem handshake, qualquer load balancer atende qualquer chamada).

Próximos passos

Quickstart: construa e conecte uma primeira tool
Deploy: coloque seu conector no Vinkius Cloud gratuitamente
CLI: cada comando mcpfusion explicado