PocketSmith Read-only

npx add-mcp 'https://mcp-readonly.pocketsmith.com/mcp'

Servidor MCP

Conecte sua conta PocketSmith a qualquer assistente de IA compatível com o Model Context Protocol.

Ao conectar seu assistente de IA ao PocketSmith por meio do Model Context Protocol (MCP), ele terá acesso direto aos seus dados financeiros, orçamentos e previsões. Ele poderá fornecer insights e informações, além de realizar várias ações para você.

O que ele faz

O servidor MCP do PocketSmith permite que assistentes de IA leiam e gerenciem seus dados do PocketSmith em seu nome. Em vez de alternar entre seu assistente de IA e o PocketSmith, você pode fazer perguntas e realizar ações usando linguagem natural:

• Revisar seus gastos, orçamentos e patrimônio líquido
• Pesquisar e categorizar transações
• Criar e atualizar eventos de orçamento
• Analisar tendências e comparar gastos entre períodos
• Verificar o status de sincronização do feed bancário e iniciar atualizações
• Obter links diretos para a página ou o relatório certo no PocketSmith

Há dois modos de acesso disponíveis:

Modo	Descrição	Como conectar
Acesso completo	Todas as 66 ferramentas — ler, criar, atualizar e excluir	Um clique no diretório do Claude ou do ChatGPT
Somente leitura	40 ferramentas somente de leitura — visualizar e analisar, sem fazer alterações	Configuração manual como conector personalizado (algumas etapas extras)

A maioria das pessoas deve escolher o acesso completo. Para excluir qualquer coisa, sempre é necessária sua aprovação explícita, e você pode pedir ao assistente que confirme com você antes de fazer qualquer outra alteração. Escolha o modo somente leitura se quiser garantir que o assistente nunca possa alterar seus dados.

Conexão

O acesso completo está disponível como um aplicativo listado nos diretórios do Claude e do ChatGPT, então a conexão é feita com um único clique. O modo somente leitura ainda não está listado em nenhum dos diretórios, portanto precisa ser adicionado manualmente como um conector personalizado usando a URL em Outros clientes MCP abaixo.

Claude (claude.ai, Claude Desktop e aplicativos móveis)

Acesso completo:

1. Abra PocketSmith Complete Access no diretório do Claude
2. Clique em Connect
3. Você será redirecionado ao PocketSmith para autorizar o acesso

Os conectores estão vinculados à sua conta do Claude. Portanto, depois de conectar pelo claude.ai, o PocketSmith também estará disponível no Claude Desktop e nos aplicativos móveis do Claude.

Somente leitura:

1. No claude.ai ou no Claude Desktop, abra Settings > Connectors
2. Clique em Add custom connector
3. Insira um nome (por exemplo, "PocketSmith Read-only") e a URL https://mcp-readonly.pocketsmith.com/mcp
4. Clique em Connect ao lado do novo conector e autorize o acesso no PocketSmith

Claude Code

# Full access
claude mcp add pocketsmith --transport http https://mcp.pocketsmith.com/mcp

# Read-only
claude mcp add pocketsmith-readonly --transport http https://mcp-readonly.pocketsmith.com/mcp

O Claude Code solicitará que você autorize por OAuth no primeiro uso.

ChatGPT (chatgpt.com e aplicativo para desktop)

Acesso completo:

1. Abra PocketSmith no diretório de aplicativos do ChatGPT em chatgpt.com
2. Clique em Connect
3. Você será redirecionado ao PocketSmith para autorizar o acesso

Os aplicativos estão vinculados à sua conta do ChatGPT. Portanto, depois de conectar pelo chatgpt.com, o PocketSmith também estará disponível no aplicativo para desktop do ChatGPT. Se ele não aparecer, reinicie o aplicativo para desktop.

Somente leitura:

O modo somente leitura precisa ser configurado em chatgpt.com, não no aplicativo para desktop:

1. Abra Settings > Apps & Connectors e ative Developer mode (em Advanced settings)
2. Clique em Create para adicionar um conector personalizado
3. Insira um nome (por exemplo, "PocketSmith Read-only") e a URL https://mcp-readonly.pocketsmith.com/mcp
4. Clique em Connect — você será redirecionado ao PocketSmith para autorizar o acesso

Não use a opção Settings > Plugins > Add MCP server do aplicativo para desktop — os servidores adicionados ali só ficam disponíveis no Codex, não no ChatGPT.

Espaços de trabalho Business/Enterprise/Edu: primeiro, um administrador do espaço de trabalho precisa ativar o aplicativo ou adicionar o conector em Workspace settings. Depois, cada usuário conecta e autoriza individualmente sua própria conta PocketSmith.

Codex

Acesso completo: se você já conectou o PocketSmith pelo diretório de aplicativos do ChatGPT, ele estará disponível automaticamente no Codex a partir do próximo chat. Caso contrário, adicione-o pela linha de comando:

codex mcp add pocketsmith --transport http https://mcp.pocketsmith.com/mcp

Somente leitura:

codex mcp add pocketsmith-readonly --transport http https://mcp-readonly.pocketsmith.com/mcp

