Conectar o Claude ao TradingNote
Conecte o Claude (claude.ai, Claude Desktop ou Claude Code) ao TradingNote via conector MCP para que ele consulte suas contas, algoritmos, backtests e portfólios em linguagem natural.
O TradingNote expõe um servidor MCP (Model Context Protocol) público. Conectá-lo dá ao Claude um conjunto restrito de ferramentas para ler e trabalhar com seus dados —contas, operações, algoritmos, explorações, backtests, portfólios e métricas— direto do chat. Você pode usá-lo no claude.ai, Claude Desktop ou Claude Code. Este guia cobre o Claude Code, além da conexão via OAuth e via API key.
O que o Claude vê depende do seu plano: o teste grátis de 7 dias inclui todo o conector exceto operar ao vivo; o PRO tem leitura básica (perfil e contas) e o Claude diz quais ações exigem ELITE; o ELITE tem o conector completo. No FREE ou TRADER, o Claude só pode explicar seu plano. As API keys (para scripts e Claude Code) continuam exclusivas do ELITE. A URL do servidor é sempre a mesma; o que muda é como você se autentica: OAuth (mais simples) ou API key.
URL do servidor
Esta é a única URL que você precisa em qualquer cliente do Claude:
https://app.tradingnote.co/api/mcpComo conectar
O Claude Code é a CLI do Claude. A forma mais direta de conectá-lo é com uma API key do TradingNote passada como Bearer token. Primeiro gere a key, depois registre o servidor MCP.
- 1
Gere sua API key
No TradingNote vá em Ajustes → API Keys, crie uma nova key (você pode limitar permissões por categoria) e copie-a. Começa com «tn_» e só é exibida uma vez.
- 2
Registre o servidor no Claude Code
No seu terminal, execute o comando «claude mcp add» com a URL e sua key como header (veja o bloco de código abaixo). Substitua tn_<sua-key> pela key real.
- 3
Verifique a conexão
Execute «claude mcp list». Você deve ver «tradingnote» como conectado. Agora você pode pedir ao Claude para consultar suas contas, algoritmos ou backtests.
claude mcp add --transport http tradingnote https://app.tradingnote.co/api/mcp \
--header "Authorization: Bearer tn_<tu-key>"
# Verificar
claude mcp listPrefere OAuth no Claude Code? Também funciona: registre o servidor sem o header e o Claude abrirá o fluxo de autorização no navegador na primeira vez que usar uma ferramenta.
OAuth é a forma recomendada no claude.ai e Claude Desktop. Você não precisa copiar nenhuma key: o Claude descobre nossos endpoints automaticamente, registra-se como cliente e mostra uma tela de consentimento onde você autoriza o acesso.
- 1
Abra as configurações de conectores
No claude.ai vá em Settings → Connectors → Add custom connector. No Claude Desktop, a opção equivalente está nas configurações de conectores.
- 2
Cole a URL do servidor
Use https://app.tradingnote.co/api/mcp como URL do servidor. O Claude detectará OAuth automaticamente e mostrará um botão «Connect».
- 3
Faça login e autorize
Uma janela do TradingNote abrirá pedindo seu login (se você não estiver logado) e depois a tela de consentimento com as permissões solicitadas. Autorize e você voltará ao Claude com o conector ativo.
No claude.ai você também pode usar uma API key: ao adicionar o conector personalizado, se pedir headers personalizados adicione «Authorization: Bearer tn_…».
Permissões e scopes
As permissões são solicitadas no formato «categoria:nível». O nível read é somente leitura; write permite criar e editar (nunca apagar, modificar o saldo ou tocar operações fechadas). Ao gerar uma API key você pode limitar quais categorias ela concede.
- accounts: contas conectadas e seu status.
- operations: histórico de operações.
- strategies / strategyDev: algoritmos e seu desenvolvimento.
- backtesting: resultados de backtests e explorações, e suas sessões de backtest manual — o Claude pode criá-las, avançar o replay, ver o gráfico naquele instante (com indicadores e suas operações), abrir, ajustar e fechar operações simuladas e anotá-las. Dinheiro simulado: não toca nenhuma conta nem corretora.
- portfolios: portfólios e suas sessões.
- metrics: métricas de desempenho.
- notes / profile: notas e dados do seu perfil.
- copyTrading: seus masters e assinaturas de copy trading, seu histórico e sua gestão (veja abaixo).
Copy trading pelo Claude
Com a permissão copyTrading, o Claude vê seu Copy Master como você o vê no app e pode gerenciar o essencial sem sair do chat. As ferramentas são as mesmas no conector MCP e na API REST /api/v1/tools:
- list_copy_masters: suas contas master (status, visibilidade, seguidores, conta de origem).
- list_copy_subscriptions e get_copy_subscription: suas assinaturas seguidoras com seu modo de risco (riskMode), lote fixo, multiplicador, % de risco, lote máximo, cópia inversa, filtros e limites diários; o detalhe inclui as últimas cópias e os mapeamentos de símbolos.
- get_copy_logs: histórico de cópias de um master (executadas, rejeitadas, pendentes) com a latência de cópia (copyDelayMs) e o motivo de rejeição como código estável; filtra por status e intervalo de datas, com paginação. get_copy_trades e get_copy_signals retornam as cópias por assinatura e os sinais emitidos.
- pause_copy_subscription e resume_copy_subscription: pausam ou retomam uma assinatura sua (as posições já copiadas não são tocadas). Pausar é livre; retomar volta a copiar com dinheiro real, por isso exige confirm:true e o interruptor «Permitir operar ao vivo desde o Claude».
- update_copy_sizing: altera o tamanho e os limites de uma assinatura (riskMode, fixedLotSize, multiplier, riskPercent, maxLotSize, limites diários, filtros…). Move dinheiro real: exige confirm: true e, como o trading manual, o interruptor «Permitir operar ao vivo pelo Claude» em Ajustes → Acesso do Claude.
O Claude não pode criar nem apagar masters ou assinaturas, fechar as posições copiadas nem cancelar pendentes: essas ações continuam exclusivas do app. As ferramentas só veem o que é seu (seus masters e suas assinaturas).
O que o Claude NÃO pode fazer
- Apagar contas, portfólios ou operações.
- Modificar o saldo de uma conta ou operações fechadas.
- Sincronizar com corretoras ou colocar ordens em contas live.
- Mudar sua senha, email ou acessar o painel admin.
- Criar ou apagar masters e assinaturas de copy trading, nem fechar as posições copiadas.
O conjunto de ferramentas disponíveis é o único controle: se não existe uma ferramenta para uma ação, o Claude não pode invocá-la. Não há forma de uma conversa «burlar» esses limites.
O conector não aparece ou a autorização falha? Verifique se seu plano inclui acesso à API, se a URL é exatamente https://app.tradingnote.co/api/mcp e, se usar API key, se você a colou completa com o prefixo «tn_». Se persistir, fale conosco pelo Suporte.