Agni Folio

Rastreador pessoal de patrimônio e portfólio — 23 ferramentas com escopo OAuth para posições, desempenho, status FIRE, P&L de criptomoedas e gravações de transações com confirmação em mais de 20 mercados.

Ver em agnifolio.comExperimente este MCPPatrocinado

Documentação

Agni Folio disponibiliza um servidor Model Context Protocol (MCP). Aponte qualquer cliente compatível com MCP — Claude Desktop, ChatGPT, Cursor, Cline, Continue, ou o seu próprio — para o nosso servidor, faça login uma vez, e sua IA pode ler seus ativos, executar análises de portfólio e propor transações exatamente como a Astra faz dentro do aplicativo.

O que é

Model Context Protocol é uma especificação aberta para conectar assistentes de IA a dados e ferramentas externas. Em vez de colar seu portfólio no ChatGPT ou criar integrações personalizadas para cada ferramenta, o MCP oferece a qualquer cliente de IA uma maneira padrão de chamar funções tipadas em seus dados.

O servidor MCP da Agni Folio está em:

https://agnifolio.com/mcp

Ele fala JSON-RPC 2.0, suporta a versão 2025-03-26 do protocolo MCP e é protegido por OAuth 2.1 com PKCE.

Por que você pode querer isso

  • Use a IA que você já paga. Se você tem Claude Desktop, Cursor ou um plano Pro em outro lugar, não precisa usar a Astra dentro do aplicativo web da Agni Folio — sua IA existente pode responder perguntas sobre o portfólio diretamente com seus dados reais.
  • Traga seu próprio modelo. Execute um LLM local via um cliente compatível com MCP (Cline, Continue) e mantenha sua análise de portfólio totalmente no dispositivo após os dados serem obtidos.
  • Integre em fluxos de trabalho mais amplos. Peça à sua IA para “olhar meus ativos da Agni Folio e compará-los com a lista de observação neste documento do Notion” — o MCP permite que um assistente puxe de várias fontes em uma única conversa.
  • Crie automações. Qualquer ferramenta que fale MCP — incluindo scripts personalizados — pode consultar seu portfólio sem raspar a tela ou usar APIs não oficiais.

Clientes suportados

Qualquer cliente que implemente MCP 2025-03-26 com OAuth 2.1 deve funcionar imediatamente. Testado:

ClienteStatus
Claude Desktop✅ Suportado via Conectores → Adicionar conector personalizado (ou Desenvolvedor → Servidores MCP)
ChatGPT✅ Suportado via conectores personalizados (modo Desenvolvedor; Plus / Pro / Business / Enterprise)
Cursor✅ Suportado via configuração mcpServers
Cline✅ Suportado (extensão do VS Code)
Continue✅ Suportado (assistente de codificação de IA de código aberto)
Clientes MCP personalizados✅ Qualquer coisa que implemente a especificação MCP 2025-03-26

Como conectar

  1. Abra as configurações de MCP no seu cliente de IA. Cada cliente tem sua própria maneira de adicionar um servidor MCP remoto. Procure um campo “Servidor MCP remoto” ou “URL do servidor MCP personalizado”.
    • Claude Desktop
    • ChatGPT
    • Cursor
    • Cline / Continue / outros O Claude oferece duas maneiras de adicionar um servidor MCP remoto — use a que sua versão mostrar. Opção A — Conectores (versões mais recentes, recomendado) Vá para Configurações → Conectores, role até Conectores personalizados e clique em Adicionar conector personalizado (marcado como BETA). Preencha:
    • Nome — por exemplo, Agni Folio
    • URL do servidor MCP remoto — https://agnifolio.com/mcp Deixe as Configurações avançadas (ID do cliente OAuth / Segredo do cliente) em branco — a Agni Folio usa Registro Dinâmico de Cliente, então o Claude se registra automaticamente. Clique em Adicionar. Opção B — Desenvolvedor → Servidores MCP (versões mais antigas) Em Configurações → Desenvolvedor → Servidores MCP, clique em Adicionar e insira:
    https://agnifolio.com/mcp
    De qualquer forma, o Claude descobre o fluxo OAuth via .well-known/oauth-authorization-server e guia você pela tela de consentimento no primeiro uso.
  2. Aprove a tela de consentimento OAuth. Na primeira vez que seu cliente de IA chamar a Agni Folio, você será redirecionado para uma tela de consentimento mostrando:
    • Qual cliente está solicitando acesso (pelo nome)
      • Quais escopos ele deseja: agnifolio:read, agnifolio:write, ou ambos
      • As permissões em linguagem simples que esses escopos concedem Clique em Aprovar para conceder acesso, ou Negar para abortar. Nunca compartilhamos suas credenciais com o cliente de IA — apenas um token de acesso com escopo.
  3. Comece a fazer perguntas sobre o portfólio à sua IA. Abra seu chat habilitado para MCP e tente:
    • “Liste meus ativos da Agni Folio”
      • “Qual é a minha exposição a ações de tecnologia?”
      • “Adicione uma transação de compra de 100 ações da AAPL a $185 na minha conta de corretora” (mutação — requer escopo agnifolio:write) Sua IA descobrirá as ferramentas disponíveis, chamará a correta e responderá com seus dados reais.

