1MCP Agent (MCP server) — Anwendungsfälle, Installieren & Live-Demo

Warum nutzen

Hauptfunktionen

Beliebig viele stdio / SSE / HTTP MCP-Server in einem aggregieren
Tool-Name-Präfixe verhindern Kollisionen über Server hinweg
Hot-Reload-Konfiguration — kein Client-Neustart beim Hinzufügen/Entfernen
Pro-Server-Lebenszyklus: einzelne Server starten/stoppen/neu starten
Health-Checks + Auto-Neustart für instabile Server

Live-Demo

In der Praxis

onemcp-agent.replay ▶ bereit

0/0

Installieren

Wählen Sie Ihren Client

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

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

Öffne Claude Desktop → Settings → Developer → Edit Config. Nach dem Speichern neu starten.

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

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

Cursor nutzt das gleiche mcpServers-Schema wie Claude Desktop. Projektkonfiguration schlägt die globale.

VS Code → Cline → MCP Servers → Edit

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

Klicken Sie auf das MCP-Servers-Symbol in der Cline-Seitenleiste, dann "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

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

Gleiche Struktur wie Claude Desktop. Windsurf neu starten zum Übernehmen.

~/.continue/config.json

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

Continue nutzt ein Array von Serverobjekten statt einer Map.

~/.config/zed/settings.json

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

In context_servers hinzufügen. Zed lädt beim Speichern neu.

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

Einzeiler. Prüfen mit claude mcp list. Entfernen mit claude mcp remove.

Anwendungsfälle

Praxisnahe Nutzung: 1MCP Agent

Mehr als 20 MCP-Server hinter einem Endpunkt zusammenführen

👤 Power-User mit vielen konfigurierten MCPs ⏱ ~25 min intermediate

Wann einsetzen: Deine claude_desktop_config.json hat mehr als 20 Einträge und Server hinzuzufügen/entfernen ist mühsam.

Voraussetzungen

1mcp installiert — npx -y @1mcp/agent (oder persistente Installation gemäß Doku)

Ablauf

Vorhandene Server in 1mcp-Konfiguration verschieben

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

→ 1mcp.config.json mit allen Servern + Präfixen
Client auf 1mcp zeigen

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

→ Client sieht jetzt einen Server; Tools mit Präfixen aufgelistet
Neuen Server hot-hinzufügen

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

→ Neue Tools erscheinen beim nächsten list_tools-Refresh

Ergebnis: Vernünftige einzige Quelle der Wahrheit für alle MCP-Server; schnellere Iteration.

Fallstricke

Tool-Namen werden mit Präfix lang — Kurze Präfix-Aliasse pro Server verwenden (gh, fs, pg) statt voller Namen

Gemeinsamen Team-MCP-Stack auf einem Dev-Server betreiben

👤 Kleine Dev-Teams mit gemeinsamer Infrastruktur ⏱ ~45 min advanced

Wann einsetzen: Du willst dass alle im Team dieselben geprüften MCP-Server + Secrets teilen, ohne Konfigurationen zu duplizieren.

Voraussetzungen

Erreichbarer Host — 1mcp auf einem Dev-Server mit SSE/HTTP-Transport und Auth ausführen

Ablauf

Konfiguration zentralisieren

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

→ Stack läuft; SSE-Endpunkt erfordert Bearer-Token
Eine Client-Konfiguration verteilen

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

→ Ein Snippet pro Entwickler

Ergebnis: Team erhält geprüfte MCP-Flotte ohne dass jeder 20 Konfigurationen verwaltet.

Fallstricke

Einzelner Host = einzelner Ausfallpunkt — Fallback auf lokale Konfiguration dokumentieren; oder Replikate hinter einem Load Balancer betreiben

Nicht vertrauenswürdigen MCP hinter 1mcp quarantänisieren

👤 Sicherheitsbewusste Nutzer, die Community-MCPs testen ⏱ ~30 min advanced

