1MCP: agregar vários servidores MCP com 1mcp serve

Para quem

1MCP é para quem quer juntar vários servidores MCP num runtime. Oficialmente: 1MCP is the unified MCP runtime, 1mcp serve aggregates your MCP servers. CLI mode dá a Codex, Claude, Cursor e similar tool-using agents um fluxo proxy mais fino.

Serve-lhe melhor se puder instalar um pacote npm em global e aceitar adicionar primeiro context7 segundo o exemplo oficial, depois arrancar 1mcp serve. A primeira tentativa é descoberta só de leitura: chame 1mcp instructions.

Não serve se ainda não tiver Node/npm e quiser saltar a instalação e inventar backends, ou se na primeira tentativa quiser 1mcp run de uma ferramenta não verificada. As notas oficiais não dão JSON de exemplo para --args.

Primeira tentativa em 3 minutos

Pré-requisito: esta máquina tem npm. O caminho principal oficial são estes três passos. Não mude de instalador:

npm install -g @1mcp/agent
1mcp mcp add context7 -- npx -y @upstash/context7-mcp
1mcp serve

A localização da instalação é @1mcp/agent global. Quando o serve estiver de pé, os clientes HTTP podem ligar com o fragmento oficial a: http://127.0.0.1:3050/mcp?app=cursor

A primeira chamada usa 1mcp instructions. Pertence a CLI mode for progressive discovery, para ir buscar notas de uso, e é de menor risco do que 1mcp run. Não passe parâmetros que não aparecem.

Sucesso: volta um texto de instructions que diz como continuar inspect ou run. Isto levanta um runtime de agregação nesta máquina e, segundo o exemplo, vai buscar @upstash/context7-mcp via npx. Não é «sem rede nem processo local».

Se o serve não arrancar, confirme primeiro que o comando 1mcp global funciona e que o mcp add já adicionou context7. Não trate 1mcp cli-setup --codex como a única instalação.

Casos de uso

Caso 1: primeiro ler as notas de descoberta. Com o serve já a correr, execute 1mcp instructions. Use o texto devolvido para confirmar que o canal de descoberta CLI funciona. Não passe --args neste passo.

Caso 2: ver o que há dentro de um backend. Oficial: 1mcp inspect <server> e 1mcp inspect <server>/<tool>. Contra o context7 do exemplo oficial, execute 1mcp inspect context7. Sucesso: vê a informação de ferramentas desse server. Só depois de o inspect lhe ter dado um nome de ferramenta real deve considerar 1mcp run <server>/<tool> --args. As notas originais não dão uma amostra JSON. Não faça run na primeira tentativa.

Limites de uso

1mcp serve agrega os servidores MCP que adiciona e oferece HTTP em 127.0.0.1:3050. app=cursor é só a cadeia de consulta de exemplo oficial. Não obriga a esse cliente.

1mcp cli-setup --codex é outra cablagem para CLI mode, não um segundo canal de instalação de pacote. 1mcp run executa de facto uma ferramenta backend. Os efeitos colaterais dependem do servidor agregado. Não há um caminho de anulação unificado. Não invente nomes de backend além de instructions, inspect, run e context7 do exemplo.