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

Por qué usarlo

Características clave

Agrega cualquier número de servidores MCP stdio / SSE / HTTP en uno solo
Prefijos de nombre de herramienta para evitar colisiones entre servidores
Recarga en caliente de la configuración — sin reinicio del cliente al añadir/eliminar
Ciclo de vida por servidor: iniciar/detener/reiniciar servidores individualmente
Health checks + reinicio automático para servidores inestables

Demo en vivo

Cómo se ve en la práctica

onemcp-agent.replay ▶ listo

0/0

Instalar

Elige tu 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"
      ]
    }
  }
}

Abre Claude Desktop → Settings → Developer → Edit Config. Reinicia después de guardar.

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

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

Cursor usa el mismo esquema mcpServers que Claude Desktop. La configuración del proyecto prevalece sobre la global.

VS Code → Cline → MCP Servers → Edit

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

Haz clic en el icono MCP Servers de la barra lateral de Cline y luego en "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

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

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

~/.continue/config.json

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

Continue usa un array de objetos de servidor en lugar de un mapa.

~/.config/zed/settings.json

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

Añádelo a context_servers. Zed recarga en caliente al guardar.

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

Un solo comando. Verifica con claude mcp list. Quita con claude mcp remove.

Casos de uso

Usos del mundo real: 1MCP Agent

Consolidar más de 20 servidores MCP tras un único endpoint

👤 Usuarios avanzados con muchos MCPs configurados ⏱ ~25 min intermediate

Cuándo usarlo: Tu claude_desktop_config.json tiene más de 20 entradas y añadir/eliminar servidores es tedioso.

Requisitos previos

1mcp instalado — npx -y @1mcp/agent (o instalación persistente según la documentación)

Flujo

Mover los servidores existentes a la configuración de 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 con todos los servidores + prefijos
Apuntar el cliente a 1mcp

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

→ El cliente ahora ve un servidor; herramientas listadas con prefijos
Añadir un nuevo servidor en caliente

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

→ Las nuevas herramientas aparecen en el próximo refresco de list_tools

Resultado: Fuente única de verdad para todos los servidores MCP; iteración más rápida.

Errores comunes

Los nombres de herramientas se vuelven largos con el prefijo — Usa alias de prefijo cortos por servidor (gh, fs, pg) en lugar de nombres completos

Ejecutar un stack MCP compartido por el equipo en un servidor de desarrollo

👤 Equipos de desarrollo pequeños con infraestructura compartida ⏱ ~45 min advanced

Cuándo usarlo: Quieres que todos en el equipo compartan los mismos servidores MCP verificados y secretos, sin duplicar configuraciones.

Requisitos previos

Host accesible — Ejecuta 1mcp en un servidor de desarrollo exponiendo transporte SSE/HTTP con autenticación

Flujo

Centralizar la configuración

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

→ Stack en ejecución; el endpoint SSE requiere bearer token
Distribuir una configuración de cliente

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

→ Un snippet por desarrollador

Resultado: El equipo obtiene la flota MCP verificada sin que cada persona gestione 20 configuraciones.

Errores comunes

Host único = punto único de fallo — Documenta el fallback a configuración local; o ejecuta réplicas detrás de un balanceador de carga

Poner en cuarentena un MCP no confiable tras 1mcp

👤 Usuarios conscientes de la seguridad que prueban MCPs de la comunidad ⏱ ~30 min advanced

Cuándo usarlo: Quieres probar un MCP de terceros sin darle acceso a tu entorno completo ni a tu sistema de archivos.

Flujo

Ejecutar 1mcp en un contenedor

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

→ Contenedor en ejecución; solo las herramientas sandbox/ son visibles desde el MCP en sandbox
Usarlo para una tarea

Run the experimental task only with sandbox__ tools.✓ Copiado

→ La tarea se completa; nada escapó del contenedor

Resultado: Probar servidores no confiables sin dar acceso al reino completo.

Errores comunes

Olvidar que el MCP todavía puede acceder a la red desde dentro del contenedor — Usa --network none o un namespace de red restringido si el egress importa

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

onemcp-agent + filesystem + github

Agregador para tu conjunto de servidores de uso diario

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

Herramientas

Lo que expone este MCP

Herramienta	Entradas	Cuándo llamar	Coste
list_servers	—	Health check / depuración	0
reload_config	config_path?	Después de editar 1mcp.config.json	0
restart_server	server_name	Cuando un servidor hijo tiene un comportamiento incorrecto	0
<prefix>__<tool>	as per child tool	Todas las herramientas hijas se exponen con su prefijo	depends on child server

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API: Añade sobrecarga negligible por llamada
Tokens por llamada: 0 — el proxy pasa las llamadas; el coste de la lista de herramientas es la suma de los hijos
Monetario: Gratuito
Consejo: Deshabilita los servidores hijos que usas raramente mediante la bandera de configuración en lugar de eliminarlos — mantiene el prompt ligero

Seguridad

Permisos, secretos, alcance

Ámbitos mínimos: Whatever child servers need

Almacenamiento de credenciales: Las variables de entorno de los servidores hijos se centralizan en 1mcp.config.json — protege ese archivo

Salida de datos: Lo que hagan los servidores hijos — 1mcp en sí no tiene egress a menos que se configure para SSE remoto

No conceder nunca: Archivo de configuración con lectura pública que contenga secretos

Si alojas 1mcp remotamente, activa la autenticación bearer — cualquiera que llegue al puerto SSE puede usar todas las herramientas hijas

Resolución de problemas

Errores comunes y soluciones

El servidor hijo no arranca

Revisa los logs de 1mcp para el stderr de ese servidor; normalmente es una variable de entorno faltante o una ruta de comando incorrecta

Verificar: Try the child's command standalone in a terminal

Colisión de nombres de herramienta

Añade o acorta los prefijos por servidor en la configuración

Verificar: list_servers shows current prefixes

La recarga en caliente no recoge los cambios

Algunos cambios requieren reinicio (modo de transporte, puerto). Ejecuta restart_server en el hijo afectado o reinicia 1mcp completamente

Primera respuesta lenta

Los hijos arrancan de forma diferida por defecto — define 'eager: true' para los servidores calientes

Alternativas

1MCP Agent vs otros

Alternativa	Cuándo usarla	Contrapartida
metamcp	Quieres un agregador gestionado por UI con flujos de trabajo de equipo	Más pesado; más opinionado
mcp-router (TheLunarCompany/lunar)	Necesitas gobernanza y logs de auditoría (empresa)	Mayor superficie; más configuración

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills