Prima di iniziare
Controlla prima il servizio e la versione dell’app.
Questo percorso riguarda il servizio condiviso della versione internazionale iOS. app.squirrelly.ai rimane il dominio del servizio e delle API; non servono software Web o accesso dal Web. La stessa email può identificare account distinti su altri servizi.
| Versione dell’account | Stato attuale |
|---|---|
| Servizio internazionale iOS condiviso | Test di connessione · Nuova app necessaria |
| Funzione nativa necessaria | Impostazioni → Connessioni agenti. Serve una nuova versione nativa; non si presume che le versioni installate o su App Store la includano già. |
| Account indipendenti di Android Play internazionale | Non ancora integrati |
| Account indipendenti della versione cinese, HarmonyOS e altre | Non ancora integrati |
È previsto solo il servizio internazionale iOS condiviso. I servizi indipendenti Android Play, Cina e HarmonyOS non sono abilitati. Se manca Connessioni agenti, aggiorna o attendi la versione compatibile. Non creare un account Web sostitutivo.
Passaggio 01
Copia il numero di account nell’app
- Apri Impostazioni → Connessioni agenti nell’app nativa.
Usa il tuo account esistente già connesso nell’app. Guida per aprire l’app ↗ spiega solo come aprire l’app; non offre accesso o gestione degli account sul Web.
- Verifica che la tua versione includa questa funzione.
Serve una nuova versione nativa con Connessioni agenti. Se la voce manca, aggiorna o attendi il rilascio. Non si presume che le versioni attualmente installate o su App Store siano già compatibili.
- Copia il numero globale da Connessioni agenti.
Il numero inizia con
ZXM-. Lo stesso account sullo stesso servizio mantiene il numero. Inseriscilo nella richiesta del browser per identificare account e servizio.
Il numero serve a trovare l’account corretto; non è una password. Serve l’approvazione esplicita nell’app nativa con l’account corrispondente connesso.
Vedi come aprire l’app ↗Passaggio 02 · ChatGPT
Aggiungi Squirrelly a ChatGPT
Questa è la procedura di test per un MCP personalizzato, non un’installazione con un clic da un catalogo di plugin. La disponibilità dipende dall’account ChatGPT e dalle regole dell’area di lavoro.
- Apri la pagina Plugins di ChatGPT.
Vai a ChatGPT Plugins ↗, seleziona il segno più e poi Add custom MCP server (Aggiungi server MCP personalizzato). Se l’opzione non compare, consulta le domande frequenti qui sotto.
- Inserisci i dati di connessione.
Inserisci “squirrellyai” come nome e scegli un endpoint HTTPS pubblico. Incolla l’indirizzo completo, inclusa la parte finale
/mcp.
Configurazione ChatGPT, incluse le impostazioni OAuth avanzate
| Impostazione | Valore corretto |
|---|---|
| Nome | squirrellyai |
| Indirizzo del server | https://mcp.squirrelly.ai/mcp |
| Metodo di autenticazione | OAuth |
| Metodo di registrazione | Client OAuth personalizzato |
| ID client OAuth | squirrelly-chatgpt |
| Segreto client | Lasciare vuoto |
| Metodo di autenticazione dell’endpoint Token | none |
| URL di registrazione | Lasciare vuoto |
| Abilita OIDC | Non selezionato |
Espandi “Impostazioni OAuth avanzate” e compila ogni campo secondo la tabella. L’ID client deve essere squirrelly-chatgpt; non sostituirlo con il nome del plugin o il numero di account.
Gli avvisi DCR e CIMD non disponibili indicano che il server non offre questi due metodi di registrazione automatica. Scegli “Client OAuth personalizzato” e segui la tabella. Lascia vuoto l’URL di registrazione e non abilitare OIDC.
Mantieni i cinque ambiti richiesti predefiniti: account:read, books:read, transactions:read, transactions:create, summaries:read. Lascia vuoti gli ambiti di autorizzazione di base.
- Completa la creazione, installa o attiva il plugin, poi collega l’account.
Crea il plugin personale seguendo ChatGPT, installalo o attivalo e scegli “Collega account”. Creare il plugin non concede accesso all’account: serve ancora l’approvazione nell’app. Poi prova i sei strumenti per account, libri, nuove registrazioni, ricerca, riepiloghi ed esiti di scrittura.
- Avvia OAuth e completa l’autorizzazione nella sezione successiva.
Quando OAuth apre la richiesta Squirrelly, inserisci il numero copiato dall’app. Tieni aperto questo browser; approverai l’accesso nell’app.
- Crea una nuova chat e attiva la connessione.
Attiva il plugin Squirrelly creato seguendo l’interfaccia attuale di ChatGPT. Nelle interfacce compatibili puoi digitare
@per selezionarlo. Esegui poi il controllo di sola lettura descritto più avanti.
La presenza di squirrellyai tra i plugin personali ChatGPT conferma la creazione. Installa o attiva quel plugin, collega l’account Squirrelly, approva nell’app e poi prova gli strumenti. Non serve crearlo di nuovo.
Avanzate: verifica endpoint OAuth e URI di reindirizzamento
Per questo client è attualmente registrato soltanto questo URL di callback esatto:
https://chatgpt.com/connector_platform_oauth_redirectSe l’host mostra un altro URI di reindirizzamento, ad esempio specifico della connessione, l’amministratore deve registrare quell’URI esatto. Non usare caratteri jolly né cambiare il dominio. Altri agenti devono registrare client propri e non riutilizzare questo client ChatGPT. DCR e la registrazione CIMD generale non sono disponibili.
Verifica gli endpoint OAuth rilevati automaticamente
| Impostazione | Valore corretto |
|---|---|
| URL di autorizzazione | https://mcp.squirrelly.ai/oauth/authorize |
| Token URL | https://mcp.squirrelly.ai/oauth/token |
| URL di base del server di autorizzazione | https://mcp.squirrelly.ai |
| Risorsa | https://mcp.squirrelly.ai/mcp |
Il servizio reale è stato verificato con il client SDK MCP ufficiale, ma le chiamate finali agli strumenti in un vero account ChatGPT non sono ancora verificate. La creazione del plugin personale non significa autorizzazione dell’account o chiamate riuscite, né pubblicazione in un catalogo o approvazione OpenAI.
Fonti della procedura: Guida ufficiale di connessione di OpenAI · Documentazione sull’autenticazione OAuth. Verificato il 2026-10-30.
Skill per registrazioni rapide
Installa la skill squirrelly con un solo comando
Scegli il comando per il tuo computer e client per scaricare e installare squirrelly automaticamente. La connessione MCP e l’approvazione OAuth nell’app vanno completate separatamente; poi puoi usare il comando rapido della skill.
Scarica e installa automaticamente
Copia il comando adatto nel terminale del computer o affidalo a un agente in grado di eseguire comandi locali. Il comando scarica, verifica e installa la skill senza estrazione manuale.
macOS
macOS: esegui in Terminale con gli strumenti di sistema. Non serve installare separatamente Python o Homebrew. Scegli il comando per il tuo 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-codeVisualizza script di installazione · macOS ↗
Windows
Windows: esegui in PowerShell. Supporta Windows PowerShell 5.1 e PowerShell 7. Scegli il comando per il tuo 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-codeVisualizza script di installazione · Windows ↗
L’installer verifica SHA-256 e installa solo i file della skill. Per impostazione predefinita non sovrascrive contenuti esistenti diversi. Per aggiornare, aggiungi --update su macOS o -Update su Windows; prima verrà creato un backup.
Ricarica il client o avvia una nuova sessione dopo l’installazione. Usa $squirrelly in Codex e /squirrelly in Claude Code. Installare la skill non configura MCP né completa OAuth: collega il servizio e approva nell’app separatamente.
Una pagina Web non può installare skill locali senza intervento. ChatGPT sul Web usa un plugin; questi comandi sono per client autorizzati a eseguire comandi locali.
Scarica ZIP manualmente (alternativa)
Se il client non supporta comandi locali, usa l’importazione ZIP qui sotto se disponibile. Le possibilità dipendono dal client.
- Scarica manualmente lo ZIP come alternativa.
Scarica la skill squirrelly in formato ZIP, estrailo manualmente e leggi INSTALL.md. Il pacchetto contiene i file della skill, senza password di account o token.
- Installalo secondo le istruzioni del client.
In Codex puoi inserire la cartella squirrelly nella tua directory personale delle skill e usare in una nuova sessione
$squirrelly; i client che supportano queste directory possono registrare, secondo le proprie istruzioni,/squirrelly. Il nome del comando è gestito dal client e non viene aggiunto automaticamente da MCP.
Collega prima MCP e completa l’autorizzazione OAuth. La skill guida solo l’agente nell’uso degli strumenti e non concede autonomamente accesso all’account. Senza connessione non registra nulla; se data, valuta o registro non sono chiari, non scrive di propria iniziativa.
/squirrelly Oggi ho acquistato un capo di abbigliamento per 2000 yuan cinesi (CNY).
Nell’interfaccia attuale di ChatGPT puoi selezionare il plugin tramite @. Non presumere che i comandi con la barra funzionino in tutti i client; scegli il punto di accesso indicato nelle istruzioni di installazione del pacchetto.
Passaggio 02 · Altri agenti
Collega agenti diversi allo stesso servizio
Scegli i passaggi per il tuo client
| Client | Passaggi |
|---|---|
| ChatGPT sul web | Crea o attiva il plugin seguendo la tabella ChatGPT qui sopra, poi collega il tuo account e autorizza l’accesso nell’App. Non serve installare una skill locale. |
| Codex | Installa la skill con il comando macOS o Windows qui sotto. Configura MCP separatamente e autorizza l’accesso nell’App; ricarica il client e usa $squirrelly. |
| Claude Code | Installa la skill con il comando macOS o Windows qui sotto. Configura MCP separatamente e autorizza l’accesso nell’App; ricarica il client e usa /squirrelly. |
L’host deve supportare MCP remoto tramite Streamable HTTP e OAuth con codice di autorizzazione / PKCE. La posizione delle impostazioni e le funzioni supportate variano da prodotto a prodotto; non applicare direttamente i passaggi dell’interfaccia di ChatGPT.
- Trova le impostazioni MCP remoto o server di strumenti nell’host.
Inserisci
https://mcp.squirrelly.ai/mcpe scegli OAuth come autenticazione. - Registra un client OAuth dedicato a quell’agente.
L’amministratore deve registrare il nome dell’applicazione, un ID client distinto e l’URL di callback esatto fornito dall’host.
squirrelly-chatgptè riservato al callback ChatGPT registrato e non può essere riutilizzato direttamente da altri prodotti. - Approva l’accesso nell’app nativa.
Dopo aver registrato il client, segui lo stesso percorso di approvazione nell’app descritto sotto. Tieni aperto il browser originale per completare OAuth. Gli host limitati a stdio locale, chiavi API statiche o senza OAuth non possono collegarsi direttamente.
Gli sviluppatori possono integrare i propri agenti anche tramite HTTP API. Il supporto del protocollo offre una possibilità di integrazione, ma non significa che tutti i prodotti siano già stati verificati per compatibilità.
Passaggio 04
Verifica la connessione prima della prima registrazione
Si consiglia di verificare in quest’ordine. I pulsanti Copia copiano solo il testo e non inviano richieste né creano registrazioni automaticamente.
Usa Squirrelly per visualizzare l’account e il registro attualmente autorizzati, senza aggiungere registrazioni per ora.
Verifica che il numero account e il libro restituiti corrispondano all’account attuale nell’app e al suo unico libro. Poi invia un’entrata o un’uscita che vuoi davvero registrare.
Registra con Squirrelly: oggi ho speso 35 yuan cinesi (CNY) per il pranzo. Inseriscili nel registro attualmente autorizzato.
La registrazione è completata solo quando il servizio conferma esplicitamente il salvataggio. Apri poi il registro corrispondente nell’account Squirrelly originale per verificare importo, data e valuta.
Dopo la connessione
Fai tutto questo direttamente in chat
Registra con Squirrelly: oggi ho ricevuto uno stipendio di 8000 yuan cinesi (CNY).
Consulta con Squirrelly le uscite di questa settimana e mostra prima i 20 movimenti più recenti.
Riepiloga con Squirrelly le entrate, le uscite e il saldo di questo mese, separando le diverse valute.
Specifica chiaramente importo, valuta e data e usa il libro attualmente autorizzato. La prima versione non consente agli agenti di modificare o eliminare vecchie registrazioni, effettuare trasferimenti, gestire prestiti o importazioni in blocco.
Se l’agente indica un esito sconosciuto, chiedigli di consultare il risultato dell’operazione originale o di riprovare con lo stesso ID richiesta. Non ripetere la stessa registrazione con richieste nuove. Il server usa registri di deduplicazione per evitare duplicati causati dai tentativi di rete.
Il controllo resta a te
Revoca l’autorizzazione o cambia account
- Apri Impostazioni → Connessioni agenti nell’app nativa.
Trova il client autorizzato e controlla libro e permessi nell’app.
- Revoca l’accesso di quel client nell’app.
L’applicazione non potrà più accedere. Le registrazioni esistenti vengono conservate; l’accesso all’app originale e le altre autorizzazioni restano validi. Uscire dall’app non revoca l’autorizzazione dell’agente.
- Per cambiare account, ripeti connessione e autorizzazione.
Prima di ricollegarti, accedi all’account desiderato nell’app nativa e verifica richiesta e permessi. Viene usato automaticamente il suo unico libro. Una nuova autorizzazione non sposta le registrazioni e non unisce account di servizi diversi.
In caso di problemi
Domande frequenti e problemi di connessione
Perché non posso registrare movimenti dopo l’installazione?
L’installazione completata indica solo che i file della skill sono presenti. Verifica che questo client abbia un proprio client OAuth registrato e un URL di callback esatto, sia collegato a MCP e tu abbia approvato esplicitamente dopo aver verificato account, client e permessi nell’app. Viene usato automaticamente l’unico libro dell’account. Dopo l’approvazione sul telefono, tieni aperto il browser originale per completare OAuth. Ricarica il client e consulta prima account e libro autorizzati. Verifica che corrispondano prima di registrare operazioni reali.
Appare un errore dopo aver inserito il numero di account?
Torna al plugin squirrellyai esistente e riavvia “Collega account”. Inserisci il numero nella nuova pagina di autorizzazione; non limitarti ad aggiornare il vecchio errore. Questa correzione Web non richiede di reinstallare l’app sul telefono. Se l’errore persiste, conserva il codice mostrato.
Non trovi «Aggiungi MCP personalizzato» in ChatGPT?
La disponibilità dipende dall’account ChatGPT, dall’organizzazione e dalle regole dell’area di lavoro. Consulta prima le istruzioni ufficiali attuali; nelle aree aziendali o di team, l’amministratore può verificare se sono consentite connessioni personalizzate. Un indirizzo del servizio raggiungibile non garantisce che l’host offra questa opzione.
Compare 401 dopo aver inserito l’indirizzo: il servizio non funziona?
Se apri direttamente /mcp direttamente senza autorizzazione restituisce normalmente 401. È un endpoint per agenti, non una pagina di accesso. Copia il numero in Impostazioni → Connessioni agenti nell’app, avvia OAuth dall’agente e approva nell’app.
Compare invalid_client o l’URL di callback non corrisponde?
Verifica di usare l’ID client dell’applicazione corretta e l’URL di callback esatto registrato. L’ID preregistrato per ChatGPT è squirrelly-chatgpt; gli altri prodotti richiedono una registrazione separata. Se il callback specifico dell’host è diverso dall’indirizzo registrato, l’amministratore deve aggiornare la configurazione. Non cambiare ripetutamente account e non disattivare l’autenticazione.
Manca Connessioni agenti, account errato o browser in attesa?
Serve una nuova app con Impostazioni → Connessioni agenti; se manca, aggiorna o attendi. Controlla account originale e servizio nell’app. Tieni aperto il browser originale durante l’approvazione sul telefono e torna lì per completare OAuth. Se la richiesta viene rifiutata o scade, avviane una nuova. Non creare un account Web né inserire una password Web.
La connessione funziona, ma non puoi aggiungere entrate o uscite?
Verifica che i permessi concessi includano «Aggiungi entrate e uscite», che il registro sia ancora accessibile e che la richiesta riguardi un’entrata o un’uscita ordinaria con importo, valuta e data completi. Se necessario, ripeti la connessione per concedere esplicitamente i permessi richiesti.
L’agente segnala successo, ma non trovi la registrazione nell’app?
Verifica versione, account e registro, oltre ai filtri di data e valuta. Chiedi all’agente di consultare l’esito dell’operazione originale; solo lo stato committed restituito dal servizio indica successo. Se l’esito è sconosciuto, non registrare di nuovo con un ID diverso.
Scollegare elimina le registrazioni? Cosa significa «eliminare i registri di deduplicazione»?
Scollegare revoca solo l’accesso dell’applicazione e non elimina le registrazioni. I registri di deduplicazione indicano quale registrazione è stata creata da una richiesta e impediscono i duplicati; l’uso normale, l’uscita e la revoca non li cancellano. Questi dati operativi vengono eliminati con i dati personali solo quando viene eliminato l’intero account.
Cosa succede se cambio telefono o server?
Il numero dello stesso account sullo stesso servizio rimane invariato. Gli account indipendenti su servizi diversi hanno numeri propri e al momento non vengono uniti automaticamente tra versioni. Durante una migrazione del server, la piattaforma deve mantenere le corrispondenze degli account; la stessa e-mail non basta per associarli automaticamente.
Richiesta scaduta, accesso revocato o servizio non disponibile?
Una richiesta scaduta o rifiutata non concede accesso. Riavvia OAuth e approva la nuova richiesta nell’app. Dopo la revoca, ricollega. Riprova più tardi in caso di guasti temporanei. Tieni aperto il browser originale; non inviare password, codici o token in chat e non disattivare la verifica HTTPS.
Per gli sviluppatori
Integra la gestione dei conti nei tuoi agenti
Registra il tuo client OAuth e l’URI di reindirizzamento esatto. Il browser identifica il servizio con account_code; l’app nativa approva la richiesta e il browser originale completa il flusso codice di autorizzazione / PKCE S256. Poi chiama MCP o API HTTP. Non sono supportati registrazione dinamica anonima, token condivisi o accesso con il solo numero di account.
| Strumento MCP | Funzione |
|---|---|
get_account / list_books | Consultare account e libro autorizzati |
create_transaction | Creare un’entrata o un’uscita |
list_transactions | Consultare i movimenti con paginazione |
summarize_transactions | Riepilogare per valuta |
get_operation | Consultare l’esito di una scrittura |
Gli importi sono espressi nell’unità monetaria minima. Le operazioni di creazione devono usare un identificatore stabile requestId (in HTTP, Idempotency-Key). Segnala l’operazione come riuscita solo con lo stato committed; con lo stato unknown, mantieni l’identificatore originale e consulta il risultato.
Inizia dal tuo account.
Ottieni il numero e approva nell’app, poi completa OAuth nel browser originale.