1MCP Agent (MCP server) — Casos de uso, Instalar & Demo ao vivo

Por que usar

Principais recursos

Agrega qualquer número de servidores MCP stdio / SSE / HTTP em um só
Prefixo no nome das tools evita colisões entre servidores
Recarga a quente da configuração — sem reiniciar o cliente ao adicionar/remover
Ciclo de vida por servidor: iniciar/parar/reiniciar servidores individualmente
Health checks + auto-restart para servidores instáveis

Demo ao vivo

Como fica na prática

onemcp-agent.replay ▶ pronto

0/0

Instalar

Escolha seu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "onemcp-agent": {
      "command": "npx",
      "args": [
        "-y",
        "@1mcp/agent"
      ]
    }
  }
}

Abra Claude Desktop → Settings → Developer → Edit Config. Reinicie após salvar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "onemcp-agent": {
      "command": "npx",
      "args": [
        "-y",
        "@1mcp/agent"
      ]
    }
  }
}

Cursor usa o mesmo esquema mcpServers que o Claude Desktop. Config de projeto vence a global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "onemcp-agent": {
      "command": "npx",
      "args": [
        "-y",
        "@1mcp/agent"
      ]
    }
  }
}

Clique no ícone MCP Servers na barra lateral do Cline, depois "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "onemcp-agent": {
      "command": "npx",
      "args": [
        "-y",
        "@1mcp/agent"
      ]
    }
  }
}

Mesmo formato do Claude Desktop. Reinicie o Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "onemcp-agent",
      "command": "npx",
      "args": [
        "-y",
        "@1mcp/agent"
      ]
    }
  ]
}

O Continue usa um array de objetos de servidor em vez de um map.

~/.config/zed/settings.json

{
  "context_servers": {
    "onemcp-agent": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@1mcp/agent"
        ]
      }
    }
  }
}

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

claude mcp add onemcp-agent -- npx -y @1mcp/agent

Uma linha só. Verifique com claude mcp list. Remova com claude mcp remove.

Casos de uso

Usos do mundo real: 1MCP Agent

Consolidar mais de 20 servidores MCP atrás de um único endpoint

👤 Power users com muitos MCPs configurados ⏱ ~25 min intermediate

Quando usar: Seu claude_desktop_config.json tem 20+ entradas e adicionar/remover servidores é doloroso.

Pré-requisitos

1mcp instalado — npx -y @1mcp/agent (ou instalação persistente via documentação)

Fluxo

Mover servidores existentes para a config do 1mcp

Use onemcp-agent. Convert my current MCP client config into a 1mcp config file with each server prefixed by its name.✓ Copiado

→ 1mcp.config.json com todos os servidores + prefixos
Apontar o cliente para o 1mcp

Replace my client's MCP config with a single entry pointing at 1mcp; keep a backup.✓ Copiado

→ Cliente agora vê um servidor; tools listadas com prefixos
Adicionar um novo servidor a quente

Add the new arxiv MCP to 1mcp config and reload — without restarting Claude Desktop.✓ Copiado

→ Novas tools aparecem na próxima atualização de list_tools

Resultado: Fonte única e gerenciável de verdade para todos os servidores MCP; iteração mais rápida.

Armadilhas

Nomes de tools ficam longos com o prefixo — Use aliases curtos por servidor (gh, fs, pg) em vez de nomes completos

Executar uma stack MCP compartilhada pela equipe em um servidor de desenvolvimento

👤 Times de desenvolvimento pequenos com infraestrutura compartilhada ⏱ ~45 min advanced

Quando usar: Você quer que todos no time compartilhem os mesmos servidores MCP validados + segredos, sem duplicar configurações.

Pré-requisitos

Host acessível — Execute o 1mcp em um servidor de desenvolvimento expondo transport SSE/HTTP com autenticação

Fluxo

Centralizar a configuração

Configure 1mcp on the dev box with our team's MCP set + shared auth tokens. Expose via authenticated SSE.✓ Copiado

→ Stack rodando; endpoint SSE exige bearer token
Distribuir uma configuração de cliente

