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 conector MCP requer um plano com acesso à API (TRADER ou superior). A URL do servidor é sempre a mesma; o que muda é como você se autentica: OAuth (mais simples) ou API key (para scripts e Claude Code).
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.
- portfolios: portfólios e suas sessões.
- metrics: métricas de desempenho.
- notes / profile: notas e dados do seu perfil.
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.
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.