Prototipo · Versión preliminar: todos los servidores del registro oficial, sincronizados cada 30 minutos. Inicia sesión con Google para escribir reseñas.Prototipo · se actualiza cada 30 min
PopNx MCPServidores MCP para quienes usan IA · en palabras sencillas

mcp-patchbay

de distronode-corporationversión 0.1.2i★ 2iSe ejecuta en tu computadoraRepositorio ↗
Nombre en el registroio.github.distronode-corporation/mcp-patchbay

Cómo instalar

What it does

Hosts your MCP servers and switches them on and off mid-session, with a person approving risky ones

  • Connects Se ejecuta en tu computadora
  • Account or key No key needed
  • Category Otros

Por qué está en este puesto

Las listas se ordenan por una puntuación de uso (sobre 100) con estas partes

Popularidad17/80Estrellas de GitHub o descargas semanales: la mayor cuenta 60, la menor 20
Actualidad12/12Puntuación completa con una versión o cambio de código en 30 días
Sigue respondiendo0/8El endpoint en la nube respondió en la última revisión
Puntuación de uso29/100

Calidad: Pasó 3/3 revisiones básicas (se muestra, no ordena) · Impulso: 16 (Solo se usa en la pestaña En auge)

Instalación

Elige la app de IA que usas y copia la configuración.

Que tu IA lo instale con una frase

Instala mcp-patchbay. Sigue https://mcp.popnx.com/i/distronode-corporation-mcp-patchbay.md, enséñame los comandos y espera mi OK antes de ejecutarlos.

Pégala en una IA que trabaje en tu equipo (como Claude Code o Cursor). Lee nuestros pasos, te muestra los comandos y espera tu OK. Sin clave ni registro. · Ver el texto completo que lee tu IA

Pasó 3/3 revisiones · Funciona en tu computadora · ✓ Comandos revisados el 18 nov 2026

Primero: ¿qué IA usas?

Elige tu app y los pasos aparecen abajo.

Funciona con Claude, pero hay que preparar algo antes

Instala Node.js en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil

Que la IA lo instale

Copia este mensaje en un chat de Claude. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.

Instala el MCP server mcp-patchbay para Claude en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "patchbay": { "command": "npx", "args": [ "-y", "mcp-patchbay" ] } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de mcp-patchbay aparecen de verdad.

Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.

  1. Instala Node.js (si no lo tienes)

    ¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter

    node -v
    • Aparece un número de versión, p. ej. v26.13.1 = ya está instalado, sáltate este paso
    • Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
    Cómo abrir la Terminal

    Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter

    Windows: abre Inicio, escribe Windows PowerShell y elige Abrir

    Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl

    Abrir la página de descarga de Node.js ↗

    Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v

    Se instala una vez y sirve para todo lo que usa Node.js

  2. Abre el archivo de configuración de la app de Claude de escritorio

    SettingsDeveloperEdit Config

  3. Pega esta configuración y guarda el archivo

    {
      "mcpServers": {
        "patchbay": {
          "command": "npx",
          "args": [
            "-y",
            "mcp-patchbay"
          ]
        }
      }
    }
  4. Cierra Claude y vuelve a abrirlo

  5. Pruébalo

    Usa mcp-patchbay y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude dice que está usando mcp-patchbay o muestra una herramienta de mcp-patchbay en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

ChatGPT todavía no puede conectar mcp-patchbay

mcp-patchbay se instala en tu computadora, pero ChatGPT solo conecta servidores que funcionan en la web

Lo que puedes hacer en su lugar

A · Usa una app que pueda conectar mcp-patchbay

  • Instala Node.js en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil
  • Instala Node.js en tu computadora primero (una sola vez)
  • Instala Node.js en tu computadora primero (una sola vez)
  • Instala Node.js en tu computadora primero (una sola vez)

B · Otros en Otros que funcionan con ChatGPT

Elegidos entre los más usados de la misma categoría, solo los que se conectan con una dirección y sin clave

Funciona con Claude Code, pero hay que preparar algo antes

Instala Node.js en tu computadora primero (una sola vez)

Que la IA lo instale

Copia este mensaje en un chat de Claude Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.

