--- title: "Um controle de carteira que seu assistente de IA consegue ler" description: "Controle de carteira com IA e conector MCP somente leitura para Claude, ChatGPT e Cursor, além de API REST e CLI. Pergunte sobre suas ações e criptos." url: "https://sonarfolio.com/pt/ai-portfolio-tracker" language: "pt" updated: "2026-10-27" --- # Um controle de carteira que seu assistente de IA consegue ler Conecte o Sonar ao Claude, ChatGPT ou Cursor e pergunte sobre suas ações e moedas do seu jeito. Os mesmos dados estão disponíveis como API REST e ferramenta de linha de comando. Assistentes de IA explicam bem o mercado, mas não sabem o que você tem. Colar saldos em um chat é trabalhoso e no dia seguinte já está desatualizado. O Sonar dá ao seu assistente uma visão atual e somente leitura da sua carteira por meio de um conector MCP, para que as respostas partam das suas posições reais. ## O que você pode perguntar > Como minha carteira foi nesta semana e quais posições explicam a variação? > Quais são minhas cinco maiores posições e quanto da carteira elas representam? > Quais dos meus ativos estão com sentimento mais negativo do que há uma semana? > Para cada moeda que eu tenho, compare o crescimento de holders em 30 dias com a variação de preço. > Comprei 0,5 ETH ontem. Adicione à minha carteira. O assistente descreve os dados. As conclusões são suas: o Sonar não faz recomendação de investimento, e o conector também não. *Por meio de um conector, o assistente lê sua carteira quando você pede. A única coisa que ele pode gravar é uma posição que você pede para adicionar e depois confirma (✓).* ## O conector MCP MCP (Model Context Protocol) é o padrão que Claude, ChatGPT, Cursor e outros assistentes usam para chamar ferramentas externas. O servidor do Sonar oferece estas ferramentas: | Ferramenta | O que retorna | | ------------------ | ------------------------------------------------------------------------------------------------------------------------------ | | `get_portfolio` | Valor total, variação em 24 horas, lucro não realizado, alocação por ativo, classe e conta, maiores variações | | `list_holdings` | Cada posição por conta: quantidade, cotação, valor, custo, lucro e peso | | `list_held_assets` | Cada ativo que você tem com cotação, variação em 24 horas e dados sociais | | `get_asset` | Um ativo em detalhe: cotação, dados sociais, principais criadores, dados onchain de moedas no Standard, 90 fechamentos diários | | `search_assets` | Encontrar uma ação, ETF ou moeda por ticker ou nome | | `add_position` | Registrar uma posição que você descrever, depois de confirmar ativo, quantidade e custo com você | | `get_usage` | Seu plano, o que ele inclui e as requisições de hoje | Todas as ferramentas leem, exceto `add_position`, que só registra uma posição que você pedir. Nenhuma pode negociar, movimentar fundos, alterar contas conectadas ou apagar nada. ### Como conectar 1. Entre, abra **API e ferramentas de IA**, crie uma chave e copie a URL do conector. 2. **Claude** (web, desktop, celular): Configurações → Conectores → Adicionar conector personalizado. Dê um nome, cole a URL e salve. 3. **ChatGPT:** Configurações → Apps e conectores → Avançado, ative o modo desenvolvedor, crie um conector com a URL e sem autenticação e ative-o no menu de ferramentas de um chat. 4. **Claude Code, Cursor e outros clientes MCP:** use o servidor `https://sonarfolio.com/api/mcp` com sua chave como token Bearer. ``` claude mcp add --transport http sonar https://sonarfolio.com/api/mcp \ --header "Authorization: Bearer YOUR_KEY" ``` As instruções completas estão em [Desenvolvedores](https://sonarfolio.com/pt/developers). ## A API REST JSON sobre HTTPS com chave Bearer, para planilhas, painéis e scripts: - `GET /api/v1/me`: plano, acesso e uso de hoje - `GET /api/v1/portfolio`: totais, variação em 24 horas, lucro, alocação, variações - `GET /api/v1/holdings`: cada posição por conta - `POST /api/v1/holdings`: adicionar uma posição - `GET /api/v1/assets`: dados de mercado e sociais de cada ativo que você tem - `GET /api/v1/assets/{id}`: um ativo em detalhe - `GET /api/v1/assets/search`: encontrar o id de um ativo As respostas trazem a fonte e os horários dos dados, além de cabeçalhos de limite e créditos. ## A CLI Uma ferramenta de linha de comando sem dependências que usa a API: ``` npm install -g sonarfolio sonar login sonar portfolio sonar holdings --json | jq '.holdings[] | {symbol, value_usd}' ``` Entre os comandos: `portfolio`, `holdings`, `assets`, `asset`, `search`, `add` (pergunta antes de gravar) e `watch`, que mantém uma visão na tela. Todos aceitam `--json`. ## O que o assistente vê Só o que você tem. Dados sociais, dados onchain e detalhes de ativos cobrem os ativos da sua carteira, nunca o mercado inteiro. O Sonar nem tem seu login da corretora ou da exchange, chaves de API de exchanges nem as chaves das suas wallets. Seus dados só chegam a um assistente se você o conectar com sua própria chave e perguntar; revogue a chave e o acesso acaba. A carteira vem das suas fontes no Sonar: wallets em mais de 50 redes, corretoras e exchanges de cripto pelo Plaid no Starter, no Standard e no Premium, importações CSV e posições manuais. Todas as fontes no [controle de carteira de cripto e ações](https://sonarfolio.com/pt/crypto-and-stock-portfolio-tracker). ## Planos e créditos - **Starter ($7 por mês):** dados de mercado e sociais dos seus ativos nas ferramentas de IA e na API, 500 requisições por dia. - **Standard ($11 por mês):** acrescenta posições, lucro e alocação, além de dados onchain de moedas, 1.000 requisições por dia. - **Premium ($20 por mês):** o mesmo, com 2.000 requisições por dia. - **Toda conta, inclusive Free,** começa com 100 créditos de API, um por requisição, para testar o conector. Mais créditos custam $1 a cada 1.000, não expiram e valem em qualquer plano depois que a cota diária acaba. Os dados sociais das respostas continuam seguindo seu plano. Veja os [preços](https://sonarfolio.com/pt/pricing). ## Segurança As chaves de API são guardadas só como impressão digital; a chave completa aparece uma vez, ao ser criada. Quem tiver a chave ou a URL do conector pode ler os dados da sua carteira, então mantenha-as em sigilo e revogue-as na página de API se vazarem. A carteira por trás é somente leitura por princípio. Mais na [página de segurança](https://sonarfolio.com/pt/security). ## Perguntas frequentes ### Funciona nas versões gratuitas do Claude e do ChatGPT? Depende do que cada assistente permite na sua conta. Do lado do Sonar, funciona em todos os planos, com créditos de API no Free. ### O assistente pode negociar por mim? Não. O conector não pode negociar, movimentar fundos nem alterar suas contas. Ele só pode registrar uma posição que você pedir. ### Quais clientes MCP são compatíveis? Claude, ChatGPT, Claude Code e Cursor estão documentados, e qualquer cliente que fale MCP por HTTP com URL ou token Bearer pode se conectar. ### Posso testar sem conectar contas? Sim. Adicione algumas posições à mão, crie uma chave e pergunte. Ou explore antes a [carteira de exemplo](https://sonarfolio.com/pt/demo).