PocketSmith Read-only
officielEn lecture seule : transactions, budgets, prévisions et analyses de l’outil de finances personnelles PocketSmith.
Que pouvez-vous faire avec PocketSmith Read Only MCP ?
- Bilan de santé financière — Demandez un aperçu de votre patrimoine net, de votre rythme de dépenses par rapport au budget et de l’état du budget par catégorie.
- Comparaisons des dépenses — Comparez les dépenses entre deux périodes par catégorie et par bénéficiaire pour voir ce qui a changé.
- Détection des dépenses récurrentes — Repérez les abonnements et les factures récurrentes, avec leur fréquence et leur coût annuel total.
- Prévisions de trésorerie et de patrimoine net — Projetez les soldes des comptes et le patrimoine net à l’aide du moteur de prévision de PocketSmith.
- Recherche de transactions — Recherchez des transactions en les filtrant par date, catégorie, mot-clé ou statut.
- Liens directs — Obtenez un lien vers la page, le rapport ou la recherche filtrée PocketSmith exacte dont il est question.
Serveur MCP hébergé
npx add-mcp 'https://mcp-readonly.pocketsmith.com/mcp'S’installe dans Claude Code, Codex, Cursor et plus
Documentation
Serveur MCP
Connectez votre compte PocketSmith à tout assistant IA compatible avec le Model Context Protocol.
En connectant votre assistant IA à PocketSmith via le Model Context Protocol (MCP), vous lui donnez un accès direct à vos données financières, à vos budgets et à vos prévisions. Il peut vous fournir des analyses et des informations, ainsi qu’effectuer diverses actions pour vous.
Fonctionnalités
Le serveur MCP de PocketSmith permet aux assistants IA de consulter et de gérer vos données PocketSmith en votre nom. Au lieu de passer de votre assistant IA à PocketSmith, vous pouvez poser des questions et effectuer des actions en langage naturel :
- Examiner vos dépenses, vos budgets et votre valeur nette
- Rechercher et catégoriser des transactions
- Créer et mettre à jour des événements budgétaires
- Analyser les tendances et comparer les dépenses sur différentes périodes
- Vérifier l’état de synchronisation des flux bancaires et lancer leur actualisation
- Obtenir des liens directs vers la bonne page ou le bon rapport PocketSmith
Deux modes d’accès sont disponibles :
| Mode | Description | Méthode de connexion |
|---|---|---|
| Accès complet | Les 66 outils : consulter, créer, mettre à jour et supprimer | En un clic depuis le répertoire Claude ou ChatGPT |
| Lecture seule | 40 outils en lecture seule : consulter et analyser, sans modification | Configuration manuelle comme connecteur personnalisé (quelques étapes supplémentaires) |
La plupart des utilisateurs devraient choisir l’accès complet. Toute suppression nécessite toujours votre approbation explicite, et vous pouvez demander à l’assistant de vous consulter avant d’effectuer toute autre modification. Choisissez la lecture seule si vous voulez avoir la garantie que l’assistant ne pourra jamais modifier vos données.
Connexion
L’accès complet est proposé comme application répertoriée dans les répertoires Claude et ChatGPT : la connexion se fait donc en un seul clic. La lecture seule n’est pas encore répertoriée dans ces répertoires ; elle doit être ajoutée manuellement comme connecteur personnalisé à l’aide de l’URL indiquée dans la section Autres clients MCP ci-dessous.
Claude (claude.ai, Claude Desktop et applications mobiles)
Accès complet :
- Ouvrez PocketSmith Complete Access dans le répertoire Claude
- Cliquez sur Connect
- Vous serez redirigé vers PocketSmith pour autoriser l’accès
Les connecteurs sont associés à votre compte Claude. Une fois PocketSmith connecté sur claude.ai, il est également disponible dans Claude Desktop et les applications mobiles Claude.
Lecture seule :
- Sur claude.ai ou dans Claude Desktop, ouvrez Settings > Connectors
- Cliquez sur Add custom connector
- Saisissez un nom (par exemple, « PocketSmith Read-only ») et l’URL
https://mcp-readonly.pocketsmith.com/mcp - Cliquez sur Connect à côté du nouveau connecteur et autorisez l’accès dans 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
Claude Code vous invitera à vous authentifier via OAuth lors de la première utilisation.
ChatGPT (chatgpt.com et application de bureau)
Accès complet :
- Ouvrez PocketSmith dans le répertoire des applications ChatGPT sur chatgpt.com
- Cliquez sur Connect
- Vous serez redirigé vers PocketSmith pour autoriser l’accès
Les applications sont associées à votre compte ChatGPT. Une fois PocketSmith connecté sur chatgpt.com, il est également disponible dans l’application de bureau ChatGPT. S’il n’apparaît pas, redémarrez l’application de bureau.
Lecture seule :
La lecture seule doit être configurée sur chatgpt.com, et non dans l’application de bureau :
- Ouvrez Settings > Apps & Connectors et activez Developer mode (dans les paramètres avancés)
- Cliquez sur Create pour ajouter un connecteur personnalisé
- Saisissez un nom (par exemple, « PocketSmith Read-only ») et l’URL
https://mcp-readonly.pocketsmith.com/mcp - Cliquez sur Connect : vous serez redirigé vers PocketSmith pour autoriser l’accès
N’utilisez pas l’option Settings > Plugins > Add MCP server de l’application de bureau : les serveurs ajoutés de cette manière sont uniquement disponibles dans Codex, pas dans ChatGPT.
Espaces de travail Business/Enterprise/Edu : un administrateur de l’espace de travail doit d’abord activer l’application ou ajouter le connecteur depuis Workspace settings. Chaque utilisateur se connecte ensuite et autorise individuellement son propre compte PocketSmith.
Codex
Accès complet : si vous avez déjà connecté PocketSmith depuis le répertoire des applications ChatGPT, il sera automatiquement disponible dans Codex dès votre prochaine conversation. Sinon, ajoutez-le depuis la ligne de commande :
codex mcp add pocketsmith --transport http https://mcp.pocketsmith.com/mcp
Lecture seule :
codex mcp add pocketsmith-readonly --transport http https://mcp-readonly.pocketsmith.com/mcp
Codex vous invitera à vous authentifier via OAuth lors de la première utilisation.
Autres clients MCP
| Mode | URL |
|---|---|
| Accès complet | https://mcp.pocketsmith.com/mcp |
| Lecture seule | https://mcp-readonly.pocketsmith.com/mcp |
Tout client MCP compatible avec le transport HTTP et OAuth peut se connecter à l’aide de ces URL. Le serveur prend en charge OAuth 2.0 avec PKCE et publie ses métadonnées de découverte à /.well-known/oauth-authorization-server et /.well-known/oauth-protected-resource.
Authentification
L’authentification est gérée automatiquement via OAuth. Lors de votre première connexion, vous serez redirigé vers PocketSmith pour vous connecter et autoriser l’accès. L’assistant IA reçoit un jeton limité au mode d’accès choisi (complet ou lecture seule) et ne voit jamais votre mot de passe PocketSmith.
Les jetons sont chiffrés et sans état : rien n’est stocké sur le serveur MCP. Vous pouvez révoquer l’accès à tout moment depuis la page Applications autorisées PocketSmith.
Exemples d’utilisation
« Comment se passent mes finances ce mois-ci ? »
Demandez un bilan de santé financière pour obtenir un aperçu rapide :
Vous : Comment vont mes finances ce mois-ci ? Est-ce que je respecte mon budget ?
Utilise l’outil financial_health_snapshot pour présenter votre valeur nette, le rythme de vos dépenses du mois en cours par rapport au budget, des indicateurs de suivi budgétaire pour chaque catégorie et les actions à entreprendre, comme catégoriser les transactions non catégorisées.
« Quels abonnements est-ce que je paie ? »
Repérez les prélèvements récurrents que vous avez peut-être oubliés :
Vous : Peux-tu trouver toutes mes dépenses récurrentes et mes abonnements ? Je veux voir combien je paie chaque mois et le coût annuel total.
Utilise l’outil find_recurring_expenses pour analyser l’historique de vos transactions, repérer les prélèvements réguliers par bénéficiaire, déterminer leur fréquence et calculer leur coût annuel total.
« Compare mes dépenses à celles du mois dernier »
Découvrez comment la répartition de vos dépenses a changé :
Vous : Compare mes dépenses de ce mois-ci à celles du mois dernier. Quelles catégories ont augmenté ou diminué ?
Utilise l’outil spending_comparison pour détailler les deux périodes par catégorie et par bénéficiaire, en mettant en évidence les changements ainsi que les bénéficiaires apparus ou disparus.
« Fais le bilan de mes finances de mars »
Obtenez un bilan complet de fin de mois :
Vous : Fais un bilan complet de mars 2025 : revenus, dépenses, taux d’épargne et respect de mon budget.
Utilise l’outil month_end_review pour produire un rapport détaillé comprenant un récapitulatif des revenus et des dépenses, le taux d’épargne, les écarts budgétaires par catégorie, les principaux bénéficiaires, les transactions notables et un aperçu de la valeur nette.
« Catégorise mes transactions récentes »
Mettez de l’ordre dans les transactions non catégorisées :
Vous : J’ai plusieurs transactions non catégorisées de la semaine dernière. Peux-tu les examiner et les catégoriser pour moi ?
Utilise list_transactions pour trouver les transactions récentes non catégorisées, puis list_categories pour consulter l’arborescence de vos catégories, et update_transaction pour attribuer les catégories appropriées en fonction des noms des bénéficiaires. (Nécessite le mode d’accès complet.)
« Quel sera le solde de mon compte d’épargne dans 6 mois ? »
Projetez l’évolution du solde de vos comptes :
Vous : À quoi ressemblera le solde de mon compte d’épargne au cours des 6 prochains mois, d’après mon budget ?
Utilise cash_flow_forecast pour projeter les soldes à l’aide du moteur de prévision de PocketSmith, montrer l’évolution prévue de chaque compte et signaler les moments où les soldes pourraient passer sous un seuil de sécurité.
« Emmène-moi à la bonne page »
Obtenez un lien direct vers la bonne page ou le bon rapport dans l’application Web PocketSmith :
Vous : Comment mes dépenses d’épicerie ont-elles évolué au cours de l’année écoulée ? Donne-moi un lien pour que je puisse examiner ça moi-même.
Utilise get_trend_analysis pour résumer la tendance, puis navigate_to_trends pour créer un lien direct vers le rapport Tendances, préfiltré selon votre catégorie Épicerie et la période choisie, afin que vous puissiez poursuivre votre exploration dans PocketSmith. Tous les outils de navigation fonctionnent ainsi : l’assistant répond, puis vous fournit un lien vers la page, le rapport ou la recherche de transactions exacte dont il parlait.
Outils disponibles
Analyses (outils d’analyse combinée)
Ces outils combinent plusieurs appels d’API pour produire des analyses détaillées, prêtes à l’emploi :
| Outil | Fonctionnalité |
|---|---|
financial_health_snapshot | Valeur nette, rythme des dépenses, indicateurs de suivi budgétaire, actions à entreprendre |
month_end_review | Bilan complet d’une période : revenus et dépenses, taux d’épargne, écarts budgétaires, principaux bénéficiaires |
spending_comparison | Comparaison côte à côte de deux périodes par catégorie et par bénéficiaire |
find_recurring_expenses | Détection des abonnements et factures récurrentes, avec calcul du coût annuel |
cash_flow_forecast | Projections des soldes des comptes et alertes en cas de risque |
net_worth_forecast | Évolution de la valeur nette : tendances historiques, prévisions et projections de jalons |
forecast_accuracy | Comparaison des soldes réels et prévisionnels pour évaluer la fiabilité du budget |
Budgétisation
| Outil | Fonctionnalité |
|---|---|
get_budget | Analyse budgétaire par catégorie pour la période prévisionnelle |
get_budget_summary | Comparaison des dépenses et revenus réels au budget pour une période donnée |
get_trend_analysis | Tendances des dépenses par catégorie au fil du temps |
delete_forecast_cache | Forcer le recalcul du budget après des modifications groupées |
Transactions
| Outil | Fonctionnalité |
|---|---|
list_transactions | Rechercher et filtrer les transactions par date, catégorie, mot-clé et statut |
get_transaction | Obtenir tous les détails d’une transaction |
create_transaction | Ajouter une transaction |
update_transaction | Modifier une transaction (bénéficiaire, catégorie, libellés, notes, répartitions) |
delete_transaction | Supprimer une transaction |
Comptes et établissements
| Outil | Fonctionnalité |
|---|---|
list_accounts | Répertorier tous les comptes par utilisateur ou établissement |
get_account | Obtenir les détails d’un compte, notamment son solde et ses comptes enfants |
create_account / update_account / delete_account | Gérer les comptes |
update_account_display_order | Réorganiser les comptes |
list_institutions / get_institution | Consulter les établissements financiers |
create_institution / update_institution / delete_institution | Gérer les établissements |
list_transaction_accounts / get_transaction_account / update_transaction_account | Consulter et mettre à jour les comptes de transaction |
Catégories et règles
| Outil | Fonctionnalité |
|---|---|
list_categories / get_category | Afficher votre hiérarchie de catégories |
create_category / update_category / delete_category | Gérer les catégories |
list_category_rules / create_category_rule | Afficher et créer des règles de catégorisation automatique |
Événements budgétaires
| Outil | Fonctionnalité |
|---|---|
list_events / get_event | Afficher les événements prévisionnels du budget |
create_event / update_event / delete_event | Gérer les événements budgétaires récurrents et ponctuels |
Pièces jointes
| Outil | Fonctionnalité |
|---|---|
list_attachments / get_attachment | Afficher les reçus et les pièces jointes des documents |
create_attachment / update_attachment / delete_attachment | Gérer les pièces jointes |
assign_transaction_attachment / unassign_transaction_attachment | Associer/dissocier des pièces jointes à des transactions |
Flux de données
| Outil | Fonctionnalité |
|---|---|
get_data_feeds_connection_status | Vérifier l’état de synchronisation du flux bancaire et les détails du fournisseur |
refresh_data_feeds_connection | Lancer une synchronisation pour une ou toutes les connexions de flux bancaires |
Navigation
Ces outils génèrent des liens profonds afin que l’assistant puisse vous diriger vers la page PocketSmith exacte correspondant à la conversation, avec des filtres prédéfinis pour les comptes, les catégories et les dates appropriés, ainsi que tout autre contrôle de page nécessaire au rapport.
| Outil | Fonctionnalité |
|---|---|
navigate_to_transactions | Recherche de transactions, avec filtres prédéfinis par compte, catégorie, mot-clé ou date |
navigate_to_budget | Accéder à la page du budget, avec les paramètres de date et d’autres options contrôlables via le lien |
navigate_to_trends | Rapport de tendances des dépenses ou revenus d’une catégorie au fil du temps, avec toutes les options disponibles via le lien |
navigate_to_income_expense | Rapport des revenus et dépenses (compte de résultat), avec filtres, plages de dates et autres options disponibles via le lien |
navigate_to_cashflows | État des flux de trésorerie (tableau mensuel) |
navigate_to_net_worth | Page de la valeur nette, avec tous les filtres et autres options disponibles via le lien |
navigate_to_calendar | Calendrier des événements budgétaires et soldes planifiés et prévisionnels, avec plages de dates disponibles via le lien |
navigate_to_account_summary | Récapitulatif du compte pour un compte et un mois spécifiques |
Autres
| Outil | Fonctionnalité |
|---|---|
get_current_user / update_user | Afficher et mettre à jour le profil et les paramètres utilisateur |
list_labels | Afficher toutes les étiquettes de transaction |
list_saved_searches | Afficher les filtres de recherche de transactions enregistrés |
list_currencies / get_currency | Données de référence sur les devises |
list_time_zones | Données de référence sur les fuseaux horaires |
Modèle de données PocketSmith
Comprendre la hiérarchie de PocketSmith aide à formuler vos questions :
Institution (e.g. "Sample Bank")
→ Account (container/group, e.g. "Everyday Credit Card")
→ Transaction Account (where transactions live)
→ Scenario (where budget forecast events live)
- Institutions : banques ou prestataires financiers
- Comptes : regroupent un ou plusieurs comptes de transaction et scénarios
- Comptes de transaction : contiennent les enregistrements de transactions proprement dits
- Scénarios : contiennent les événements budgétaires qui alimentent le moteur de prévision de PocketSmith
- Catégories : organisées de manière hiérarchique (parent/enfant) et partagées entre tous les comptes
- Étiquettes : balises que vous pouvez ajouter aux transactions pour les regrouper de manière flexible
Confidentialité et sécurité
- Politique de confidentialité de PocketSmith : https://www.pocketsmith.com/legal/privacy-policy/
- Vos identifiants PocketSmith ne sont jamais communiqués à l’assistant IA
- Les jetons OAuth sont chiffrés avec AES-256-GCM et sont sans état (aucune donnée n’est stockée côté serveur)
- Toutes les communications API utilisent le chiffrement TLS
- Vous pouvez révoquer l’accès à tout moment depuis les applications autorisées PocketSmith
Assistance
- Aide et assistance : https://learn.pocketsmith.com
- Contacter l’assistance : help@pocketsmith.com