Instala el MCP server mcp-patchbay para Claude Code en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): claude mcp add --scope user patchbay -- npx -y mcp-patchbay 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de mcp-patchbay aparecen de verdad.

Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.

  1. Instala Node.js (si no lo tienes)

    ¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter

    node -v
    • Aparece un número de versión, p. ej. v26.13.1 = ya está instalado, sáltate este paso
    • Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
    Cómo abrir la Terminal

    Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter

    Windows: abre Inicio, escribe Windows PowerShell y elige Abrir

    Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl

    Abrir la página de descarga de Node.js ↗

    Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v

    Se instala una vez y sirve para todo lo que usa Node.js

  2. Abre la Terminal

    Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell

  3. Pega este comando y pulsa Enter

    claude mcp add --scope user patchbay -- npx -y mcp-patchbay
  4. Escribe /mcp en Claude Code

    Deberías ver mcp-patchbay en la lista como conectado

  5. Pruébalo

    Usa mcp-patchbay y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude Code dice que está usando mcp-patchbay o muestra una herramienta de mcp-patchbay en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con Cursor, pero hay que preparar algo antes

Instala Node.js en tu computadora primero (una sola vez)

Que la IA lo instale

Copia este mensaje en un chat de Cursor. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.

Instala el MCP server mcp-patchbay para Cursor en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "patchbay": { "command": "npx", "args": [ "-y", "mcp-patchbay" ] } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de mcp-patchbay aparecen de verdad.

Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.

  1. Instala Node.js (si no lo tienes)

    ¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter

    node -v
    • Aparece un número de versión, p. ej. v26.13.1 = ya está instalado, sáltate este paso
    • Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
    Cómo abrir la Terminal

    Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter

    Windows: abre Inicio, escribe Windows PowerShell y elige Abrir

    Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl

    Abrir la página de descarga de Node.js ↗

    Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v

    Se instala una vez y sirve para todo lo que usa Node.js

  2. Pulsa este botón para abrir Cursor

    Abrir en Cursor

    Cursor te pedirá confirmar; pulsa Install

  3. Abre el chat de IA de Cursor en modo Agent

  4. Pruébalo

    Usa mcp-patchbay y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Cursor dice que está usando mcp-patchbay o muestra una herramienta de mcp-patchbay en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con VS Code, pero hay que preparar algo antes

Instala Node.js en tu computadora primero (una sola vez)

Que la IA lo instale

Copia este mensaje en un chat de VS Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.

Instala el MCP server mcp-patchbay para VS Code en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "servers": { "patchbay": { "type": "stdio", "command": "npx", "args": [ "-y", "mcp-patchbay" ] } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de mcp-patchbay aparecen de verdad.

Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.

  1. Instala Node.js (si no lo tienes)

    ¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter

    node -v
    • Aparece un número de versión, p. ej. v26.13.1 = ya está instalado, sáltate este paso
    • Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
    Cómo abrir la Terminal

    Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter

    Windows: abre Inicio, escribe Windows PowerShell y elige Abrir

    Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl

    Abrir la página de descarga de Node.js ↗

    Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v

    Se instala una vez y sirve para todo lo que usa Node.js

  2. Pulsa este botón para abrir VS Code

    Abrir en VS Code

    VS Code te pedirá confirmar; pulsa Install

  3. Abre el chat de IA de VS Code en modo Agent

  4. Pruébalo

    Usa mcp-patchbay y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si VS Code dice que está usando mcp-patchbay o muestra una herramienta de mcp-patchbay en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps

Ver todas las apps que usan MCP →

La configuración JSON está en “Para desarrolladores”, abajo

¿Te atascaste? Pregunta a quien usa mcp-patchbay💬 Conversación →
Para desarrolladores: comandos de Terminal y configuración JSON

Instalado en tu computadora

Claude Code

claude mcp add --scope user patchbay -- npx -y mcp-patchbay

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "patchbay": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-patchbay"
      ]
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "patchbay": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-patchbay"
      ]
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "patchbay": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-patchbay"
      ]
    }
  }
}

Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.

De un vistazo

Descargas por semanai
463/sem
Licenciai
Apache-2.0
Conexión
Se ejecuta en tu computadora
Última versióni
0.1.2
Categoríai
Otros
Publicado en el registroi
18 nov 2026
Último cambio de códigoi
17 nov 2026
Creador
distronode-corporation
Paquetes
npm: mcp-patchbay
Sitio web
github.com
Estado en el registro
Activo

Qué apps pueden usarlo

Según cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.

Se ejecutan en tu computadora en

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

Todas las apps, con ventajas y desventajas →

Qué puede hacer

Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.

