Conector EGOS (@egosbr/conector)

Liga a sua IA (Claude Code, Codex ou Claude Desktop) ao EGOS na sua máquina. Esta versão traz o perfil diagnóstico: uma ferramenta, só leitura. O diagnóstico funciona sem conta; o resto pede licença.

Em 3 passos (menos de 10 minutos)

1. Instalar e ligar (Claude Code e Codex, de uma vez; precisa de Node 18.15 ou mais novo):

   npx -y @egosbr/conector instalar

   Sem conta, é só isso (no terminal ele pergunta o token; Enter segue sem). Se você recebeu um token para as demais ferramentas, use EGOS_TOKEN=<seu token> npx -y @egosbr/conector instalar.

   No Claude Desktop, dê dois cliques no arquivo egos-conector-<versão>.mcpb; o Claude pede o token num campo protegido.

2. Conferir: npx -y @egosbr/conector verificar mostra a ferramenta diagnostico_maquina e uma linha com o resultado.

3. Pedir à sua IA: "faça o diagnóstico da minha máquina".

O que o diagnóstico devolve: sistema e arquitetura, núcleos de CPU, memória total e livre (GB), disco livre na sua pasta pessoal (GB), versão do Node, e sim/não para Claude Code, Codex e Claude Desktop instalados. Nunca devolve caminho, nome de usuário ou nome da máquina, e não lê nenhum arquivo.

Opcional, detector de dados pessoais (Guard Brasil, CPF, CNPJ, e-mail, telefone): é um pacote à parte, instalado com um comando:

claude mcp add guard-brasil --scope user -- npx -y @egosbr/guard-brasil-mcp

(No Codex, acrescente um bloco [mcp_servers.guard-brasil] com command = "npx" e args = ["-y", "@egosbr/guard-brasil-mcp"].) Depois peça: "veja se este texto tem dado pessoal".

Detalhes da instalação (passo 1)

EGOS_TOKEN=<seu token> npx -y @egosbr/conector instalar

Ou só npx -y @egosbr/conector instalar: o instalador pede o token sem mostrar na tela, e Enter segue sem token (só o diagnóstico).

O comando:

1. se houver token, confere no servidor de licença (POST https://mcp.egos.ia.br/licenca, token no cabeçalho); sem token, não faz chamada nenhuma;
2. registra o conector egos no Claude Code (claude mcp add --scope user);
3. grava o bloco [mcp_servers.egos] no ~/.codex/config.toml (permissão 600).

Depois: npx -y @egosbr/conector verificar sobe o conector registrado e chama a ferramenta.

Claude Desktop: dê dois cliques no arquivo egos-conector-<versão>.mcpb. O Claude pede o token num campo protegido e o guarda no cofre do sistema.

O token (opcional para o diagnóstico)

• Nunca vai numa URL, nem é aceito na linha de comando (--token é recusado), porque ficaria no histórico do terminal, em print e em log.
• Fica como variável de ambiente do conector, na configuração do seu Claude Code ou Codex, ou no cofre do sistema (Claude Desktop).
• Revogado, o conector passa a recusar em até 60 segundos. Sem internet, ele continua funcionando por até 7 dias desde a última vez que o token foi confirmado nesta máquina; token nunca confirmado não funciona sem internet.
• Node 18.15 ou mais novo.

O que sai da máquina

| Sai | Não sai | |---|---| | Para o EGOS: só {versao} com o token no cabeçalho, para conferir a licença (só se você usa token; sem token, nada sai) | conteúdo de arquivo, caminho, nome de pasta, resultado do diagnóstico | | Para a sua IA (pela sua conta Anthropic ou OpenAI): o resultado do diagnóstico | |

A ferramenta diagnostico_maquina devolve sistema, memória, disco livre e quais clientes de IA estão instalados. Não lê arquivo nenhum e não devolve caminho nem nome de usuário.

Desenvolvimento

bun run build         # dist/cli.mjs (sem dependência em tempo de execução)
bun run test          # testes de aceite (unidade + máquina limpa simulada)
bun run mcpb          # dist/egos-conector-<versão>.mcpb (só empacota, não publica)

Plano e critérios de aceite: relatório 2026-10-09-conector-vps-instalacao.md (PCA-369:a).