🤖 Integrazione IA — Collegare Claude e ChatGPT

Passo dopo passo: collegare Claude, ChatGPT e Claude Code CLI con il tuo account sTraderZ.com

In questo capitolo

1 Requisiti 2 Collegare Claude (claude.ai) 3 Collegare ChatGPT (Custom GPT) 4 Collegare Claude Code CLI 5 Strumenti disponibili (Riferimento)

1. Requisiti

L'integrazione IA è disponibile a partire dal piano Basic (non nel piano gratuito). Colleghi il tuo client IA con il tuo account sTraderZ.com tramite OAuth — il client ottiene quindi solo accesso in lettura ai tuoi dati di trading.

Endpoint MCP

https://straderz.com/api/mcp.php

⚠️ L'URL deve essere esattamente questa — con .php, senza barra finale.

💎

A partire dal piano Basic

Non disponibile nel piano gratuito.

👁️

Solo lettura

Scope read — nessuna esecuzione di trade.

🔓

Revocabile in qualsiasi momento

Pagina account «Integrazioni IA».

Al primo collegamento si apre un dialogo di autorizzazione. Lì confermi lo scope read (accesso in lettura). Le connessioni esistenti possono essere visualizzate e revocate in qualsiasi momento nella pagina account Integrazioni IA.

2. Collegare Claude (claude.ai)

🤖

Claude · claude.ai

Connettore MCP

Aprire claude.ai → Settings → Integrations → Add more
Nel campo «MCP Server URL» inserire: https://straderz.com/api/mcp.php
Cliccare su Connect → il browser apre la pagina di login/consenso di sTraderZ.com
Confermare lo scope read (accesso in lettura ai 10 strumenti)
Di ritorno in claude.ai il server appare come attivo → testare nella chat: «Mostrami i miei ultimi 5 trade»

Importante: L'URL deve essere esattamente https://straderz.com/api/mcp.php (con .php, senza barra finale).

3. Collegare ChatGPT (Custom GPT)

💬

ChatGPT · Custom GPT

OpenAPI Actions

I Custom GPT di ChatGPT utilizzano OpenAPI/Actions (non MCP/JSON-RPC). Per questo esiste un adattatore REST separato — l'endpoint MCP per Claude non viene influenzato.

Aprire ChatGPT → Explore GPTs → Create → scheda Configure → Add actions
Nel campo «Schema» inserire l'URL: https://straderz.com/api/mcp-openapi-schema.php → ChatGPT importa lo schema automaticamente (tutti i 10 strumenti appaiono come Actions)
Authentication → OAuth → inserire i seguenti valori:
- Client ID + Secretcopiare dalla pagina di amministrazione di sTraderZ
- Authorization URLhttps://straderz.com/oauth/authorize.php
- Token URLhttps://straderz.com/oauth/token.php
- Scoperead
Salvare → testare nella chat del GPT: «Mostrami i miei ultimi 5 trade»

Nota: Le Actions di ChatGPT richiedono un account verificato su platform.openai.com.

4. Collegare Claude Code CLI

💻

Claude Code CLI

Server MCP locale

Configurazione in ~/.claude/settings.json (o a livello di progetto in .claude/settings.json):

settings.json

{"mcpServers":{"straderz":{"type":"http","url":"https://straderz.com/api/mcp.php","headers":{"Authorization":"Bearer <il-tuo-access-token>"}}}}

Ottenere il token: Aprire nel browser https://straderz.com/oauth/authorize.php?client_id=...&scope=read e completare il flusso OAuth. Il token è valido 90 giorni (rinnovo dalla pagina account).

Verifica nel terminale:

bash

claude mcp list
# → straderz: https://straderz.com/api/mcp.php (connected)

Esempio di utilizzo:

bash

claude "Qual è il mio profitto realizzato nel 2025?"

5. Strumenti disponibili (Riferimento)

✅ 10 strumenti di lettura · solo scope read

Tutti gli strumenti sono esclusivamente in lettura (scope read). Nessuna esecuzione di trade, nessuna modifica al broker.

Strumento	Scope	Descrizione
`list_accounts`	read	Tutti i conti broker collegati
`get_portfolio_overview`	read	Portfolio completo, posizioni, guadagni
`list_positions`	read	Posizioni aperte per conto
`list_trades`	read	Ultimi N trade (con filtro)
`get_trade_detail`	read	Dettagli completi di un ciclo di trade
`get_performance`	read	Metriche di performance (periodo selezionabile)
`get_tax_report`	read	Riepilogo del report fiscale (anno selezionabile)
`get_cashflow`	read	Versamenti/prelievi, deposito netto, movimenti di liquidità
`list_dividends`	read	Storico dividendi incl. ritenuta d'acconto
`get_allocation`	read	Suddivisione per classe di attività / settore / valuta