AlgoMaker pelo seu Claude — manual do cliente

O AlgoMaker é uma fábrica de estratégias de trading que roda no seu computador. Ela minera estratégias sobre dados históricos, testa a robustez de cada uma, monta uma carteira e executa na sua corretora. Quem opera a fábrica é o seu Claude — você conversa, o motor trabalha. Nenhum dado seu, nenhuma chave de corretora e nenhum capital sai da sua máquina.

0. O caminho inteiro, em uma olhada

Tudo até a etapa 5 é grátis. A licença só entra na 6.

1. O que é grátis e o que pede licença

2. O que você precisa ter

• Um Claude com plano Pro ou Max — o aplicativo de desktop (Mac ou Windows), o site claude.ai, ou o Claude Code no terminal. O uso do AlgoMaker sai da sua assinatura do Claude; não há custo de API.
• Windows 10/11 ou macOS (Linux funciona pelo caminho do terminal).
• Para minerar: pelo menos 4 núcleos e 8 GB de RAM. Mais núcleos, mais rápido.

3. Etapa 1 — Ligar o conector

O conector é como o seu Claude descobre o AlgoMaker. Escolha o seu Claude.

3a. Claude Desktop (app) ou claude.ai (site)

1. Abra Configurações (o seu nome ou a engrenagem, no canto) → Conectores.
2. Role até o fim e clique em Adicionar conector personalizado.
3. Abre a janela "Adicionar conector personalizado". Preencha assim:

Vai aparecer um aviso laranja: "Sem credenciais, qualquer pessoa com acesso à URL poderá usar este conector". É verdade e é proposital: este conector só orienta — ele não confere licença, não executa nada e não vê seus dados. O que tem valor roda na sua máquina, na etapa 3. 4. Clique em Adicionar. O conector aparece na lista com o nome que você deu. 5. Abra uma conversa nova. No campo de mensagem, clique no ícone de ferramentas (o + ou o ícone de conectores) e confira que AlgoMakers está ligado. 6. Pergunte: "O que é o AlgoMaker?" Se ele responder explicando o produto e o que é grátis, a etapa 1 está pronta.

Na primeira vez que o Claude usar uma ferramenta do conector, ele pode pedir sua permissão ("Permitir sempre" / "Permitir uma vez"). Pode permitir sempre: as três ferramentas desta etapa só devolvem texto.

3b. Claude Code (terminal)

1. Abra o Claude Code (claude no terminal, ou pela aba Code do app).
2. Digite, dentro do Claude, os dois comandos — um de cada vez:

/plugin marketplace add https://algomakers.com/claude/marketplace.json
/plugin install algomaker@algomakers

1. O primeiro comando pergunta se você confia no marketplace algomakers → confirme. O segundo instala o plugin algomaker e pergunta o escopo (usuário / projeto) → escolha usuário para valer em qualquer pasta.
2. Confira com /mcp: deve aparecer algomaker-onboarding conectado — e algomaker-motor, que é o motor inteiro (ver 5c: ele precisa do uv instalado; sem ele, aparece como falho).
3. Pergunte: "O que é o AlgoMaker?"

4. Etapa 2 — A conversa de orientação

Com o conector ligado, o Claude sabe três coisas: o que é o produto, como instalar na sua máquina e como a licença funciona. Nesta etapa ele ainda não minera — ele conduz você para a etapa 3. Frases que funcionam:

• "Como instalo no Windows?" / "Como instalo no Mac?" → os comandos, que o próprio agente roda.
• "Preciso pagar para testar?" → não; ele explica o que é grátis.
• "Já tenho uma chave de licença" → ele guarda para a hora certa e manda instalar primeiro.

5. Etapa 3 — Ligar o motor (é o que minera)

Não existe aplicativo para baixar. Em Windows, Mac e Linux instala-se só o motor, pelo uv, e a tela é o painel que ele serve no seu navegador (5d). O programa antigo de janela do Windows foi descontinuado: se você ainda o tem, feche-o e não abra mais. Nada se perde, a pasta de dados é a mesma.

5a. Windows (inclui Windows Server / VPS): dois comandos, sem instalador

O jeito mais simples é pedir ao Claude "instala o AlgoMaker nesta máquina": no Claude Code ele mesmo roda os comandos abaixo. Se for você a digitar, abra o PowerShell:

1. Instale o uv (uma vez só, não pede administrador):

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

1. Aqueça o motor (de um a três minutos na primeira vez) e registre-o no Claude:

& "$env:USERPROFILE\.local\bin\uvx.exe" --python 3.11 --index https://algomakers-mcp.vercel.app/claude/simple/ --from mm-engine==0.0.210 mm-engine --aquecer
& "$env:USERPROFILE\.local\bin\uvx.exe" --python 3.11 --index https://algomakers-mcp.vercel.app/claude/simple/ --from mm-engine==0.0.210 mm-engine --conectar-claude

Se você usa o aplicativo de chat do Claude (e não o Claude Code), acrescente --desktop na segunda linha. 3. Vá para a etapa 4 (fechar e abrir o Claude). Depois peça "abre o painel": a tela abre sozinha no seu navegador e passa a voltar sozinha quando o computador reinicia (o arranque automático é ligado nessa mesma chamada).

