Conectar um Assistente de IA via MCP

Antes de começar

1. Uma conta AlgoVesta. O teste de 7 dias é suficiente — você não precisa de um plano pago para testar isso.
2. 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.
3. 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

1. Abra o painel da AlgoVesta e vá até a aba MCP Connection
2. Clique em Create key, dê a ela um rótulo que diga onde ela vai viver (por exemplo claude-desktop ou cursor-laptop)
3. Escolha um escopo: read apenas para perguntas sobre o portfólio, paper para o conjunto completo de ferramentas contra o saldo virtual de $5,000, ou live para ordens reais
4. Copie o endereço que aparece. Ele se parece com isto:

https://api.algovesta.com/u/avmcp_<your-key>/mcp

2. Adicione-o ao Claude

1. No Claude, abra Settings → Connectors
2. Clique em Add custom connector
3. Dê a ele um nome (AlgoVesta) e cole seu link MCP no campo de URL
4. 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

1. Inicie uma nova conversa no seu cliente
2. Pergunte: How is my portfolio?
3. O assistente deve chamar a ferramenta get_portfolio_context e 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.

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.