O Codex solicitará que você autorize por OAuth no primeiro uso.

Outros clientes MCP

Modo	URL
Acesso completo	https://mcp.pocketsmith.com/mcp
Somente leitura	https://mcp-readonly.pocketsmith.com/mcp

Qualquer cliente MCP compatível com transporte HTTP e OAuth pode se conectar usando essas URLs. O servidor é compatível com OAuth 2.0 com PKCE e publica metadados de descoberta em /.well-known/oauth-authorization-server e /.well-known/oauth-protected-resource.

Autenticação

A autenticação é feita automaticamente por OAuth. Na primeira conexão, você será redirecionado ao PocketSmith para entrar e conceder acesso. O assistente de IA recebe um token com escopo definido pelo modo de acesso escolhido (completo ou somente leitura) e nunca vê sua senha do PocketSmith.

Os tokens são criptografados e não mantêm estado — nada é armazenado no servidor MCP. Você pode revogar o acesso a qualquer momento na página de aplicativos autorizados do PocketSmith.

Exemplos de uso

"Como estou indo neste mês?"

Peça uma avaliação da sua saúde financeira para obter um resumo rápido:

Você: Como estão minhas finanças neste mês? Estou dentro do orçamento?

Usa a ferramenta financial_health_snapshot para mostrar seu patrimônio líquido, o ritmo de gastos do mês atual em comparação com o orçamento, indicadores de orçamento por categoria e itens que exigem atenção, como transações sem categoria.

---

"Quais assinaturas estou pagando?"

Encontre cobranças recorrentes que talvez você tenha esquecido:

Você: Você pode encontrar todas as minhas despesas recorrentes e assinaturas? Quero ver quanto pago por mês e o custo anual total.

Usa a ferramenta find_recurring_expenses para analisar seu histórico de transações, identificar cobranças regulares por favorecido, classificar a frequência e calcular o custo anual total.

---

"Compare meus gastos com os do mês passado"

Veja onde seus gastos foram diferentes:

Você: Compare meus gastos deste mês com os do mês passado. Quais categorias aumentaram ou diminuíram?

Usa a ferramenta spending_comparison para detalhar os dois períodos por categoria e favorecido, destacando o que mudou e quais favorecidos são novos ou deixaram de aparecer.

---

"Revise minhas finanças de março"

Faça uma revisão completa do fim do mês:

Você: Faça uma revisão completa de março de 2025 — receitas, despesas, taxa de poupança e meu desempenho em relação ao orçamento.

Usa a ferramenta month_end_review para gerar um relatório detalhado com resumo de receitas e despesas, taxa de poupança, variação do orçamento por categoria, principais favorecidos, transações relevantes e um retrato do patrimônio líquido.

---

"Categorize minhas transações recentes"

Organize as transações sem categoria:

Você: Tenho várias transações sem categoria da última semana. Você pode analisá-las e categorizá-las para mim?

Usa list_transactions para encontrar transações recentes sem categoria, depois list_categories para consultar a árvore de categorias e update_transaction para atribuir categorias adequadas com base nos nomes dos favorecidos. (Requer o modo de acesso completo.)

---

"Qual será o saldo da minha conta poupança daqui a 6 meses?"

Projete os saldos das suas contas:

Você: Como ficará o saldo da minha conta poupança nos próximos 6 meses, com base no meu orçamento?

Usa cash_flow_forecast para projetar os saldos usando o mecanismo de previsão do PocketSmith, mostrando a tendência de cada conta e sinalizando os pontos em que os saldos podem ficar abaixo de um limite seguro.

---

"Leve-me até lá"

Obtenha um link direto para a página ou o relatório certo no aplicativo web do PocketSmith:

Você: Como meus gastos com supermercado mudaram no último ano? Envie um link para eu poder analisar por conta própria.

Usa get_trend_analysis para resumir a tendência e, em seguida, navigate_to_trends para criar um link direto para o relatório de tendências — já filtrado pela categoria Supermercado e pelo período — para que você possa continuar explorando no PocketSmith. Todas as ferramentas de navegação funcionam assim: o assistente responde e, em seguida, fornece um link para a página, o relatório ou a pesquisa de transações exatos sobre os quais estava falando.

Ferramentas disponíveis

Insights (ferramentas de análise composta)

Estas ferramentas combinam várias chamadas de API para produzir análises detalhadas e prontas para uso:

Ferramenta	O que faz
financial_health_snapshot	Patrimônio líquido, ritmo de gastos, indicadores de orçamento e itens que exigem atenção
month_end_review	Revisão completa do período com receitas/despesas, taxa de poupança, variação do orçamento e principais favorecidos
spending_comparison	Comparação lado a lado de dois períodos por categoria e favorecido
find_recurring_expenses	Identifica assinaturas e contas recorrentes e calcula o custo anual
cash_flow_forecast	Projeções futuras de saldos de contas com alertas de zona de risco
net_worth_forecast	Trajetória do patrimônio líquido com tendências históricas, previsões e projeções de marcos
forecast_accuracy	Compara saldos reais com os previstos para avaliar a confiabilidade do orçamento

Orçamento