O que sua IA pode fazer

Sua IA conectada recebe o mesmo catálogo de ferramentas que a Astra tem dentro da Agni Folio:

CapacidadeExemplos de ferramentasEscopo necessário
Ler ativoslist_holdings, get_entry_details, get_recent_transactionsagnifolio:read
Executar análisescompute_concentration, compute_xirr, get_dividend_summaryagnifolio:read
Propor alteraçõesadd_portfolio_entry, add_transaction, edit_entry, delete_entryagnifolio:write

Use tools/list (o método padrão de descoberta do MCP) para ver o catálogo ao vivo e atualizado de qualquer cliente.

Escopos — leitura vs escrita

EscopoConcedeRecomendado para
agnifolio:readLer ativos, executar análises, visualizar transaçõesAssistentes de IA somente leitura, painéis, pesquisa
agnifolio:writeTudo em read MAIS criar / editar / excluir entradas e transaçõesAssistentes de IA em que você confia para fazer alterações em seu nome

Você decide quais escopos conceder na tela de consentimento. A maioria dos usuários começa apenas com read e atualiza para write depois de ver como a IA se comporta.

Modelo de segurança

  • OAuth 2.1 + PKCE. Fluxo de código de autorização padrão da indústria — sem compartilhamento de senha, sem tokens copiados e colados.
  • Registro Dinâmico de Cliente (RFC 7591). Novos clientes MCP se auto-registram; você os aprova pelo nome na tela de consentimento.
  • Chamadas com escopo. Ferramentas somente leitura exigem agnifolio:read; ferramentas de mutação exigem agnifolio:write. Você escolhe quais conceder na tela de consentimento.
  • Trilha de auditoria por chamada. Cada execução de ferramenta é registrada: qual cliente chamou, qual ferramenta, quando. Você pode auditar seu próprio uso em Configurações → IA Conectada.
  • Revogável a qualquer momento. Desconecte um cliente em Configurações → IA Conectada. Solicitações futuras desse cliente são rejeitadas imediatamente.

Trilha de auditoria e gerenciamento de IA conectada

Abra Configurações → IA Conectada para:

  • Ver todos os clientes de IA conectados à sua conta, pelo nome
  • Revisar os escopos que cada um possui
  • Ver a última vez que cada cliente chamou o servidor
  • Revogar qualquer cliente com um clique (instantâneo — sem tempo de espera)

Cada chamada MCP externa aparece junto com a atividade no aplicativo da Astra na mesma visão de auditoria.

Descoberta OAuth (para desenvolvedores de clientes)

Se você está construindo ou depurando um cliente MCP, nossos endpoints de descoberta seguem a especificação:

# Authorization server metadata (RFC 8414)
curl https://agnifolio.com/.well-known/oauth-authorization-server

# Protected resource metadata
curl https://agnifolio.com/.well-known/oauth-protected-resource

Ambos retornam JSON declarando nossos authorization_endpoint, token_endpoint, registration_endpoint, revocation_endpoint, escopos suportados, tipos de resposta suportados e code_challenge_methods_supported: ["S256"].

A URL do recurso é https://agnifolio.com/mcp.

Quando o MCP é a ferramenta errada

  • Cotações de preço em tempo real durante o horário de mercado. O MCP da Agni Folio retorna preços diários em cache, não as cotações ao vivo. Use o aplicativo do seu corretor para preços no momento da execução.
  • Importações em massa únicas. Se você tem um extrato de corretora com 500 linhas, a página dedicada de Importação de Transações por IA é mais rápida e mais determinística do que pedir a uma IA externa para fazer o mesmo.
  • Conversas sensíveis de prestação de contas. Check-ins do Money Crew, configuração de indicado legado e outros fluxos de trabalho voltados para pessoas vivem dentro do aplicativo da Agni Folio — eles não são expostos via MCP.

O que vem a seguir