Baton

Servidor MCP local para Baton: edita solicitudes de API nativas de git, colecciones, entornos y scripts.

GitHubPrueba este MCPPatrocinado

Documentación

Baton — Configuración de MCP

Permite que tu asistente de IA trabaje en un espacio de trabajo de Baton. Baton es un cliente de API nativo de git (una alternativa a Postman): las solicitudes, colecciones y entornos son archivos YAML simples en un repositorio que tú posees. El servidor MCP se ejecuta localmente, edita esos archivos de la misma manera que lo hace la aplicación, y cada cambio aparece en la aplicación al instante y pasa por revisión de git como cualquier otro cambio.

  • Servidor: baton
  • Transporte: stdio (proceso local)
  • Paquete: @dudko.dev/baton-mcp — Node.js 24+
  • Autenticación: ninguna — se ejecuta localmente con los permisos de tu usuario; los secretos nunca pasan a través de él.

Lo que puedes hacer

Por defecto, el asistente puede leer y escribir en el espacio de trabajo, pero no enviar solicitudes:

HerramientaQué hace
workspace_infoOrientación: nombre, configuración, entornos, árbol de colecciones.
list_requestsSolicitudes con método, URL y etiquetas.
get_requestUna solicitud analizada más su YAML sin procesar — los secretos aparecen solo como referencias.
upsert_requestEscribir una solicitud como YAML determinista.
move_requestMover o renombrar una solicitud, manteniendo su id.
delete_requestEliminar una solicitud.
upsert_collectionCrear o actualizar una colección o carpeta.
list_environmentsEntornos, solo con nombres de secretos.
upsert_environmentEscribir un entorno (solo nombres de secretos).
get_script / upsert_scriptLeer y escribir scripts de pre-solicitud y de prueba.
run_request / run_collectionEjecutar una solicitud o una colección — solo con --allow-run.

Instalar en Claude Code (plugin)

/plugin marketplace add dudko-dev/baton-mcp-setup
/plugin install baton@baton
/reload-plugins

El plugin inicia el servidor en el directorio actual del proyecto, así que abre Claude Code en (o dentro de) tu espacio de trabajo de Baton. Para apuntar a otro lugar, o para permitir que el asistente ejecute solicitudes, agrega el servidor manualmente (abajo) con --workspace <dir> y/o --allow-run.

¿Prefieres no usar el marketplace? Agrega el servidor directamente:

claude mcp add baton -- npx -y @dudko.dev/baton-mcp --workspace /path/to/workspace

Conectar desde otros clientes

Claude Desktop

claude_desktop_config.json (Configuración → Desarrollador → Editar configuración):

{
  "mcpServers": {
    "baton": {
      "command": "npx",
      "args": [
        "-y",
        "@dudko.dev/baton-mcp"
      ]
    }
  }
}

Cursor

~/.cursor/mcp.json o .cursor/mcp.json:

{
  "mcpServers": {
    "baton": {
      "command": "npx",
      "args": [
        "-y",
        "@dudko.dev/baton-mcp"
      ]
    }
  }
}

VS Code (GitHub Copilot / MCP) y otros clientes

{
  "servers": {
    "baton": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@dudko.dev/baton-mcp"
      ]
    }
  }
}

Seguridad

  • Ejecutar solicitudes está desactivado por defecto. Agrega --allow-run a los argumentos solo cuando quieras que el asistente dispare solicitudes — editar archivos nunca debería enviar tráfico silenciosamente.
  • Los secretos permanecen fuera del espacio de trabajo. El servidor lee y escribe nombres de secretos y referencias {{secret:name}} únicamente; se rechaza un valor en texto plano donde corresponde una referencia.
  • El servidor nunca toca git. Los commits siguen siendo tuyos.
IndicadorSignificado
--workspace <dir>Carpeta del espacio de trabajo (por defecto: directorio actual).
--allow-runPermitir que el agente ejecute solicitudes. Desactivado por defecto.

Solución de problemas

  • "no es un espacio de trabajo de Baton" / el cliente dice "Connection closed" — el servidor se cierra al inicio cuando la carpeta no tiene baton.yaml. Abre Claude Code en tu espacio de trabajo, o agrega el servidor manualmente con --workspace /path/to/workspace.
  • run_request se rechaza — agrega --allow-run.
  • npm warn EBADENGINE … required: { node: '>=24' }, y luego nada — el servidor necesita Node.js 24+; node --version en la terminal que inicia tu cliente.

Soporte