Ferramenta	O que faz
get_budget	Análise do orçamento por categoria para o período previsto
get_budget_summary	Valores reais de despesas/receitas em comparação com o orçamento para um período
get_trend_analysis	Tendências de gastos por categoria ao longo do tempo
delete_forecast_cache	Força o recálculo do orçamento após edições em massa

Transações

Ferramenta	O que faz
list_transactions	Pesquisa e filtra transações por data, categoria, palavra-chave e status
get_transaction	Obtém todos os detalhes de uma transação
create_transaction	Adiciona uma nova transação
update_transaction	Edita uma transação (favorecido, categoria, etiquetas, observações, divisões)
delete_transaction	Remove uma transação

Contas e instituições

Ferramenta	O que faz
list_accounts	Lista todas as contas por usuário ou instituição
get_account	Obtém os detalhes da conta, incluindo saldo e contas filhas
create_account / update_account / delete_account	Gerencia contas
update_account_display_order	Reordena contas
list_institutions / get_institution	Exibe instituições financeiras
create_institution / update_institution / delete_institution	Gerencia instituições
list_transaction_accounts / get_transaction_account / update_transaction_account	Exibe e atualiza contas de transações

Categorias e regras

Ferramenta	O que faz
list_categories / get_category	Visualizar sua hierarquia de categorias
create_category / update_category / delete_category	Gerenciar categorias
list_category_rules / create_category_rule	Visualizar e criar regras de categorização automática

Eventos de orçamento

Ferramenta	O que faz
list_events / get_event	Visualizar eventos de previsão de orçamento
create_event / update_event / delete_event	Gerenciar eventos de orçamento recorrentes e pontuais

Anexos

Ferramenta	O que faz
list_attachments / get_attachment	Visualizar anexos de recibos e documentos
create_attachment / update_attachment / delete_attachment	Gerenciar anexos
assign_transaction_attachment / unassign_transaction_attachment	Vincular/desvincular anexos a transações

Feeds de dados

Ferramenta	O que faz
get_data_feeds_connection_status	Verificar o status de sincronização do feed bancário e os detalhes do provedor
refresh_data_feeds_connection	Iniciar uma sincronização de uma ou todas as conexões de feed bancário

Navegação

Essas ferramentas geram links diretos para que o assistente possa direcionar você à página exata do PocketSmith relacionada à conversa — com filtros predefinidos para as contas, categorias e datas corretas, além de quaisquer outros controles na página necessários para o relatório.

Ferramenta	O que faz
navigate_to_transactions	Pesquisa de transações, com filtros predefinidos por conta, categoria, palavra-chave ou data
navigate_to_budget	Navegar até a página de orçamento, com configurações de data e outros controles que podem ser definidos pelo link
navigate_to_trends	Relatório de tendências dos gastos ou ganhos de uma categoria ao longo do tempo, com todos os controles disponíveis pelo link
navigate_to_income_expense	Relatório de receitas e despesas (demonstrativo de lucros e perdas) com filtros, períodos e outras opções disponíveis pelo link
navigate_to_cashflows	Demonstrativo de fluxos de caixa (tabela mês a mês)
navigate_to_net_worth	Página de patrimônio líquido, com todos os filtros e outras opções disponíveis pelo link
navigate_to_calendar	Calendário de eventos e saldos de orçamento programados e previstos, com períodos disponíveis pelo link
navigate_to_account_summary	Resumo da conta para uma conta e um mês específicos

Outros

Ferramenta	O que faz
get_current_user / update_user	Visualizar e atualizar o perfil e as configurações do usuário
list_labels	Visualizar todos os rótulos de transação
list_saved_searches	Visualizar filtros salvos de pesquisa de transações
list_currencies / get_currency	Dados de referência de moedas
list_time_zones	Dados de referência de fusos horários

Modelo de dados do PocketSmith

Entender a hierarquia do PocketSmith ajuda ao fazer perguntas:

Institution (e.g. "Sample Bank")
  → Account (container/group, e.g. "Everyday Credit Card")
      → Transaction Account (where transactions live)
      → Scenario (where budget forecast events live)

• Instituições representam bancos ou provedores financeiros
• Contas agrupam uma ou mais contas de transação e cenários
• Contas de transação contêm os registros reais de transações
• Cenários contêm eventos de orçamento que alimentam o mecanismo de previsão do PocketSmith
• Categorias são hierárquicas (pai/filho) e compartilhadas entre todas as contas
• Rótulos são tags que você pode adicionar às transações para agrupá-las com flexibilidade

Privacidade e segurança

• Política de privacidade do PocketSmith: https://www.pocketsmith.com/legal/privacy-policy/
• Suas credenciais do PocketSmith nunca são compartilhadas com o assistente de IA
• Os tokens OAuth são criptografados com AES-256-GCM e são sem estado (nada é armazenado no servidor)
• Toda a comunicação com a API usa criptografia TLS
• Você pode revogar o acesso a qualquer momento em aplicativos autorizados do PocketSmith

Suporte

• Ajuda e suporte: https://learn.pocketsmith.com
• Entre em contato com o suporte: help@pocketsmith.com