Revisiones básicasi

Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 19 nov 2026

  • ✓ Superada

    El creador coincide con el repo

    El nombre en el registro se verificó con la cuenta de GitHub distronode-corporation, dueña del repo

  • ✓ Superada

    Sigue en mantenimiento

    Último cambio de código: anteayer

  • ✓ Superada

    Tiene licencia

    Usa Apache-2.0

  • – No aplica

    El endpoint responde

    Este se ejecuta en tu computadora; no hay endpoint en internet

  • – No aplica

    Inicio de sesión con OAuth

    Se ejecuta en tu computadora y usa ajustes locales en su lugar

  • … Aún sin revisar

    Sin instrucciones ocultas en las descripciones de herramientas

    Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet

Vulnerabilidades publicadas (OSV.dev)

Aún no revisado

Qué revisamos → · JSON

Creadores: pedir otra revisión o avisar de un dato erróneo
Para autores: añade una insignia a tu README

Si lo creaste tú, pega este código en tu README. La insignia enlaza a esta página.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/distronode-corporation-mcp-patchbay.svg)](https://mcp.popnx.com/en/servers/distronode-corporation-mcp-patchbay)

Conversación

Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.

Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.

Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.

Inicia sesión para publicar

Reseñas de usuarios

Aún no hay reseñas

Inicia sesión para escribir una reseña

Comparado con otros en Otrosi

  • Más estrellas que el 91% de los otros 20613 servidores de esta categoría
  • Publicado en el registro más recientemente que el 97% de los otros 20613 servidores de esta categoría
  • Revisiones básicas iguales o mejores que el 99% de los otros 20613 servidores de esta categoría

Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.

Preguntas frecuentes

¿Es seguro mcp-patchbay?

Superó 3 de 3 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.

¿Qué claves o códigos necesita?

El registro no indica ninguna clave obligatoria, aunque algunos servidores te piden iniciar sesión la primera vez que los usas.

¿Se ejecuta en mi computadora o en la nube?

Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).

¿Sigue en mantenimiento?

El repo de GitHub cambió por última vez anteayer, y la última versión (0.1.2) llegó al registro ayer.

¿Qué apps pueden usarlo?

Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Node.js en tu computadora.

¿Qué puedo usar en su lugar?

En la misma categoría: World Monitor, openstatus, Oh My Posh Validator, Strata, Jitsu

Alternativas parecidas

Misma categoría, otros creadores, comandos ya revisados. Primero los oficiales, luego por estrellas.

Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi

World Monitor

Real-time global intelligence on conflict, markets, energy, trade, shipping and cyber. 100 tools.

de koala73Muy usado★ 90,9 milActualizado hace 3 días

Se ejecuta en la nube✓ del servicio · worldmonitor.app

openstatus

Manage monitors, status pages, incidents and maintenances in your openstatus workspace.

de openstatusHQMuy usado★ 9,3 milActualizado hace 2 meses

Se ejecuta en la nube✓ del servicio · openstatus.dev

Oh My Posh Validator

Validate oh-my-posh configurations and segment snippets against the official schema.

de JanDeDobbeleerMuy usado★ 23,8 mil Estrellas de todo el repositorioActualizado hace 30 días

Se ejecuta en la nube✓ del servicio · ohmyposh.dev

Strata