Generate per-developer client snippets pointing to the shared SSE URL with their personal bearer.✓ Copiado

→ Um snippet por desenvolvedor

Resultado: O time tem a frota MCP validada sem cada pessoa gerenciar 20 configurações.

Armadilhas

Host único = ponto único de falha — Documente fallback para configuração local; ou execute réplicas atrás de um load balancer

Isolar um MCP não confiável atrás do 1mcp

👤 Usuários preocupados com segurança experimentando MCPs da comunidade ⏱ ~30 min advanced

Quando usar: Você quer testar um MCP de terceiros mas não quer dar acesso ao seu ambiente completo ou ao seu filesystem.

Fluxo

Executar o 1mcp em container

Set up 1mcp in a Docker container with minimal env; mount only ./scratch/. Add the untrusted MCP under a 'sandbox' prefix.✓ Copiado

→ Container rodando; apenas tools sandbox/ visíveis do MCP sandbox
Usar para uma tarefa

Run the experimental task only with sandbox__ tools.✓ Copiado

→ Tarefa concluída; nada escapou do container

Resultado: Testar servidores não confiáveis sem dar-lhes as chaves do reino.

Armadilhas

Esquecer que o MCP ainda pode acessar a rede de dentro do container — Use --network none ou um namespace de rede restrito se egresso importar

Combinações

Combine com outros MCPs para 10× de alavancagem

onemcp-agent + filesystem + github

Agregador para o conjunto de servidores do dia a dia

Configure 1mcp with filesystem (prefix fs) + github (prefix gh) + postgres (prefix pg). Use fs__read_file and gh__create_issue from one client.✓ Copiado

Ferramentas

O que este MCP expõe

Ferramenta	Entradas	Quando chamar	Custo
list_servers	—	Health check / depuração	0
reload_config	config_path?	Após editar 1mcp.config.json	0
restart_server	server_name	Quando um servidor filho está com mau comportamento	0
<prefix>__<tool>	conforme a tool filha	Todas as tools filhas aparecem com seu prefixo	depende do servidor filho

Custo e limites

O que custa rodar

Cota de API: Adiciona overhead desprezível por chamada
Tokens por chamada: 0 — proxy passa tudo direto; custo da lista de tools é a soma dos filhos
Monetário: Gratuito
Dica: Desabilite servidores filho usados raramente via flag de configuração em vez de remover — mantém o prompt enxuto

Segurança

Permissões, segredos, alcance

Escopos mínimos: O que os servidores filho precisarem

Armazenamento de credenciais: Variáveis de ambiente dos servidores filho centralizadas em 1mcp.config.json — proteja esse arquivo

Saída de dados: O que os servidores filho fazem — o 1mcp em si não egress a menos que configurado para SSE remoto

Nunca conceda: Arquivo de configuração com secrets legível por todos

Se hospedar o 1mcp remotamente, ative auth com bearer — qualquer pessoa que alcance a porta SSE pode usar todas as tools filhas

Solução de problemas

Erros comuns e correções

Servidor filho falha ao iniciar

Verifique os logs do 1mcp para o stderr desse servidor; geralmente é uma variável de ambiente faltando ou caminho de comando errado

Verificar: Tente o comando do filho standalone em um terminal

Colisão de nomes de tools

Adicione ou encurte prefixos por servidor na configuração

Verificar: list_servers mostra os prefixos atuais

Recarga a quente não captura mudanças

Algumas mudanças exigem reinício (modo de transport, porta). Execute restart_server no filho afetado ou reinicie o 1mcp completamente

Primeira resposta lenta

Os filhos sobem sob demanda por padrão — defina 'eager: true' para servidores quentes

Alternativas

1MCP Agent vs. outros

Alternativa	Quando usar	Troca
metamcp	Você quer um agregador gerenciado por UI com fluxos de trabalho de equipe	Mais pesado; mais opinioso
mcp-router (TheLunarCompany/lunar)	Você precisa de governança e logs de auditoria (enterprise)	Superfície maior; mais configuração

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills