1MCP Agent (MCP server) — Cas d'usage, Installer & Démo en direct

Pourquoi l'utiliser

Fonctionnalités clés

Agréger un nombre quelconque de serveurs MCP stdio / SSE / HTTP en un seul
Préfixage des noms d'outils pour éviter les collisions entre serveurs
Rechargement de config à chaud — pas de redémarrage client lors d'ajout/suppression
Cycle de vie par serveur : démarrer/arrêter/redémarrer des serveurs individuels
Vérifications d'état + redémarrage automatique pour les serveurs instables

Démo en direct

Aperçu en pratique

onemcp-agent.replay ▶ prêt

0/0

Installer

Choisissez votre 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"
      ]
    }
  }
}

Ouvrez Claude Desktop → Settings → Developer → Edit Config. Redémarrez après avoir enregistré.

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

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

Cursor utilise le même schéma mcpServers que Claude Desktop. La config projet l'emporte sur la globale.

VS Code → Cline → MCP Servers → Edit

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

Cliquez sur l'icône MCP Servers dans la barre latérale Cline, puis "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

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

Même format que Claude Desktop. Redémarrez Windsurf pour appliquer.

~/.continue/config.json

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

Continue utilise un tableau d'objets serveur plutôt qu'une map.

~/.config/zed/settings.json

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

Ajoutez dans context_servers. Zed recharge à chaud à la sauvegarde.

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

Une seule ligne. Vérifiez avec claude mcp list. Supprimez avec claude mcp remove.

Cas d'usage

Usages concrets : 1MCP Agent

Consolider plus de 20 serveurs MCP derrière un seul endpoint

👤 Utilisateurs avancés avec de nombreux MCP configurés ⏱ ~25 min intermediate

Quand l'utiliser : Votre claude_desktop_config.json a plus de 20 entrées et ajouter/supprimer des serveurs est pénible.

Prérequis

1mcp installé — npx -y @1mcp/agent (ou installation persistante via la documentation)

Déroulement

Migrer les serveurs existants vers la config 1mcp

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

→ 1mcp.config.json avec tous les serveurs + préfixes
Pointer le client vers 1mcp

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

→ Le client voit maintenant un seul serveur ; outils listés avec préfixes
Ajouter un nouveau serveur à chaud

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

→ Nouveaux outils apparaissent au prochain rafraîchissement list_tools

Résultat : Source de vérité unique et sensée pour tous les serveurs MCP ; itération plus rapide.

Pièges

Les noms d'outils deviennent longs avec le préfixe — Utiliser des alias de préfixe courts par serveur (gh, fs, pg) au lieu des noms complets

Faire tourner une stack MCP partagée par l'équipe sur un serveur de dev

👤 Petites équipes de développement utilisant une infrastructure partagée ⏱ ~45 min advanced

Quand l'utiliser : Vous voulez que tous les membres de l'équipe partagent les mêmes serveurs MCP validés + secrets, sans dupliquer les configurations.

Prérequis

Hôte accessible — Lancer 1mcp sur un serveur de dev exposant SSE/HTTP avec authentification

Déroulement

Centraliser la configuration

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

→ Stack en cours d'exécution ; endpoint SSE nécessite un bearer token
Distribuer une seule config client

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

→ Un snippet par développeur

Résultat : L'équipe dispose d'une flotte MCP validée sans que chacun gère 20 configurations.

Pièges

Hôte unique = point de défaillance unique — Documenter le repli sur la config locale ; ou faire tourner des répliques derrière un load balancer

Mettre en quarantaine un MCP non fiable derrière 1mcp

👤 Utilisateurs soucieux de la sécurité testant des MCP communautaires ⏱ ~30 min advanced

Quand l'utiliser : Vous voulez essayer un MCP tiers sans lui donner accès à tout votre environnement ou votre système de fichiers.

Déroulement

Faire tourner 1mcp dans un container

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

→ Container en cours d'exécution ; seuls les outils sandbox/ visibles depuis le MCP sandbox
L'utiliser pour une tâche

Run the experimental task only with sandbox__ tools.✓ Copié

→ Tâche terminée ; rien n'a échappé au container

Résultat : Tester des serveurs non fiables sans leur donner les clés du royaume.

Pièges

Oublier que le MCP peut quand même accéder au réseau depuis le container — Utiliser --network none ou un namespace réseau restreint si l'egress est important

Combinaisons

Associez-le à d'autres MCPs pour un effet X10

onemcp-agent + filesystem + github

Agrégateur pour votre ensemble de serveurs du quotidien

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

Outils

Ce que ce MCP expose

Outil	Entrées	Quand appeler	Coût
list_servers	—	Vérification d'état / débogage	0
reload_config	config_path?	Après modification de 1mcp.config.json	0
restart_server	server_name	Quand un serveur enfant se comporte mal	0
<prefix>__<tool>	selon l'outil enfant	Tous les outils enfants sont exposés avec leur préfixe	dépend du serveur enfant

Coût et limites

Coût d'exécution

Quota d'API: Surcharge négligeable par appel
Tokens par appel: 0 — le proxy passe en transparence ; le coût de la liste d'outils est la somme des enfants
Monétaire: Gratuit
Astuce: Désactiver les serveurs enfants rarement utilisés via un flag de config plutôt que de les supprimer — garde le prompt concis

Sécurité

Permissions, secrets, portée

Portées minimales : Ce que nécessitent les serveurs enfants

Stockage des identifiants : Variables d'env des serveurs enfants centralisées dans 1mcp.config.json — protéger ce fichier

Sortie de données : Ce que font les serveurs enfants — 1mcp lui-même n'effectue pas d'egress sauf si configuré vers un SSE distant

Ne jamais accorder : Fichier de config accessible en lecture par tous avec des secrets

Si vous hébergez 1mcp à distance, activer l'auth bearer — quiconque atteint le port SSE peut utiliser tous les outils enfants

Dépannage

Erreurs courantes et correctifs

Le serveur enfant ne démarre pas

Vérifier les logs 1mcp pour le stderr de ce serveur ; généralement une variable d'env manquante ou un chemin de commande incorrect

Vérifier : Essayer la commande de l'enfant seul dans un terminal

Collision de noms d'outils

Ajouter ou raccourcir les préfixes par serveur dans la config

Vérifier : list_servers affiche les préfixes actuels

Le rechargement à chaud ne prend pas en compte les changements

Certains changements nécessitent un redémarrage (mode transport, port). Exécuter restart_server sur l'enfant affecté ou redémarrer 1mcp entièrement

Première réponse lente

Les enfants démarrent en mode lazy par défaut — définir 'eager: true' pour les serveurs fréquents

Alternatives

1MCP Agent vs autres

Alternative	Quand l'utiliser	Compromis
metamcp	Vous voulez un agrégateur géré par interface graphique avec des workflows d'équipe	Plus lourd ; plus opinioné
mcp-router (TheLunarCompany/lunar)	Vous avez besoin de gouvernance et de logs d'audit (entreprise)	Surface plus grande ; configuration plus lourde

Plus

Ressources

📖 Lire le README officiel sur GitHub

🐙 Voir les issues ouvertes

🔍 Parcourir les 400+ serveurs MCP et Skills