Avant de commencer
Vérifiez d’abord le service et la version de l’application.
Ce parcours concerne le service partagé de la version internationale iOS. app.squirrelly.ai reste le domaine du service et de l’API ; aucun logiciel ni accès Web n’est requis. La même adresse e-mail peut correspondre à des comptes distincts sur d’autres services.
| Version du compte | État actuel |
|---|---|
| Service international iOS partagé | Test de connexion · Nouvelle application requise |
| Fonction native requise | Réglages → Connexions des agents. Une nouvelle version native est requise ; sa présence dans les versions installées ou sur l’App Store n’est pas garantie. |
| Comptes distincts Android Play internationaux | Pas encore intégrés |
| Comptes distincts des versions chinoise, HarmonyOS, etc. | Pas encore intégrés |
Seul le service international iOS partagé est concerné. Les services indépendants Android Play, Chine et HarmonyOS ne sont pas activés. Si Connexions des agents manque, mettez à jour ou attendez la version compatible. Ne créez pas de compte Web de remplacement.
Étape 01
Copier le numéro de compte dans l’application
- Ouvrez Réglages → Connexions des agents dans l’application native.
Utilisez votre compte existant, déjà connecté dans l’application. Guide pour ouvrir l’application ↗ explique seulement comment ouvrir l’application ; cette page ne permet ni connexion Web ni gestion de compte Web.
- Vérifiez que votre version propose cette fonction.
Ce parcours nécessite une nouvelle version native avec Connexions des agents. Si la rubrique manque, mettez à jour ou attendez sa sortie. Les versions actuellement installées ou sur l’App Store ne sont pas présumées compatibles.
- Copiez le numéro global depuis Connexions des agents.
Le numéro commence par
ZXM-. Un même compte sur le même service conserve son numéro. Saisissez-le dans la demande du navigateur pour identifier le compte et son service.
Le numéro permet de retrouver le bon compte ; ce n’est pas un mot de passe. Un accord explicite dans l’application native connectée au compte correspondant est indispensable.
Voir comment ouvrir l’application ↗Étape 02 · ChatGPT
Ajouter Squirrelly dans ChatGPT
Voici la procédure de test pour un MCP personnalisé, et non une installation en un clic depuis un catalogue de plugins. L’accès dépend de votre compte ChatGPT et des règles de votre espace de travail.
- Ouvrez la page Plugins de ChatGPT.
Accédez à ChatGPT Plugins ↗, sélectionnez le bouton plus, puis Add custom MCP server (Ajouter un serveur MCP personnalisé). Si cette option n’apparaît pas, consultez les questions fréquentes ci-dessous.
- Renseignez les informations de connexion.
Nommez le plugin « squirrellyai » et choisissez un point d’accès HTTPS public. Collez l’adresse complète, en conservant la terminaison
/mcp.
Configuration ChatGPT, avec les paramètres OAuth avancés
| Paramètre | Valeur correcte |
|---|---|
| Nom | squirrellyai |
| Adresse du serveur | https://mcp.squirrelly.ai/mcp |
| Méthode d’authentification | OAuth |
| Méthode d’enregistrement | Client OAuth personnalisé |
| ID client OAuth | squirrelly-chatgpt |
| Secret client | Laisser vide |
| Méthode d’authentification du point d’accès Token | none |
| URL d’enregistrement | Laisser vide |
| Activer OIDC | Ne pas cocher |
Développez « Paramètres OAuth avancés » et remplissez chaque champ selon le tableau. L’ID client doit être squirrelly-chatgpt ; ne le remplacez ni par le nom du plugin ni par le numéro de compte.
Les messages DCR et CIMD indisponibles indiquent que le serveur ne propose pas ces deux méthodes d’enregistrement automatique. Choisissez « Client OAuth personnalisé » et suivez le tableau. Laissez l’URL d’enregistrement vide et n’activez pas OIDC.
Conservez les cinq portées demandées par défaut : account:read, books:read, transactions:read, transactions:create, summaries:read. Laissez les portées d’autorisation de base vides.
- Terminez la création, installez ou activez le plugin, puis connectez votre compte.
Créez le plugin personnel selon les instructions de ChatGPT, puis installez-le ou activez-le et choisissez « Connecter un compte ». La création ne donne pas accès au compte : l’accord dans l’application reste nécessaire. Testez ensuite les six outils : compte, livres, ajout d’opérations, recherche, synthèse et résultat des écritures.
- Déclenchez OAuth, puis autorisez l’accès comme décrit ci-dessous.
Quand OAuth ouvre la demande Squirrelly, saisissez le numéro copié dans l’application. Gardez ce navigateur ouvert ; vous approuverez l’accès dans l’application.
- Créez une conversation et activez la connexion.
Activez le plugin Squirrelly créé, en suivant l’interface actuelle de ChatGPT. Dans les interfaces compatibles, saisissez
@pour le sélectionner. Effectuez ensuite la vérification en lecture seule décrite plus bas.
La présence de squirrellyai dans vos plugins personnels ChatGPT confirme sa création. Installez ou activez ce plugin, connectez votre compte Squirrelly, approuvez dans l’application, puis testez les outils. Il est inutile de le recréer.
Avancé : vérifier les points d’accès OAuth et l’URI de redirection
Ce client n’a actuellement qu’une seule URL de rappel exacte enregistrée :
https://chatgpt.com/connector_platform_oauth_redirectSi l’hôte affiche une autre URI de redirection, par exemple propre à une connexion, l’administrateur doit enregistrer cette URI exacte. N’utilisez pas de caractère générique et ne remplacez pas le domaine. Les autres agents nécessitent leur propre client et ne doivent pas réutiliser ce client ChatGPT. DCR et l’enregistrement CIMD général ne sont pas disponibles.
Vérifier les points d’accès OAuth découverts automatiquement
| Paramètre | Valeur correcte |
|---|---|
| URL d’autorisation | https://mcp.squirrelly.ai/oauth/authorize |
| Token URL | https://mcp.squirrelly.ai/oauth/token |
| URL de base du serveur d’autorisation | https://mcp.squirrelly.ai |
| Ressource | https://mcp.squirrelly.ai/mcp |
Le service réel a été vérifié avec le client SDK MCP officiel, mais les appels finaux aux outils dans un véritable compte ChatGPT restent à valider. La création du plugin personnel ne signifie ni autorisation du compte ni appels réussis, et ne constitue pas une publication en catalogue ou une approbation OpenAI.
Sources de la procédure : Guide de connexion officiel d’OpenAI · Documentation de l’authentification OAuth. Vérifié le 2026-10-30.
Compétence de saisie rapide
Installer la compétence squirrelly avec une seule commande
Choisissez la commande adaptée à votre ordinateur et à votre client pour télécharger et installer squirrelly automatiquement. Configurez MCP et approuvez OAuth dans l’application séparément, puis utilisez le raccourci de compétence.
Télécharger et installer automatiquement
Copiez la commande adaptée dans le terminal de votre ordinateur ou confiez-la à un agent pouvant exécuter des commandes locales. Elle télécharge, vérifie et installe la compétence sans décompression manuelle.
macOS
macOS : exécutez la commande dans Terminal avec les outils du système. Aucune installation supplémentaire de Python ou Homebrew n’est nécessaire. Choisissez la commande de votre client.
/bin/bash -o pipefail -c 'curl -fsSL --proto =https --proto-redir =https https://mcp.squirrelly.ai/downloads/install-macos.sh | /bin/bash -s -- "$@"' -- --client codex/bin/bash -o pipefail -c 'curl -fsSL --proto =https --proto-redir =https https://mcp.squirrelly.ai/downloads/install-macos.sh | /bin/bash -s -- "$@"' -- --client claude-codeVoir le script d’installation · macOS ↗
Windows
Windows : exécutez dans PowerShell. Windows PowerShell 5.1 et PowerShell 7 sont pris en charge. Choisissez la commande de votre client.
& ([scriptblock]::Create((Invoke-RestMethod -Uri 'https://mcp.squirrelly.ai/downloads/install-windows.ps1'))) -Client codex& ([scriptblock]::Create((Invoke-RestMethod -Uri 'https://mcp.squirrelly.ai/downloads/install-windows.ps1'))) -Client claude-codeVoir le script d’installation · Windows ↗
L’installateur vérifie SHA-256 et installe uniquement les fichiers de la compétence. Il n’écrase pas par défaut un contenu existant différent. Pour mettre à jour, ajoutez --update sur macOS ou -Update sur Windows ; les fichiers existants sont d’abord sauvegardés.
Rechargez le client ou ouvrez une nouvelle session après installation. Utilisez $squirrelly dans Codex et /squirrelly dans Claude Code. L’installation ne configure pas MCP et ne termine pas OAuth ; connectez le service et approuvez dans l’application séparément.
Une page Web ne peut pas installer silencieusement des compétences locales. ChatGPT sur le Web utilise une connexion par plugin ; ces commandes concernent les clients autorisés à exécuter des commandes locales.
Télécharger le ZIP manuellement (solution de repli)
Si le client ne permet pas les commandes locales, utilisez l’import ZIP ci-dessous lorsqu’il est pris en charge. Les possibilités dépendent du client.
- Téléchargez manuellement le ZIP en solution de repli.
Télécharger la compétence squirrelly en ZIP, décompressez-le manuellement et consultez INSTALL.md. Le paquet contient les fichiers de la compétence, sans mot de passe de compte ni jeton.
- Installez-la selon les consignes du client.
Dans Codex, placez le dossier squirrelly dans votre répertoire personnel de compétences, puis utilisez dans une nouvelle session
$squirrelly; les clients compatibles avec ce type de répertoire peuvent enregistrer, selon leurs instructions,/squirrelly. Le nom de la commande dépend du client ; MCP ne l’ajoute pas automatiquement.
Connectez d’abord MCP et terminez l’autorisation OAuth. La compétence guide seulement l’agent dans l’utilisation des outils ; elle n’accorde aucun accès au compte. Aucune écriture n’est créée sans connexion, ni lorsque la date, la devise ou le livre ne sont pas clairs.
/squirrelly Aujourd’hui, j’ai acheté un vêtement pour 2000 yuans chinois (CNY).
Dans l’interface actuelle de ChatGPT, vous pouvez sélectionner le plugin avec @. Les commandes commençant par une barre oblique ne fonctionnent pas dans tous les clients ; suivez les instructions d’installation du paquet pour choisir le point d’entrée adapté.
Étape 02 · Autres agents
Connecter différents agents au même service
Choisir les étapes adaptées à votre client
| Client | Étapes |
|---|---|
| ChatGPT sur le Web | Créez ou activez le plugin à l’aide du tableau ChatGPT ci-dessus, puis connectez votre compte et autorisez l’accès dans l’App. Aucune installation locale de compétence n’est nécessaire. |
| Codex | Installez la compétence avec la commande macOS ou Windows ci-dessous. Configurez MCP séparément et autorisez l’accès dans l’App ; rechargez le client puis utilisez $squirrelly. |
| Claude Code | Installez la compétence avec la commande macOS ou Windows ci-dessous. Configurez MCP séparément et autorisez l’accès dans l’App ; rechargez le client puis utilisez /squirrelly. |
L’hôte doit prendre en charge MCP distant via Streamable HTTP et OAuth avec code d’autorisation / PKCE. Les réglages et fonctions disponibles varient selon le produit ; n’appliquez pas directement les étapes de l’interface ChatGPT.
- Repérez les réglages MCP distant ou serveur d’outils de l’hôte.
Saisissez
https://mcp.squirrelly.ai/mcpet choisissez OAuth pour l’authentification. - Enregistrez un client OAuth propre à cet agent.
L’administrateur doit enregistrer le nom de l’application, un ID client distinct et l’URL de rappel exacte fournie par l’hôte.
squirrelly-chatgptest réservé à l’URL de rappel ChatGPT enregistrée ; les autres produits ne peuvent pas le réutiliser directement. - Approuvez l’accès dans l’application native.
Après l’enregistrement du client, suivez le même parcours d’accord dans l’application ci-dessous. Gardez le navigateur d’origine ouvert pour terminer OAuth. Les hôtes limités à stdio local, aux clés API statiques ou sans OAuth ne peuvent pas se connecter directement.
Les développeurs peuvent aussi intégrer leurs propres agents via HTTP API. La prise en charge du protocole offre une possibilité d’intégration, sans garantir que chaque produit a déjà été testé.
Étape 04
Vérifiez la connexion avant votre première écriture
Procédez de préférence dans cet ordre. Les boutons de copie copient uniquement du texte ; ils n’envoient aucune demande et ne créent aucune écriture automatiquement.
Avec Squirrelly, consulte le compte et le livre actuellement autorisés, sans ajouter d’écriture pour l’instant.
Vérifiez que le numéro de compte et le livre renvoyés correspondent au compte actuel de l’application et à son unique livre. Ensuite, soumettez une recette ou une dépense que vous souhaitez réellement enregistrer.
Enregistre avec Squirrelly : j’ai dépensé 35 yuans chinois (CNY) pour le déjeuner aujourd’hui, dans le livre actuellement autorisé.
L’écriture n’est enregistrée que lorsque le service le confirme explicitement. Ouvrez ensuite le livre correspondant dans votre compte Squirrelly d’origine pour vérifier le montant, la date et la devise.
Après la connexion
Gérez ces opérations directement dans la conversation
Enregistre avec Squirrelly : j’ai reçu aujourd’hui un salaire de 8000 yuans chinois (CNY).
Avec Squirrelly, affiche les dépenses de cette semaine, en commençant par les 20 plus récentes.
Avec Squirrelly, résume les recettes, dépenses et le solde de ce mois, en séparant les devises.
Précisez le montant, la devise et la date, et utilisez le livre actuellement autorisé. Cette première version ne permet pas aux agents de modifier ou supprimer les anciennes opérations, ni les virements, prêts ou imports en masse.
Si l’agent indique un résultat inconnu, demandez-lui de vérifier le résultat de l’opération initiale ou de réessayer avec le même identifiant de requête. Ne répétez pas la même écriture avec de nouvelles requêtes. Le service utilise des enregistrements de déduplication pour éviter les doublons lors des tentatives réseau.
Gardez le contrôle
Révoquer l’accès ou changer de compte
- Ouvrez Réglages → Connexions des agents dans l’application native.
Repérez le client autorisé et vérifiez son livre et ses permissions dans l’application.
- Révoquez l’accès de ce client dans l’application.
Cette application ne pourra plus accéder au compte. Les écritures existantes sont conservées ; votre connexion à l’application d’origine et les autres autorisations restent valides. Se déconnecter de l’application ne révoque pas l’autorisation de l’agent.
- Pour changer de compte, reconnectez et autorisez à nouveau.
Avant de reconnecter, ouvrez le compte voulu dans l’application native et vérifiez la demande et les permissions. Son unique livre est utilisé automatiquement. Une nouvelle autorisation ne déplace pas les opérations et ne fusionne pas les comptes de services distincts.
En cas de problème
Questions fréquentes et dépannage de connexion
Pourquoi ne puis-je pas enregistrer d’opérations après l’installation ?
Une installation réussie signifie seulement que les fichiers de compétence sont en place. Vérifiez que ce client possède son propre client OAuth enregistré et son URL de rappel exacte, qu’il est connecté à MCP et que vous avez explicitement accepté après vérification du compte, du client et des permissions dans l’application. L’unique livre du compte est utilisé automatiquement. Après l’approbation sur le téléphone, gardez le navigateur d’origine ouvert pour terminer OAuth. Rechargez le client et consultez d’abord le compte et le livre autorisés. Vérifiez leur correspondance avant de saisir de vraies opérations.
Une erreur apparaît après la saisie du numéro de compte ?
Revenez au plugin squirrellyai existant et relancez « Connecter un compte ». Saisissez le numéro sur la nouvelle page d’autorisation ; ne vous contentez pas d’actualiser l’ancienne erreur. Cette correction Web ne nécessite pas de réinstaller l’application mobile. Si l’erreur persiste, conservez le code affiché.
L’option « Ajouter un MCP personnalisé » n’apparaît pas dans ChatGPT ?
Cette option dépend du compte ChatGPT, de l’organisation et des règles de l’espace de travail. Consultez les instructions officielles actuelles ; dans un espace d’entreprise ou d’équipe, vérifiez auprès de l’administrateur si les connexions personnalisées sont autorisées. Une adresse de service accessible ne garantit pas l’accès à cette option chez l’hôte.
Une erreur 401 apparaît après la saisie de l’adresse : le service est-il en panne ?
Ouvrir directement /mcp directement sans autorisation renvoie normalement 401. Il s’agit d’un point d’accès pour agents, pas d’une page de connexion. Copiez votre numéro dans Réglages → Connexions des agents, lancez OAuth depuis l’agent et approuvez dans l’application.
Erreur invalid_client ou URL de rappel incompatible ?
Vérifiez l’ID client de l’application concernée et utilisez exactement l’URL de rappel enregistrée. L’ID préenregistré pour ChatGPT est squirrelly-chatgpt ; les autres produits nécessitent un enregistrement distinct. Si l’URL de rappel propre à l’hôte diffère de celle enregistrée, l’administrateur doit mettre à jour la configuration. Ne changez pas de compte à répétition et ne désactivez pas l’authentification.
Rubrique Connexions des agents absente, compte incorrect ou navigateur en attente ?
Une nouvelle version avec Réglages → Connexions des agents est nécessaire ; sinon, mettez à jour ou attendez. Vérifiez le compte d’origine et le service dans l’application. Gardez le navigateur d’origine ouvert pendant l’accord sur le téléphone et revenez-y pour terminer OAuth. En cas de refus ou d’expiration, lancez une nouvelle demande. Ne créez pas de compte Web et ne saisissez pas de mot de passe Web.
La connexion fonctionne, mais l’ajout de recettes ou dépenses échoue ?
Vérifiez que les permissions incluent « Ajouter des recettes et dépenses », que le livre reste accessible et que la demande concerne une recette ou dépense ordinaire avec montant, devise et date complets. Si nécessaire, reconnectez-vous pour accorder explicitement les permissions requises.
L’agent annonce une réussite, mais l’écriture n’apparaît pas dans l’application ?
Vérifiez la version, le compte et le livre, ainsi que les filtres de date et de devise. Demandez à l’agent de vérifier le résultat de l’opération initiale ; seul l’état committed renvoyé par le service confirme la réussite. Si le résultat est inconnu, ne créez pas une nouvelle écriture avec un nouvel identifiant.
La déconnexion efface-t-elle les écritures ? Que signifie « effacer les enregistrements de déduplication » ?
La déconnexion révoque seulement l’accès de l’application, sans supprimer les écritures. Les enregistrements de déduplication associent une requête à l’écriture créée pour éviter les doublons ; l’utilisation normale, la déconnexion et la révocation ne les effacent pas. Ces traces ne sont supprimées avec les données personnelles que lors de la suppression du compte entier.
Que se passe-t-il si je change de téléphone ou de serveur ?
Le numéro d’un même compte sur le même service reste identique. Les comptes distincts sur des services différents possèdent chacun leur numéro ; aucune fusion automatique entre versions n’est actuellement effectuée. Lors d’une migration de serveur, la plateforme doit maintenir la correspondance des comptes ; une même adresse e-mail ne suffit pas à les associer automatiquement.
Demande expirée, accès révoqué ou service indisponible ?
Une demande expirée ou refusée n’accorde aucun accès. Relancez OAuth et approuvez la nouvelle demande dans l’application. Après révocation, reconnectez-vous. Réessayez plus tard en cas de panne temporaire. Gardez le navigateur d’origine ouvert. Ne transmettez ni mots de passe, ni codes, ni jetons dans le chat et ne désactivez pas la vérification HTTPS.
Pour les développeurs
Intégrer la tenue de comptes dans vos propres agents
Enregistrez votre client OAuth et son URI de redirection exacte. Le navigateur identifie le service avec account_code ; l’application native approuve la demande et le navigateur d’origine termine le flux code d’autorisation / PKCE S256. Appelez ensuite MCP ou l’API HTTP. L’enregistrement dynamique anonyme, les jetons partagés et l’accès par le seul numéro de compte ne sont pas pris en charge.
| Outil MCP | Fonction |
|---|---|
get_account / list_books | Consulter le compte et le livre autorisés |
create_transaction | Créer une recette ou une dépense |
list_transactions | Consulter les opérations par pages |
summarize_transactions | Obtenir une synthèse par devise |
get_operation | Vérifier le résultat d’une écriture |
Les montants utilisent la plus petite unité monétaire. Toute création doit utiliser un identifiant stable requestId (en HTTP, Idempotency-Key). N’annoncez une réussite que pour l’état committed ; pour l’état unknown, conservez l’identifiant initial et consultez le résultat.
Commencez avec votre propre compte.
Obtenez votre numéro et approuvez dans l’application, puis terminez OAuth dans le navigateur d’origine.