Conectar um Assistente de IA via MCP
Equipe AlgoVesta · Última revisão: 9 de novembro de 2026
Dê ao Claude, ao ChatGPT ou ao Cursor uma conexão com escopo definido às suas contas da AlgoVesta, para que ele possa ler seu portfólio e executar ordens sob as suas próprias regras de risco.
Antes de começar
- Uma conta AlgoVesta. O teste de 7 dias é suficiente — você não precisa de um plano pago para testar isso.
- Um cliente MCP: Claude na web, no desktop ou no celular, Claude Code, Cursor, ChatGPT em um plano pago, Gemini CLI, ou qualquer outro que fale Model Context Protocol.
- Uma chave. Você não precisa de uma exchange conectada para começar: uma chave paper roda o conjunto completo de ferramentas contra um saldo virtual de $5,000, então você pode configurar tudo e treinar antes de qualquer conta real estar envolvida.
1. Crie seu link MCP
- Abra o painel da AlgoVesta e vá até a aba MCP Connection
- Clique em Create key, dê a ela um rótulo que diga onde ela vai viver (por exemplo
claude-desktopoucursor-laptop) - Escolha um escopo:
readapenas para perguntas sobre o portfólio,paperpara o conjunto completo de ferramentas contra o saldo virtual de $5,000, oulivepara ordens reais - Copie o endereço que aparece. Ele se parece com isto:
https://api.algovesta.com/u/avmcp_<your-key>/mcp
live pede um segundo fator — um código TOTP do seu aplicativo autenticador, ou um código enviado para o seu e-mail. Essa confirmação acontece no painel, com você presente. Um assistente nunca pode solicitar essa promoção por conta própria.2. Adicione-o ao Claude
- No Claude, abra Settings → Connectors
- Clique em Add custom connector
- Dê a ele um nome (
AlgoVesta) e cole seu link MCP no campo de URL - Salve e inicie uma nova conversa — as ferramentas aparecem na lista de ferramentas da conversa
Este conector sincroniza entre o Claude na web, no desktop e no celular, então adicioná-lo uma vez também cobre o seu celular. Se você preferir não colar um endereço secreto, a AlgoVesta também disponibiliza um endpoint OAuth 2.1 padrão em https://api.algovesta.com/mcp com PKCE (S256) e Dynamic Client Registration — aponte o conector para ele em vez disso e você será levado por uma tela normal de consentimento do navegador.
3. Adicione-o ao Claude Code
Um único comando registra o servidor via HTTP streamable:
claude mcp add --transport http algovesta https://api.algovesta.com/u/avmcp_<your-key>/mcp
Depois, execute claude mcp list para confirmar que o servidor está registrado e acessível.
4. Adicione-o ao Cursor ou ao ChatGPT
O Cursor lê um arquivo de configuração JSON. Adicione uma entrada em mcp.json:
{"mcpServers":{"algovesta":{"url":"https://api.algovesta.com/u/avmcp_<your-key>/mcp"}}}
O Gemini CLI usa a mesma entrada, mas nomeia o campo como httpUrl em vez de url. Todo o resto é idêntico.
O ChatGPT suporta conectores MCP personalizados em planos pagos, com o modo desenvolvedor ativado nas configurações. Adicione o conector lá e cole o mesmo link.
5. Verifique a conexão
- Inicie uma nova conversa no seu cliente
- Pergunte:
How is my portfolio? - O assistente deve chamar a ferramenta
get_portfolio_contexte responder com seus saldos reais e posições abertas — em uma chave paper, com o saldo virtual de $5,000
Se ele responder de forma genérica sem chamar uma ferramenta, o servidor não está conectado: o assistente está falando sobre negociação em geral, não sobre a sua conta. Verifique o link novamente e reinicie o cliente.
O que o assistente pode fazer depois de conectado
Vinte ferramentas são expostas. Quatorze delas leem ou simulam e não alteram nada: get_portfolio_context, get_market_price, get_trade_history, compare_venues, simulate_order, list_open_orders, list_strategies, verify_receipt, replay_channel e compile_policy. Seis delas movimentam ordens: place_order, close_position, modify_position, cancel_order, create_strategy e update_strategy.
Você não chama essas ferramentas pelo nome. Pergunte em linguagem natural — "o que eu tenho em carteira?", "quanto custaria 0.1 BTC agora?", "feche metade da minha posição em ETH" — e o assistente escolhe as ferramentas e as encadeia. Um stop-loss é exigido em toda posição que ele abre, e não existe ferramenta para remover um depois. Os esquemas completos de cada ferramenta estão na documentação para desenvolvedores.
Solução de problemas
401 unauthorized
A chave foi revogada, excluída, ou o endereço foi digitado incorretamente. Essa é a falha mais comum quando o link foi colado manualmente ou copiado com um espaço no final. Verifique se a chave ainda existe na aba MCP Connection; se existir, exclua-a e crie uma nova em vez de tentar consertar a string.
insufficient_scope
A ferramenta que o assistente tentou chamar precisa de um escopo maior do que o da chave. Uma chave read não pode chamar place_order, e uma chave paper não pode acessar uma conta real. Os escopos são hierárquicos, então uma ferramenta que exige paper recusa uma chave read. Aceite o limite ou emita uma nova chave com o escopo que você realmente precisa — mudar para live exige um segundo fator.
user_frozen
O kill switch está ativo na sua conta, o que interrompe todas as chaves de uma vez. Isso é proposital: é o freio de emergência. Descongele-o no painel quando quiser que a negociação seja retomada. Se você só queria cortar um cliente, revogue essa única chave em vez disso — as outras continuam funcionando.
rate_limited
Você excedeu 60 solicitações por minuto nessa chave. Limites mais rígidos se aplicam às ferramentas mais custosas: place_order fica limitado a 10 por minuto e replay_channel a 5 por hora. Aguarde e tente novamente. Ver isso repetidamente costuma significar que um agente está em loop, não que você está negociando rápido demais — vale a pena verificar o que o assistente está realmente fazendo antes de aumentar a taxa de solicitações.
Perguntas frequentes
paper roda contra um saldo virtual de $5,000 usando o conjunto completo de ferramentas. As ordens são casadas pelo mecanismo paper a preços reais de mercado, e as respostas têm a mesma aparência das reais, então o assistente se comporta exatamente como se comportaria com dinheiro real em jogo. Toda chave nova começa aqui. É o lugar sensato para passar a sua primeira semana.