Claude Orchestrator
Ponte MCP para ler as respostas que o Claude Code já salvou nas sessões do CMD, sem copiar e colar e sem enviar outra pergunta ao Claude. Também mantém o protótipo de envio de tarefas. Não depende do Codex na operação. A conexão ao ChatGPT no Chat normal ainda precisa ser validada.
Estado real
- Servidor MCP por stdio e cliente de diagnóstico/teste.
- Leitura de sessões existentes do CLI: últimas respostas, consulta de novidades e expansão de textos longos. Sem iniciar Claude ou consumir uso dele.
- Submissão, consulta paginada, cancelamento, retomada de sessão desta ponte e histórico local.
- Modelo e esforço explícitos; sem fallback ou repetição automática que aumente consumo.
- Só um processo servidor deve usar cada pasta de estado. Não rode dois clientes/servidores simultaneamente sobre a mesma configuração.
- Integração ponta a ponta no Chat normal ainda não validada.
Preparar no Windows
Requisitos: Node.js 22+ e histórico local do Claude Code (desenvolvido com 2.1.322). Ler arquivos existentes não exige login ativo no Claude. Para delegar tarefas novas, é preciso o executável instalado e login válido via claude auth login; essa execução usa o login local.
npm.cmd ci
Copy-Item orchestrator.config.example.json orchestrator.config.json
npm.cmd run doctor
npm.cmd test
npm.cmd run smoke
No arquivo orchestrator.config.json, cadastre apelidos e pastas dos projetos autorizados. Caminhos relativos são resolvidos em relação ao arquivo, não ao terminal. claudeCommand aceita claude pelo PATH ou caminho absoluto de claude.exe. Não use .cmd ou uma linha de shell. O arquivo de configuração e .orchestrator/ ficam fora do Git.
Ler respostas das sessões do CMD
Cadastre a pasta do projeto que você usa no CLI, por exemplo:
{
"projects": { "meu-projeto": "F:/projetos/meu-projeto" }
}
O leitor procura os arquivos .jsonl de sessões em ~/.claude/projects (ou CLAUDE_CONFIG_DIR/projects quando definido). A propriedade opcional claudeProjectsDirectory permite usar outro diretório de histórico; caminhos relativos são resolvidos a partir da configuração. A organização dos diretórios é um detalhe do Claude Code e pode mudar em versões futuras. O leitor também confere o projeto e a sessão declarados nos registros.
Fluxo para um cliente conectado ao servidor MCP:
claude_list_sessionscomproject: lista IDs de sessões, data de atualização, modelo e quantidade de registros de resposta; não devolve o conteúdo na listagem. O mesmo projeto pode ter várias sessões.claude_read_sessioncomprojectesession_idretornado pela listagem: últimas 5 respostas, até 2.000 caracteres por resposta. Uselimitemax_charspara ajustar. Respostas são blocos de texto salvos pelo CLI; um único turno pode produzir vários registros.- Para acompanhar novidades, repita a leitura com
afterigual aonext_afteranterior. Quandohas_morefor verdadeiro, continue com o novo cursor. Isso não dispara perguntas ao Claude. - Se uma resposta estiver
truncated, useclaude_read_responsecom oresponse_id(campoidda resposta),offsetelimit. Continue comnext_offsetaté ele ser nulo. O cursor de novidades não substitui a paginação do texto truncado.
Só entram blocos de texto do assistente. Prompts do usuário, raciocínio interno, entradas/saídas brutas de ferramentas e registros marcados como subagentes ficam de fora. O texto do próprio assistente ainda pode reproduzir trechos de código ou comandos. A leitura não captura a tela, barras de progresso, teclas digitadas ou tudo que o terminal imprime.
As sessões podem estar abertas ou encerradas; o leitor não afirma qual janela está ativa. Cada consulta é uma fotografia do que já foi salvo em disco. Uma gravação incompleta no final é ignorada até a próxima consulta, e linhas inválidas são contabilizadas. Consultas com cursor não detectam edição de um registro antigo: releia as respostas recentes para esse caso. Sessões acima de 64 MB dão erro explícito.
A leitura só acessa arquivos locais e não usa tokens do Claude. O conteúdo enviado ao ChatGPT passa a consumir contexto da conversa e pode conter informações privadas do projeto. Por padrão, apenas projetos cadastrados são expostos. Arquivos de histórico reais não devem ser adicionados ao repositório.
Teste real, que consome uma chamada da sua conta Claude:
npm.cmd run smoke -- --live
O teste descobre as ferramentas MCP, envia uma pergunta curta ao Haiku com esforço baixo e verifica PONTE_OK. Se a combinação não estiver disponível na sua conta, o erro é mostrado, sem trocar de modelo sozinho.
Conectar ao ChatGPT normal
A conexão no Chat normal é uma etapa separada. Não confunda teste MCP local com plugin funcionando no Chat.
- Confira em ChatGPT → Plugins → botão + se sua conta oferece Add custom MCP server e conexão Tunnel.
- O caminho preferido é o Secure MCP Tunnel, conectado a este servidor stdio. Ele exige um
tunnel_id, uma chave de API de runtime para otunnel-cliente permissões da organização/workspace. Não usamos a API de modelos da OpenAI, mas esta opção de transporte requer uma credencial da Platform. Confira também se a versão atual do cliente oferece suporte ao seu ambiente Windows. - Inicie o servidor do túnel com
node <caminho absoluto>/src/server.mjs, definindoORCHESTRATOR_CONFIGcomo o caminho absoluto do seu arquivo de configuração. Não publique arquivos de credenciais do túnel. - Cadastre a conexão real e confira as sete ferramentas. Abra um novo Chat normal, selecione o plugin e peça para listar sessões e ler a última resposta de um projeto cadastrado.
- Só considere concluído após a resposta aparecer no Chat normal.
Alternativa futura: transporte HTTP autenticado e HTTPS. Não está implementado neste protótipo. Não exponha stdio ou um terminal genérico à internet.
O pacote plugin.json + mcp.json descreve a execução local para um host compatível. Precisa de dependências instaladas e configuração acessível no host; não é um ZIP independente pronto para distribuição. Plugins desktop com execução local são limitados a conversas locais; esse pacote sozinho não resolve o Chat normal hospedado. Fontes oficiais: plugins, conexão e testes, limites de plugins locais.
Ferramentas
| Ferramenta | Uso |
|---|---|
orchestrator_status | Projetos disponíveis, modo e tarefa ativa; sem chamada ao Claude |
claude_list_sessions | Lista sessões existentes por projeto, sem chamada ao Claude |
claude_read_session | Últimas respostas ou novidades após um cursor, sem chamada ao Claude |
claude_read_response | Expande uma resposta longa em páginas, sem chamada ao Claude |
claude_submit_task | request_id, project, prompt, model, effort, resume_task_id opcional |
claude_get_task | task_id, offset, limit; sem chamada ao Claude |
claude_cancel_task | Encerra a tarefa ativa e seus subprocessos no Windows |
Após enviar, consulte o ID retornado com intervalos razoáveis. Repetir o mesmo request_id e parâmetros recupera a tarefa; trocar os parâmetros com o mesmo ID retorna erro. Uma sessão pode ser retomada usando resume_task_id de uma tarefa bem-sucedida no mesmo projeto. Não toma controle de uma janela do CMD já aberta.
Limites e consumo
Permissões usam --restricted, --safe-mode, ferramentas de leitura explícitas, MCPs externos desabilitados e negação de prompts não atendidos. Isso reduz a superfície de acesso, mas não substitui isolamento do sistema operacional. Arquivos lidos pelo Claude podem ir à Anthropic, e resultados retornados ao ChatGPT vão à OpenAI. Cadastre somente pastas apropriadas; esta versão não adiciona filtro próprio de arquivos secretos dentro delas.
Histórico local contém prompts e respostas. Exclua-o conforme sua política de retenção. Logs/resultados completos não são publicados no Git. A saída retornada é paginada para evitar trazer relatórios enormes ao chat; limite do processo: 2 MB e 120 s por padrão. Cancelar não desfaz consumo já realizado.
Tokens, cache e custo estimado são os valores reportados pelo CLI. O custo em dólares não comprova cobrança extra ou saldo da assinatura. Modelos, esforço e limites dependem da conta; combinações incompatíveis falham claramente. A ferramenta não implementa orçamento rígido por tokens nem garante economia.
O servidor não acorda uma conversa encerrada nem mantém um coordenador autônomo. Depois de reiniciar, tarefas em andamento ficam interrupted; confira processos anteriores antes de reenviá-las.
Próximas entregas
- Validar conexão e resposta no Chat normal da conta.
- Persistir plano, dependências e critérios de aceitação.
- Medir consumo por tarefa e definir regras de escolha/escalonamento com limites explícitos.
- Adicionar execução de alterações somente com o escopo e as permissões definidos.
Referência do executor: Claude Code CLI.