Servidor MCP

Utilice el ccmux MCP servidor para permitir que un agente de codificación inspeccione sesiones, lea notas del proyecto y verifique el uso. La creación de sesiones, las pulsaciones de teclas y la finalización están disponibles solo cuando habilita la mutación.

El binario del servidor se incluye con ccmux v0.3.0 y posteriores. Instalar ccmux y asegúrese de que su demonio se esté ejecutando antes de conectar un cliente.

Conéctelo

En Claude Code, registra un servidor stdio local para tu cuenta de usuario:

claude mcp add --transport stdio --scope user ccmux -- ccmux-mcp

Ejecutar /mcp dentro de Claude Code para verificar la conexión. Ver Documentación MCP de Claude Code para alcances de configuración y solución de problemas.

Para una configuración con alcance de proyecto, utilice .mcp.json en la raíz del proyecto:

{
  "mcpServers": {
    "ccmux": { "command": "ccmux-mcp" }
  }
}

Otros clientes MCP usan su propio formato de configuración. Añade un servidor stdio con el comando ccmux-mcp; utilice la ruta absoluta del binario si el cliente no puede encontrarlo en PATH.

El agente ahora cuenta con estas herramientas:

Estas herramientas son de solo lectura. Exponen información disponible para el demonio conectado.

Cuando quieres que haga cosas

Agregar --allow-mutate a los argumentos del servidor. Para una configuración Claude Code con ámbito de proyecto:

{
  "mcpServers": {
    "ccmux": { "command": "ccmux-mcp", "args": ["--allow-mutate"] }
  }
}

Eso desbloquea:

Desactivado de forma predeterminada por una razón: un agente que puede send_keys en tu trabajo hay un agente que puede escribir cualquier cosa que puedas escribir. La bandera es el opt-in. No hay anulación por herramienta: activa todo el conjunto de mutaciones o lo deja desactivado.

Sin la bandera, las herramientas de mutación están ausentes tools/list. Reinicie el servidor MCP a través de su cliente después de cambiar sus argumentos.

Conducir una máquina remota

CCMUX_HOST=mini.tail-xxxxx.ts.net:7474 ccmux-mcp
# or
ccmux-mcp --host mini.tail-xxxxx.ts.net:7474

El agente se ejecuta localmente y consulta el demonio en el Mac mini. Las herramientas mutantes aún requieren --allow-mutate. Mismo protocolo, mismas herramientas: poco más de Tailscale HTTP en lugar del socket Unix local. Útil para "Estoy codificando en la computadora portátil, pero el trabajo nocturno Claude se realiza en la mini".

Para qué sirve esto realmente

Algunas formas concretas:

Orquestación multisesión. Un agente en una sesión genera un ayudante en otra (spawn_session en un proyecto diferente), lee su salida una vez que está hecho (read_pane), recupera el resultado y mata al ayudante. Ningún humano en el circuito.

Trabajo entre máquinas. Un agente en su computadora portátil verifica cómo le está yendo a su hermano en la Mac mini (list_sessions, read_pane), sin que usted SSH entre. O inicia una compilación de larga duración en el mini (spawn_session después de configurar el servidor MCP con --host y --allow-mutate) y continúa su trabajo local.

Memoria de proyecto. Un agente lee las notas del proyecto al inicio de una sesión (list_notes + read_note) para que no repita el trabajo que realizó el agente anterior. Las notas están simplemente rebajadas en el disco; el agente no necesita saber eso.

Conciencia de costos. Antes de iniciar una gran carrera, el agente verifica get_usage para ver lo que has gastado esta semana, y get_daemon_health para ver cuántas sesiones ya se están ejecutando.

Nada de esto necesita nueva infraestructura. ccmux ya lo tenía todo. MCP es justo el protocolo que lo hace accesible para los agentes.

Modelo de seguridad

• Transporte. stdio. El socket Unix del demonio está limitado al usuario; el acceso HTTP requiere conexión a tu tailnet.
• Mutación. Desactivado a menos que gires la bandera.
• Lecturas acotadas. read_pane tiene un límite de 500 líneas para que un agente con errores no pueda arrastrar el demonio hacia abajo solicitando el desplazamiento hacia atrás completo en cada llamada.
• Fecha límite por llamada. Cada controlador se ejecuta en un contexto de 30 segundos.

Límites actuales

El servidor proporciona herramientas de solicitud/respuesta. Las suscripciones activas, los permisos de mutación por herramienta y una biblioteca de avisos no están disponibles actualmente.

Guías relacionadas

• Configurar un host remoto antes de apuntar a su demonio.
• Leer la referencia HTTP API para crear un cliente directamente contra ccmuxd.

¿Detectó un error o algo desactualizado? Editar esta página en GitHub.