Sviluppatori
Usa il tuo portafoglio dagli assistenti AI, dal terminale o dal tuo codice. Tutto è di sola lettura e copre solo gli asset che possiedi.
Collega il tuo assistente AI
Chiedi a Claude, ChatGPT, Claude Code o Cursor delle tue posizioni, o aggiungine una in chat.
Funziona con ogni piano Claude, sul web, su desktop e su mobile. Il piano gratuito include un connettore personalizzato.
Accedi a Sonar durante la configurazione. Non hai un account? Creane uno gratis.
URL del serverhttps://sonarfolio.com/api/mcpApri Customize, poi Connectors.
Apri i connettori di Claude(si apre in una nuova scheda)Seleziona + Add, poi Add custom connector. Chiamalo Sonar e incolla l'URL del server.
Se richiesto, scegli Sign in now e Use Claude's published identity, senza ID né secret del client, poi Add.
Seleziona Connect, accedi e seleziona Consenti. In una chat, attivalo da +, poi Connectors.
Quali sono le mie cinque posizioni più grandi?Usa ChatGPT sul web. I server MCP personalizzati dipendono dal tuo piano ChatGPT; su Business ed Enterprise potrebbe doverli consentire un amministratore.
Accedi a Sonar durante la configurazione. Non hai un account? Creane uno gratis.
URL del serverhttps://sonarfolio.com/api/mcpSeleziona +, poi Add custom MCP server. Chiamalo Sonar e incolla l'URL del server.
Imposta Authentication su OAuth e lascia vuoti ID e secret del client. Accetta l'avviso, poi seleziona Create as a plugin.
Quando richiesto, accedi e seleziona Consenti. Poi installalo dai tuoi plugin e digita @ in una chat.
Quali sono le mie cinque posizioni più grandi?ChatGPT chiede conferma prima di aggiungere una posizione.
Per i client con header come Claude Code e Cursor, con una chiave API.
Crea un account gratuito, poi una chiave. Viene mostrata una sola volta.
Ottieni la tua chiave APIAggiungi Sonar al tuo client.
Claude Codeclaude mcp add --transport http sonar https://sonarfolio.com/api/mcp \ --header "Authorization: Bearer YOUR_KEY"
Cursor: ~/.cursor/mcp.json{ "mcpServers": { "sonar": { "url": "https://sonarfolio.com/api/mcp", "headers": { "Authorization": "Bearer YOUR_KEY" } } } }Altri client MCP: Streamable HTTP, header Authorization: Bearer YOUR_KEYhttps://sonarfolio.com/api/mcpEsegui
/mcpin Claude Code per controllare la connessione.
Oppure senza chiave: aggiungi l'URL senza header, esegui /mcp, scegli Sonar e seleziona Authenticate.
Quali sono le mie cinque posizioni più grandi?I connettori vedono solo gli asset che possiedi. Possono aggiungere le posizioni che descrivi, ma non fare trading, spostare fondi o eliminare nulla.
Risoluzione dei problemi
Non si collega o non mostra strumenti
Controlla che l'URL termini con /api/mcp e che l'accesso si sia concluso con Consenti. Altrimenti rimuovi Sonar e aggiungilo di nuovo.
L’assistente dice che servono un piano o dei crediti
Il tuo piano stabilisce cosa vede l'assistente; ogni chiamata a uno strumento è una richiesta. Controlla richieste e crediti in API e strumenti di AI.
Hai scollegato un'app o revocato una chiave
L'accesso si interrompe subito. Per ricollegarti, rimuovi Sonar, aggiungilo di nuovo e accedi.
Usi Claude con un piano Team o Enterprise
Un proprietario aggiunge Sonar una volta con l'URL del server; ogni membro accede al proprio account.
REST API
JSON su HTTPS con una chiave Bearer. Ogni endpoint ha uno strumento MCP e un comando CLI corrispondenti.
curl https://sonarfolio.com/api/v1/assets \ -H "Authorization: Bearer YOUR_KEY"
- GET/api/v1/meMCPget_usageCLIsonar statusPiano, accesso e utilizzo di oggiStarter
- GET/api/v1/assetsMCPlist_held_assetsCLIsonar assetsDati di mercato e social per ogni asset possedutoStarter
- GET/api/v1/assets/{id}MCPget_assetCLIsonar asset <SYMBOL>Un asset posseduto: quotazione, social, creator principali, chiusure a 90 giorniStarter
- GET/api/v1/assets/search?q=MCPsearch_assetsCLIsonar search <QUERY>Trova l'id di un asset (solo nomi)Starter
- GET/api/v1/portfolioMCPget_portfolioCLIsonar portfolioTotali, variazione 24h, P&L, allocazione, maggiori movimentiStandard
- GET/api/v1/holdingsMCPlist_holdingsCLIsonar holdings [--account NAME]Ogni posizione per accountStandard
- POST/api/v1/holdingsMCPadd_positionCLIsonar add <SYMBOL> <QUANTITY> [--cost --date --account]Aggiungi una posizione: { asset_id, quantity, cost_usd?, date?, account? }Scrive dati. I client MCP lo vedono segnato come distruttivo; la CLI chiede prima (--yes salta la domanda).Starter
Le risposte includono fonte, timestamp e il nostro disclaimer, più gli header X-RateLimit-Limit, -Remaining, -Reset e X-Credits-Remaining. Errori: { error: { code, message } }.
Riga di comando
Gli stessi dati nel terminale e negli script, con la stessa chiave.
Installa e accedi
npm install -g sonarfolio sonar login
Richiede Node 18 o successivo. sonar login salva una chiave da API e strumenti di AI; in script e CI, imposta invece SONAR_API_KEY.
Altre opzioni di installazione
Riesegui l'installazione per aggiornare. Provalo senza installare: npx -p sonarfolio sonar status. Installalo da questo sito: npm install -g https://sonarfolio.com/cli/latest.tgz. La chiave viene salvata in ~/.config/sonar/config.json, leggibile solo da te.
Comandi
I comandi sono elencati con gli endpoint REST, più sonar watch [portfolio|assets] per una vista dal vivo entro il tuo limite giornaliero.
Negli script
sonar holdings --json | jq '.holdings[] | {symbol, value_usd}'Ogni comando accetta --json e stampa il JSON dell'API.
Limiti e crediti
Ogni chiamata API, chiamata a uno strumento MCP o comando CLI è una richiesta. I limiti giornalieri si azzerano alle 00:00 UTC.
| Piano | Richieste incluse | Copre |
|---|---|---|
| Free | Solo crediti API | Prezzi e portafoglio |
| Starter | 500 al giorno | Prezzi, dati social e aggiunta di posizioni |
| Standard | 1000 al giorno | Aggiunge posizioni, P&L, allocazione e dati onchain |
| Premium | 2000 al giorno | Aggiunge posizioni, P&L, allocazione e dati onchain |
I nomi dei piani nell'elenco degli endpoint indicano dove una richiesta è inclusa; altrove pagano i crediti API, con ogni piano. $1 per 1000, i crediti non scadono mai e ogni account parte con 100.