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:

text
https://app.tradingnote.co/api/mcp
Transporte: Streamable HTTP. O Claude descobre o resto sozinho.

Como 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. 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. 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. 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.

bash
claude mcp add --transport http tradingnote https://app.tradingnote.co/api/mcp \
  --header "Authorization: Bearer tn_<tu-key>"

# Verificar
claude mcp list

Prefere 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.

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.