Wann einsetzen: Du möchtest einen Drittanbieter-MCP ausprobieren, ihm aber keinen vollen Env-Zugriff oder vollen Filesystem-Zugriff geben.

Ablauf

1mcp in einem Container ausführen

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

→ Container läuft; nur sandbox/-Tools des Sandbox-MCPs sichtbar
Für eine Aufgabe verwenden

Run the experimental task only with sandbox__ tools.✓ Kopiert

→ Aufgabe abgeschlossen; nichts ist aus dem Container entkommen

Ergebnis: Nicht vertrauenswürdige Server ausprobieren ohne ihnen Zugang zu allem zu geben.

Fallstricke

Vergessen, dass der MCP im Container trotzdem das Netzwerk erreichen kann — --network none oder eingeschränkten Netzwerk-Namespace verwenden wenn Egress wichtig ist

Kombinationen

Mit anderen MCPs für 10-fache Wirkung

onemcp-agent + filesystem + github

Aggregator für deinen täglichen Server-Set

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

Werkzeuge

Was dieses MCP bereitstellt

Werkzeug	Eingaben	Wann aufrufen	Kosten
list_servers	—	Health-Check / Debugging	0
reload_config	config_path?	Nach dem Bearbeiten von 1mcp.config.json	0
restart_server	server_name	Wenn ein Child-Server sich falsch verhält	0
<prefix>__<tool>	as per child tool	Alle Child-Tools erscheinen mit ihrem Präfix	depends on child server

Kosten & Limits

Was der Betrieb kostet

API-Kontingent: Fügt vernachlässigbaren Overhead pro Aufruf hinzu
Tokens pro Aufruf: 0 — Proxy reicht durch; Tool-Listen-Kosten sind die Summe der Child-Server
Kosten in €: Kostenlos
Tipp: Selten genutzte Child-Server per Konfigurations-Flag deaktivieren statt entfernen — hält den Prompt schlank

Sicherheit

Rechte, Secrets, Reichweite

Minimale Scopes: Was auch immer Child-Server benötigen

Credential-Speicherung: Child-Server-Umgebungsvariablen in 1mcp.config.json zentralisiert — diese Datei schützen

Datenabfluss: Was auch immer Child-Server tun — 1mcp selbst hat keinen Egress sofern nicht auf Remote-SSE konfiguriert

Niemals gewähren: Weltlesbare Konfigurationsdatei mit Secrets

Bei Remote-Hosting von 1mcp Bearer-Auth aktivieren — jeder, der den SSE-Port erreicht, kann alle Child-Tools nutzen

Fehlerbehebung

Häufige Fehler und Lösungen

Child-Server startet nicht

1mcp-Logs für stderr dieses Servers prüfen; meist fehlende Umgebungsvariable oder falscher Befehlspfad

Prüfen: Try the child's command standalone in a terminal

Tool-Name-Kollision

Präfixe pro Server in der Konfiguration hinzufügen oder verkürzen

Prüfen: list_servers shows current prefixes

Hot-Reload übernimmt Änderungen nicht

Einige Änderungen erfordern Neustart (Transport-Modus, Port). restart_server auf dem betroffenen Child oder vollständigen 1mcp-Neustart ausführen

Langsame erste Antwort

Children spawnen standardmäßig lazy — 'eager: true' für häufig genutzte Server setzen

Alternativen

1MCP Agent vs. andere

Alternative	Wann stattdessen	Kompromiss
metamcp	UI-verwalteter Aggregator mit Team-Workflows gewünscht	Schwerer; mehr eigene Meinungen
mcp-router (TheLunarCompany/lunar)	Governance und Audit-Logs benötigt (Enterprise)	Größere Oberfläche; mehr Setup

Mehr

Ressourcen

📖 Offizielle README auf GitHub lesen

🐙 Offene Issues ansehen

🔍 Alle 400+ MCP-Server und Skills durchsuchen