Servidor MCP

Use o ccmux MCP servidor para permitir que um agente de codificação inspecione sessões, leia notas do projeto e verifique o uso. A criação de sessões, pressionamentos de teclas e encerramento estão disponíveis somente quando você habilita a mutação.

O binário do servidor está incluído no ccmux v0.3.0 e posterior. Instale ccmux e certifique-se de que seu daemon esteja em execução antes de conectar um cliente.

Conecte tudo

No Claude Code, registre um servidor stdio local para sua conta de usuário:

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

Executar /mcp dentro de Claude Code para verificar a conexão. Veja Documentação MCP do Claude Code para escopos de configuração e solução de problemas.

Para uma configuração com escopo de projeto, use .mcp.json na raiz do projeto:

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

Outros clientes MCP usam seu próprio formato de configuração. Adicione um servidor stdio com o comando ccmux-mcp; use o caminho absoluto do binário se o cliente não conseguir encontrá-lo em PATH.

O agente agora conta com estas ferramentas:

Essas ferramentas são somente leitura. Eles expõem informações disponíveis para o daemon conectado.

Quando você quiser fazer coisas

Adicionar --allow-mutate aos argumentos do servidor. Para uma configuração Claude Code com escopo de projeto:

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

Isso desbloqueia:

Desativado por padrão por um motivo: um agente que pode send_keys em seu trabalho é um agente que pode digitar qualquer coisa que você possa digitar. A bandeira é a aceitação. Não há substituição por ferramenta – você ativa todo o conjunto de mutação ou o deixa desligado.

Sem o sinalizador, as ferramentas de mutação estão ausentes tools/list. Reinicie o servidor MCP através do seu cliente após alterar seus argumentos.

Conduzir uma máquina remota

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

O agente é executado localmente e consulta o daemon no Mac mini. Ferramentas mutantes ainda exigem --allow-mutate. Mesmo protocolo, mesmas ferramentas - pouco mais de Tailscale HTTP em vez do soquete Unix local. Útil para “Estou codificando no laptop, mas o trabalho noturno do Claude está no mini”.

Para que serve isso

Algumas formas concretas:

Orquestração multisessão. Um agente em uma sessão gera um auxiliar em outra (spawn_session em um projeto diferente), lê sua saída quando terminar (read_pane), recupera o resultado e mata o auxiliar. Nenhum humano no circuito.

Trabalho entre máquinas. Um agente em seu laptop verifica como está seu irmão no Mac mini (list_sessions, read_pane), sem você entrar no SSH. Ou iniciar uma compilação de longa duração no mini (spawn_session após configurar o servidor MCP com --host e --allow-mutate) e continua seu trabalho local.

Memória de projeto. Um agente lê as notas do projeto no início de uma sessão (list_notes + read_note) para não repetir o trabalho que o agente anterior fez. As notas são simples remarcações no disco; o agente não precisa saber disso.

Consciência de custos. Antes de iniciar uma grande corrida, o agente verifica get_usage para ver quanto você gastou esta semana e get_daemon_health para ver quantas sessões já estão em execução.

Nada disso precisa de nova infraestrutura. ccmux já tinha tudo isso. MCP é apenas o protocolo que o torna acessível ao agente.

Modelo de segurança

• Transporte. stdio. O socket Unix do daemon é restrito ao usuário; o acesso HTTP exige conexão à sua tailnet.
• Mutação. Desligado, a menos que você inverta a bandeira.
• Leituras limitadas. read_pane limita 500 linhas para que um agente com erros não possa arrastar o daemon para baixo solicitando a rolagem completa a cada chamada.
• Prazo por chamada. Cada manipulador é executado em um contexto de 30 segundos.

Limites atuais

O servidor fornece ferramentas de solicitação/resposta. Assinaturas ativas, permissões de mutação por ferramenta e uma biblioteca de prompts não estão disponíveis no momento.

Guias relacionados

• Configurar um host remoto antes de direcionar seu daemon.
• Leia a referência HTTP API para construir um cliente diretamente em ccmuxd.

Detectou um erro ou algo desatualizado? Edite esta página em GitHub.