Desenvolvedores
Use sua carteira em assistentes de IA, no terminal ou no seu próprio código. Tudo é somente leitura e cobre apenas os ativos que você tem.
Conecte seu assistente de IA
Pergunte ao Claude, ChatGPT, Claude Code ou Cursor sobre suas posições, ou adicione uma conversando.
Funciona em todos os planos do Claude, na web, no desktop e no celular. O plano gratuito inclui um conector personalizado.
Você entra no Sonar durante a configuração. Ainda não tem conta? Crie uma grátis.
URL do servidorhttps://sonarfolio.com/api/mcpAbra Customize e depois Connectors.
Abrir conectores do Claude(abre em uma nova aba)Selecione + Add e depois Add custom connector. Dê o nome Sonar e cole a URL do servidor.
Se for perguntado, escolha Sign in now e Use Claude's published identity, sem ID nem segredo do cliente, e depois Add.
Selecione Connect, entre e selecione Permitir. Em um chat, ative-o em + e depois Connectors.
Quais são minhas cinco maiores posições?Use o ChatGPT na web. Servidores MCP personalizados dependem do seu plano do ChatGPT; no Business e no Enterprise, um administrador pode precisar permiti-los.
Você entra no Sonar durante a configuração. Ainda não tem conta? Crie uma grátis.
URL do servidorhttps://sonarfolio.com/api/mcpAbra Plugins.
Abrir plugins do ChatGPT(abre em uma nova aba)Selecione + e depois Add custom MCP server. Dê o nome Sonar e cole a URL do servidor.
Defina Authentication como OAuth e deixe o ID e o segredo do cliente vazios. Aceite o aviso e selecione Create as a plugin.
Quando for pedido, entre e selecione Permitir. Depois instale-o pelos seus plugins e digite @ em um chat.
Quais são minhas cinco maiores posições?O ChatGPT pede confirmação antes de adicionar uma posição.
Para clientes com cabeçalho como Claude Code e Cursor, com uma chave de API.
Crie uma conta grátis e depois uma chave. Ela aparece só uma vez.
Obter sua chave de APIAdicione o Sonar ao seu cliente.
Claude Codeclaude mcp add --transport http sonar https://sonarfolio.com/api/mcp \ --header "Authorization: Bearer YOUR_KEY"
Cursor: ~/.cursor/mcp.json{ "mcpServers": { "sonar": { "url": "https://sonarfolio.com/api/mcp", "headers": { "Authorization": "Bearer YOUR_KEY" } } } }Outros clientes MCP: Streamable HTTP, cabeçalho Authorization: Bearer YOUR_KEYhttps://sonarfolio.com/api/mcpExecute
/mcpno Claude Code para verificar a conexão.
Ou sem chave: adicione a URL sem o cabeçalho, execute /mcp, escolha Sonar e selecione Authenticate.
Quais são minhas cinco maiores posições?Os conectores veem apenas os ativos que você tem. Eles podem adicionar posições que você descrever, mas não podem negociar, movimentar fundos nem excluir nada.
Solução de problemas
Não conecta ou não mostra ferramentas
Verifique se a URL termina em /api/mcp e se o login terminou com Permitir. Se não, remova o Sonar e adicione de novo.
O assistente diz que é preciso um plano ou créditos
Seu plano define o que o assistente vê; cada chamada de ferramenta é uma requisição. Veja requisições e créditos em API e ferramentas de IA.
Você desconectou um app ou revogou uma chave
O acesso para na hora. Para reconectar, remova o Sonar, adicione de novo e entre.
Você usa o Claude em um plano Team ou Enterprise
Um proprietário adiciona o Sonar uma vez com a URL do servidor; cada membro entra na própria conta.
REST API
JSON via HTTPS com uma chave Bearer. Cada endpoint tem uma ferramenta MCP e um comando da CLI correspondentes.
curl https://sonarfolio.com/api/v1/assets \ -H "Authorization: Bearer YOUR_KEY"
- GET/api/v1/meMCPget_usageCLIsonar statusPlano, acesso e uso de hojeStarter
- GET/api/v1/assetsMCPlist_held_assetsCLIsonar assetsDados de mercado e sociais de cada ativo que você temStarter
- GET/api/v1/assets/{id}MCPget_assetCLIsonar asset <SYMBOL>Um ativo que você tem: cotação, dados sociais, principais criadores, fechamentos de 90 diasStarter
- GET/api/v1/assets/search?q=MCPsearch_assetsCLIsonar search <QUERY>Encontre o ID de um ativo (apenas nomes)Starter
- GET/api/v1/portfolioMCPget_portfolioCLIsonar portfolioTotais, variação em 24h, L/P, alocação, maiores movimentosStandard
- GET/api/v1/holdingsMCPlist_holdingsCLIsonar holdings [--account NAME]Cada posição por contaStandard
- POST/api/v1/holdingsMCPadd_positionCLIsonar add <SYMBOL> <QUANTITY> [--cost --date --account]Adicionar uma posição: { asset_id, quantity, cost_usd?, date?, account? }Grava dados. Clientes MCP o veem marcado como destrutivo; a CLI pergunta antes (--yes pula a pergunta).Starter
As respostas incluem fonte, horários e nosso aviso legal, além dos cabeçalhos X-RateLimit-Limit, -Remaining, -Reset e X-Credits-Remaining. Erros: { error: { code, message } }.
Linha de comando
Os mesmos dados no seu terminal e nos seus scripts, com a mesma chave.
Instalar e entrar
npm install -g sonarfolio sonar login
Requer Node 18 ou mais recente. sonar login salva uma chave de API e ferramentas de IA; em scripts e CI, defina SONAR_API_KEY.
Mais opções de instalação
Execute a instalação de novo para atualizar. Teste sem instalar: npx -p sonarfolio sonar status. Instale direto deste site: npm install -g https://sonarfolio.com/cli/latest.tgz. Sua chave é salva em ~/.config/sonar/config.json, legível apenas por você.
Comandos
Os comandos aparecem junto aos endpoints REST, além de sonar watch [portfolio|assets] para uma visão ao vivo dentro do seu limite diário.
Em scripts
sonar holdings --json | jq '.holdings[] | {symbol, value_usd}'Todo comando aceita --json e imprime o JSON da API.
Limites e créditos
Cada chamada à API, chamada de ferramenta MCP ou comando da CLI é uma requisição. Os limites diários reiniciam às 00:00 UTC.
| Plano | Requisições incluídas | Cobre |
|---|---|---|
| Free | Só créditos de API | Preços e sua carteira |
| Starter | 500 por dia | Preços, dados sociais e adicionar posições |
| Standard | 1.000 por dia | Inclui posições, L/P, alocação e dados onchain |
| Premium | 2.000 por dia | Inclui posições, L/P, alocação e dados onchain |
Os nomes de plano na lista de endpoints mostram onde uma requisição está incluída; no resto, pagam os créditos de API, em qualquer plano. $1 compra 1.000, os créditos nunca expiram e toda conta começa com 100.