5b. macOS (e Linux): uma linha no terminal, sem instalador

1. Pergunte ao Claude "como instalo no Mac?". Ele devolve uma linha — é esta:

claude mcp add algomaker -- uvx --python 3.11 --index https://algomakers-mcp.vercel.app/claude/simple/ --from mm-engine==0.0.210 mm-engine --mcp

1. Abra o Terminal (Launchpad → Outros → Terminal, ou ⌘+Espaço e digite "Terminal").
2. Se você nunca instalou o uv, rode primeiro (uma vez só):

curl -LsSf https://astral.sh/uv/install.sh | sh

e feche e abra o Terminal. 4. Cole a linha do passo 1 e dê Enter. O uvx baixa o Python certo e o motor sozinho. Na primeira vez leva de um a três minutos (as dependências); depois é instantâneo. 5. Vá para a etapa 4.

5c. Claude Code (terminal ou aba Code do app): o plugin já traz o motor

Se você ligou o conector pelo plugin (3b), não precisa de mais nada além do uv: o plugin inclui o servidor algomaker-motor, que sobe o motor pelo uvx na primeira vez que o Claude abre. Instale o uv antes (uma vez só):

• Mac/Linux, no Terminal: curl -LsSf https://astral.sh/uv/install.sh | sh
• Windows, no PowerShell: powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Depois feche e abra o Claude (etapa 4). Em /mcp, algomaker-motor deve aparecer conectado. Se aparecer como falho, o uv não está no caminho: feche o Claude por completo e abra de novo depois de instalar o uv; se persistir no Mac, rode no Terminal a linha da seção 5b, que grava o caminho completo.

Claude Desktop no Mac, sem o Claude Code: Configurações → Desenvolvedor → Editar configuração abre o arquivo claude_desktop_config.json. Acrescente:

{
  "mcpServers": {
    "algomaker": {
      "command": "uvx",
      "args": ["--python", "3.11",
               "--index", "https://algomakers-mcp.vercel.app/claude/simple/",
               "--from", "mm-engine==0.0.210",
               "mm-engine", "--mcp"]
    }
  }
}

Salve, e vá para a etapa 4.

Onde ficam os seus dados: ~/Library/Application Support/AlgoMaker (Mac), ~/.local/share/algomaker (Linux), %APPDATA%\@mm\desktop (Windows).

5d. O painel: a tela do AlgoMaker no seu navegador (Windows, Mac e Linux)

O motor que o uvx instala traz a interface completa dentro dele. Ela abre no seu navegador, servida pelo próprio motor na sua máquina (127.0.0.1), sem nada na internet. É nela que você faz o que o agente não pode fazer: cadastrar a chave da corretora, armar dinheiro real, fechar posição.

1. Diga ao Claude: "abre o painel".
2. Ele devolve um link que começa com http://127.0.0.1:. Abra no navegador desta máquina. O link serve uma vez e vence em 5 minutos; se vencer, peça outro.
3. A tela é o AlgoMaker inteiro: Início, Construtor, Databank, Fábrica, Monitor, Configurações. No canto superior direito aparece engine pid:… — é o motor rodando.

O painel é um processo que fica: fechar o Claude não o derruba, e os robôs em papel ou LIVE que você armou nele continuam. Na próxima conversa o agente o encontra sozinho. Se o link disser "já foi usado" sem você ter aberto, alguém abriu antes — estranhe e peça outro.

Se o programa antigo de janela do Windows estiver aberto, o painel não sobe (os dois usam a mesma porta): feche-o e peça "abre o painel" de novo.

6. Etapa 4 — Fechar e abrir o Claude

Este passo não é opcional — é o que mais gente esquece. O Claude só lê a lista de conectores quando inicia. Feche o app do Claude por completo (no Mac: ⌘+Q; no Windows: pelo ícone da bandeja, "Sair") e abra de novo.

Como saber que deu certo: no ícone de ferramentas da conversa aparece um segundo conector, algomaker, com dezenas de ferramentas. Pergunte "qual é o status da minha licença?" — a resposta vem do motor na sua máquina: plano free, e o identificador da sua máquina.

Se não apareceu: no Windows, confira que o AlgoMaker está aberto; no Mac, rode a linha do uvx de novo e veja se o terminal reclama de algo. Depois reinicie o Claude mais uma vez.

7. Etapa 5 — A primeira carteira

O agente precisa saber quem você é antes de minerar — é proposital. Diga as quatro coisas:

"Meu capital é 10 mil dólares, aguento 20% de queda, quero crescimento, horizonte de 6 meses."

Depois:

"Monta uma carteira pra mim."

O que acontece, na ordem, e quanto demora:

1. Ele pergunta onde você vai executar: pela Bybit (robô no app) ou por um robô .mq5 (mesas tipo FTMO). Isso muda os dados, o custo e o tipo de ordem — não é detalhe.
2. Baixa os dados necessários (minutos).
3. Mede se cada ativo tem liquidez para o seu tamanho de lote — o "porteiro". Se não tem, ele recusa e diz o número. Isso é o produto funcionando.
4. Minera (de minutos a horas, conforme o processador), validando em três fatias de tempo — a última é um trimestre selado que nada influenciou.
5. Monta a carteira, mede correlação e coloca em simulação com preço real (papel).