MCP server for progressive tool usage at any scale (see https://klavis.ai)

de Klavis-AIEn crecimiento★ 5,8 milActualizado hace 14 meses

Se ejecuta en la nubeRepo archivado✓ klavis.ai

Jitsu

Manage Jitsu data pipelines: destinations, streams, connections, functions, live events.

de jitsucomMuy usado★ 5,1 milActualizado hace 4 meses

Se ejecuta en la nube✓ del servicio · jitsu.com
Comparado con otros parecidos
Este
mcp-patchbay
World MonitoropenstatusOh My Posh ValidatorStrataJitsu
Dónde se ejecutaSe instala en tu equipoFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nada
Necesita claveNoNoNoNoNoNo
Se añade con + en ClaudeNoNoNoNoNoNo
Revisiones básicas3/34/44/44/41/44/4
LicenciaApache-2.0AGPL-3.0AGPL-3.0MITApache-2.0MIT
PrecioSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registro

README del creador

Abrir el README

Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.

mcp-patchbay

One MCP server that hosts all your others, and lets the agent switch them on and off mid-session, with a person approving the risky ones.

claude mcp add --scope user patchbay -- npx -y mcp-patchbay@0.1.2

npx -y mcp-patchbay@0.1.2 import --from ~/.claude.json --out ~/.config/mcp-patchbay/servers.json npx -y mcp-patchbay@0.1.2 doctor --all

Register it as patchbay, copy your user-level Claude Code servers into its config with import, and check that each one starts. import replaces the --out file (it backs up the old one first) and prints what it imported and skipped: remove the imported servers from Claude Code, or they run twice. Or write the file by hand as in Quick start.

A real session against the public filesystem server, shortened to one line per step. Full walkthrough in Quick start.

Made by Distronode. More open source from us: github.com/distronode-corporation.

If you allow `mcp__patchbay` as a whole in your client's permissions, you approve every tool of every server it hosts.

Allow individual tools (mcp__patchbay__ __ ) instead. See Policy and safety model.

mcp-patchbay is an MCP server that hosts other MCP servers as child processes, and lets the AI agent switch them on and off in the middle of a session.

  • The agent sees five small tools: servers, enable, disable, restart and info.
  • When the agent enables a server, the patchbay starts it, and its tools appear straight away as __ . The patchbay sends notifications/tools/list_changed, so the client refreshes its tool list.
  • When a server is disabled, its tools disappear the same way.
  • For servers you mark confirm, a person, not the agent, approves each enable, through an MCP elicitation prompt in the client.

Why. Every connected MCP server costs context (its tool definitions) and a running process, whether or not the session needs it. With the patchbay, you configure all your servers once, and only the ones a task needs are running and visible.

Requirements

  • Node.js 22 or later.
  • An MCP client that honours notifications/tools/list_changed and supports elicitation (form mode, and ideally URL mode for sign-ins). For Claude Code, that means 2.1.287 or later.

Without elicitation support, confirm servers cannot be enabled. That is deliberate: the patchbay fails closed.

Contents: Quick start · Config reference · Naming contract · Moving from Claude Code: import and rename-permissions · Policy and safety model · Known limits · Comparison · Uninstall and rollback · Privacy Policy

Quick start

  1. Register the patchbay with Claude Code under the name `patchbay`. The naming contract and the 128-character rule assume that name.
   claude mcp add --scope user patchbay -- npx -y mcp-patchbay@0.1.2

That is all the first run needs. When ~/.config/mcp-patchbay/servers.json does not exist, the patchbay creates it with no servers ({"version": 1, "servers": {}}), says so in one line on stderr, and serves its own tools. Nothing is switched on and the file holds no secrets. On macOS and Linux the file is mode 600, and the directory, if the patchbay has to create it, mode 700; an existing directory is kept as it is, provided nobody else can write it. Windows has no such modes (see Known limits).

  1. Then add your connectors. This example hosts the public filesystem server (@modelcontextprotocol/server-filesystem@2.2.0). Edit ~/.config/mcp-patchbay/servers.json so it reads:
   {

"version": 1, "servers": { "example-files": { "description": "Read and write files in /path/to/project", "policy": "confirm", "command": "npx", "args": ["-y", "@modelcontextprotocol/server-filesystem@2.2.0", "/path/to/project"] } } }

Keep the file private. The patchbay refuses to start if the file, or the directory it is in, is group- or world-writable (chmod 600 ~/.config/mcp-patchbay/servers.json fixes the file). Already have servers in Claude Code? import writes this file from them.

  1. Check it. doctor validates the file and briefly starts every allow server. Add --all to also start confirm servers like this one.
   npx -y mcp-patchbay@0.1.2 doctor --all
  1. The config is read once, at startup, so reconnect the patchbay (/mcp, then patchbay). In a session, ask the agent to "enable example-files". Claude Code shows the prompt *"Allow the agent to turn on example-files (Read and write files in /path/to/project)?"*. Once you approve, tools such as mcp__patchbay__example-files__read_text_file are available.

A longer, synthetic example is in examples/servers.json.

--config and $MCP_PATCHBAY_CONFIG stay strict: only the default path is ever created for you, and a missing file anywhere else exits with code 78.

Claude Code plugin

plugins/claude-code is a Claude Code plugin, patchbay, whose MCP server runs npx -y mcp-patchbay@0.1.2. Its tools are named mcp__plugin_patchbay_patchbay__ , not mcp__patchbay__ , so the naming contract, the 128-character rule, doctor and rename-permissions below assume the hand-registered server instead. The warning at the top applies with the plugin prefix too: never allow mcp__plugin_patchbay_patchbay__enable_confirm or the whole plugin server, and doctor does not check rules written with that prefix. Its README has the details.

Claude Desktop

Each release carries mcp-patchbay- .mcpb, a desktop extension bundle with its dependencies included. Double-click it, or use Settings > Extensions > Advanced settings > Install Extension... in Claude Desktop. Its one setting is the config file, ~/.config/mcp-patchbay/servers.json by default, which the first run creates as above. Then add your connectors to it and turn the extension off and on again in Settings > Extensions so it rereads the file. If a confirm server cannot be enabled because the client shows no approval form, set "confirmVia": "host".

Config reference

The config location is --config , else $MCP_PATCHBAY_CONFIG, else ~/.config/mcp-patchbay/servers.json. The file is read once, at startup. To apply changes, restart the patchbay (in Claude Code: /mcp, then reconnect patchbay).

{

"version": 1, "confirmVia": "host", "servers": { "example-files": { "description": "Files in /path/to/project", "policy": "allow", "command": "npx", "args": ["-y", "@modelcontextprotocol/server-filesystem@2.2.0", "/path/to/project"], "env": { "EXAMPLE_LOG_LEVEL": "info" }, "cwd": "/path/to", "prefix": "files", "timeoutMs": 0 }, "example-remote": { "description": "A remote MCP server", "policy": "confirm", "url": "https://mcp.example.com/mcp", "headers": { "X-Example-Tenant": "example" } } }, "autostart": { "default": [], "projects": { "/path/to/project": ["example-files"] } }, "oauth": { "configDir": "~/.config/mcp-patchbay/oauth", "authTimeoutSeconds": 300 } }

Validation is strict: an unknown key anywhere is an error that names its path. Any config error exits with code 78 and a message on stderr.

KeyMeaning
versionMust be 1.
confirmViaHow a person approves a confirm server. "elicitation" (the default): enable asks through the client's form elicitation. "host": enable refuses, and the agent calls enable_confirm, which the host's own tool-permission prompt asks the person about. import writes "host". See confirmVia.
servers. The name uses 1–64 characters from [A-Za-z0-9_-], with no __ and no trailing _.
descriptionOne line, at most 300 characters. The agent sees it in servers and in the patchbay's instructions.
policyallow (the agent may enable it), confirm (a person must approve each enable; the default), or deny (it can never be enabled).
command, args, env, cwdA stdio server. cwd must be absolute. The child gets {...the patchbay's env, ...env}, the same as Claude Code gives its own servers.
url, headersA remote server, launched through the bundled mcp-remote 0.15.2. The URL must be https, except for localhost and 127.0.0.1. Header names use [A-Za-z0-9_-]. env is also allowed and is passed to mcp-remote.
prefixA short alias used instead of the name in tool names. Names and prefixes must be unique, ignoring case.
timeoutMsThe cap on one tool call, in milliseconds. 0 (the default) means no cap.
autostart.defaultServers started at launch, with no confirmation. Not allowed for deny servers.
autostart.projectsPer-project lists, keyed by absolute directory. The key is matched against CLAUDE_PROJECT_DIR, or else the current directory. A matching list replaces default.
oauth.configDirWhere mcp-remote keeps OAuth state for url servers. It is created with mode 0700.
oauth.authTimeoutSecondsHow long a sign-in may take (1–86400, default 300).

Each server has exactly one of command or url.

Autostart is your own config choice, so it counts as consent. The instructions of autostarted servers are folded into the patchbay's own instructions, within 4,096 characters in total and shared fairly between servers.

Headers and secrets. Header values are not put on mcp-remote's command line, where other local users could read them. Instead the patchbay passes --header Name:${MCP_PATCHBAY_HEADER_n} and puts the value in mcp-remote's environment, which expands it. A value that already contains a ${VAR} placeholder is passed as it is, and mcp-remote expands it from its own environment (that is, the patchbay's env plus the entry's env).

Other environment variables.

  • MCP_PATCHBAY_DEBUG=1 copies every child's stderr (redacted) into the patchbay's own stderr log.
  • MCP_PATCHBAY_MCP_REMOTE_BIN replaces the mcp-remote script. This is for tests, and you should not normally set it.

The agent's tools

| Tool | Input | What it does |

Solo se muestra el principio; lee el resto en el repo