Espere recusas. O funil descarta mais de 99% das candidatas. Poucas e sólidas é o objetivo.

8. Acompanhar a carteira

"Como está minha carteira?"

Três números que valem mais que a curva de capital:

• Retorno sobre o capital em risco — quanto rendeu sobre o que estava de fato posicionado, não sobre a conta inteira. É o que separa "pequena e boa" de "pequena e perdendo".
• Ocupação — quanto do tamanho projetado está no mercado. Se o modelo pede posição e a corretora não tem, o agente avisa: é ordem que não está entrando.
• Bloqueios da corretora — recusas que exigem ação sua (termos de um contrato, restrição regulatória, chave sem permissão), já com a ação escrita.

O monitor (desde a 0.0.209). Peça "abre o monitor": o agente devolve um link que você guarda e reabre quando quiser, no computador ou no celular — a tela se atualiza sozinha a cada 10 segundos e é só leitura (nada ali arma, para ou fecha). Vem em seis abas, sem rolagem infinita: Visão geral (patrimônio, resultado do dia, queda atual, aderência, a curva real sobre a faixa que o backtest projetou para o regime atual e o "esperado × vivo"), Aderência (um quadrado por setup, colorido pelo quanto entrega do prometido; toque para auditar o setup), Ativos (ganho por ativo, faixa dos últimos 14 dias e curva acumulada), Setups (tabela ordenável com filtro), Trades (cada fechamento é um ponto no tempo, tamanho pelo resultado; abaixo, o histórico por dia com filtros de ativo, saída e lado) e Posições (o que está aberto, com stop e alvo). Para abrir do celular, a máquina do motor precisa estar alcançável de fora: numa VPS o túnel público sobe sozinho; num PC, peça "liga o túnel" ao agente. Para só ver a tela, acrescente &demo=1 ao link — os números são inventados e a página diz isso.

9. Etapa 6 — Licença e dinheiro real

9a. Comprar

Quando você pedir "põe ao vivo", o motor recusa e responde com o endereço de compra: algomakers.com/comprar. Na página, escolha o plano e pague. A chave chega no e-mail da compra, enviada por support@algomakers.com, no formato MM-….

9b. Ativar

Cole a chave no chat:

"Ativa a licença: MM-XXXX-XXXX-…"

O agente valida no servidor e responde "A licença ficou travada NESTA máquina". A partir daí o motor renasce como PRO. A chave vale para uma máquina; para trocar, fale com o suporte. O agente nunca adivinha, gera ou completa uma chave — se ele pedir a chave, é porque você ainda não colou.

9c. Cadastrar a corretora

Isso é só você, numa tela — nunca pelo chat:

• No painel (Windows, Mac ou Linux): diga "abre o painel" (5d) e, na tela que abrir no navegador, Configurações → Conexões → Nova conexão: nome, chave de API e segredo da Bybit. A chave é digitada na página, nunca no chat. Ela precisa de permissão de negociação (Contract/Derivatives) e vence em 90 dias se não tiver IP fixo — o agente avisa 14 dias antes.
• Servidor seu (VPS): o agente prepara o envio e você confirma numa página local, lendo o que vai ser enviado.

O agente não pode gravar chave de corretora por conta própria: essa rota é bloqueada por construção, não por configuração.

9d. Armar o LIVE

O agente prepara tudo (carteira, tamanhos, stops) e não arma sozinho. Dois caminhos:

• No painel (5d): aba Monitor → Armar LIVE. Uma janela pede a confirmação e um segundo fator (você digita o reconhecimento). Na primeira vez, a tela pergunta se você quer participar da inteligência coletiva (só estatísticas em %; recusar não tira nada). LIVE pede licença de plano pago; sem ela o Monitor só simula.
• Mac com servidor (VPS): o agente abre no seu navegador uma página em http://127.0.0.1:… com o título do que vai ser armado e as amarras (conta, carteira, tamanhos). Você lê e clica em Confirmar e armar. A página vale poucos minutos e serve uma vez só — se expirar, peça ao agente para abrir outra.

A partir daí os robôs operam. Parar tudo o agente pode (kill-switch). Destravar é só você.

Se quiser que os robôs continuem operando com o computador desligado, o caminho é um servidor (VPS) — pergunte ao agente.

10. Problemas comuns

11. Privacidade

• Dados, chaves e capital ficam na sua máquina. O conector público em algomakers.com/mcp não confere chave nem executa nada — ele orienta.
• Com o seu consentimento (perguntado uma vez, antes do primeiro LIVE), o app envia estatísticas em porcentagem sobre como as estratégias se comportam ao vivo — nunca valores, nunca chaves, nunca identidade. Não participar não tira nenhuma função.

Dúvida em qualquer passo: pergunte ao próprio Claude — ele conhece a doutrina inteira da fábrica. Suporte humano: support@algomakers.com.