Assistente IA
Usare PokéItem nel tuo assistente IA
PokéItem si collega a Claude, ChatGPT, Cursor e agli altri assistenti compatibili con il protocollo MCP. Una volta collegato al tuo account, l'assistente può consultare le quotazioni PokéItem, leggere e ordinare il tuo album e identificare una carta da una foto, nei limiti dei permessi che gli concedi.
Indirizzo del server
https://api.pokeitem.fr/mcpServer MCP remoto, accesso tramite OAuth 2.1. Inseriscilo nel tuo assistente se PokéItem non compare nel suo elenco di connettori.
Collegare PokéItem
PokéItem funziona con Claude, ChatGPT, Cursor e qualsiasi altro client compatibile con il protocollo MCP (Model Context Protocol). L'accesso usa OAuth 2.1: ti identifichi su una pagina PokéItem e scegli che cosa l'assistente può fare. La tua password resta presso PokéItem.
- Aggiungi PokéItem. Nelle impostazioni dei connettori del tuo assistente, scegli PokéItem oppure aggiungi un connettore personalizzato con l'indirizzo https://api.pokeitem.fr/mcp.
- Accedi. Si apre una pagina PokéItem: identificati con il tuo account PokéItem.
- Dai il tuo consenso. Spunta i permessi che concedi all'assistente, poi conferma con «Autorizza».
- Fai la tua domanda. L'assistente chiama PokéItem quando la tua richiesta lo richiede.
Serve un account PokéItem. Puoi crearlo al momento del collegamento.
Con un token personale
Per un client senza OAuth, crea un token personale nell'app PokéItem: Profilo → Impostazioni → Agente IA → «Crea un token». Scegli nome, permessi e durata (30 giorni, 90 giorni o 1 anno), poi incolla la configurazione proposta nel tuo client.
Il token viene mostrato una sola volta. Tienilo per te: dà accesso al tuo account, nei limiti dei permessi scelti. Puoi avere fino a cinque token attivi.
Che cosa può fare l'assistente
In base ai permessi concessi, l'assistente può usare i seguenti strumenti:
| Ambito | Che cosa puoi chiedere |
|---|---|
| Quotazioni | La quotazione PokéItem di una carta o di un prodotto sigillato, anche per versione, lingua, condizione o gradazione; lo storico della quotazione su 30 giorni; un parere su un prezzo richiesto, ragionevole o no. |
| Album | Un riepilogo del tuo album, una ricerca tra le tue carte, i tuoi doppioni, i tuoi sigillati, i tuoi desideri, le tue carte gradate, il completamento di un set, i tuoi avvisi di prezzo. |
| Modifiche | Aggiungere, modificare o rimuovere carte, sigillati, desideri e avvisi di prezzo. |
| Scansione | Identificare una carta a partire da una foto. |
| Esportazione e analisi | Esportare la tua collezione; ottenere un'analisi della tua collezione. |
| Scambi | Visualizzare in anteprima uno scambio con un allenatore il cui album è visibile. |
Esempi di richieste: «Qual è la quotazione di Charizard-ex di 151, in italiano?», «Quali carte ho in doppio?», «Che cosa mi manca per completare 151?» oppure «Aggiungi questa carta al mio album» con una foto.
I permessi che concedi
Nella schermata di consenso spunti i permessi concessi all'assistente. Puoi limitarti alla sola lettura, ad esempio.
| Permesso | Che cosa consente |
|---|---|
| Leggi album | Consultare il tuo album: riepilogo, ricerca, doppioni, sigillati, desideri, carte gradate, completamento dei set. |
| Modifica album | Aggiungere, modificare o rimuovere carte, sigillati e desideri. |
| Cerca una quotazione | Consultare le quotazioni PokéItem e il loro storico, verificare un prezzo richiesto. |
| Scanner | Inviare una foto per identificare una carta. |
| Avvisi | Consultare, creare e rimuovere i tuoi avvisi di prezzo. |
| Esporta la collezione | Esportare la tua collezione. |
Limiti
- Serve un account PokéItem: l'assistente agisce sempre per conto di un membro che ha effettuato l'accesso.
- Ogni strumento ha un limite di chiamate orario.
- Il numero di carte distinte del catalogo consultabili al giorno è limitato. Le carte già presenti nel tuo album non vengono conteggiate. Il limite è più basso per un account recente.
- Una ricerca restituisce al massimo 5 risultati.
- Le risposte riguardano le quotazioni PokéItem e il tuo album. Gli annunci dei marketplace (eBay, Vinted, Cardmarket…) restano su quei siti e non compaiono nelle risposte.
- Ogni eliminazione chiede la tua conferma prima di essere applicata.
- Si applicano anche i limiti abituali del tuo account PokéItem.
I tuoi dati
Quando l'assistente chiama uno strumento, PokéItem riceve solo i parametri di quella chiamata (ad esempio il nome della carta cercata), mai la cronologia della tua conversazione. La risposta dello strumento (quotazione, contenuto dell'album richiesto) viene trasmessa al tuo assistente, che la tratta secondo la propria informativa sulla privacy.
PokéItem tiene un registro di ogni chiamata (strumento, breve riepilogo della richiesta, carta interessata, stato, durata), conservato 90 giorni e visibile in Profilo → Impostazioni → Agente IA. Il dettaglio dei dati, delle finalità e delle durate di conservazione è nella politica sulla privacy.
Revocare un accesso
- Nell'app PokéItem. Apri Profilo → Impostazioni → Agente IA, poi tocca «Revoca» accanto all'assistente o al token. L'accesso si interrompe subito.
- Dal tuo assistente. Rimuovi o scollega PokéItem nelle sue impostazioni dei connettori.
- Eliminando il tuo account. L'eliminazione del tuo account PokéItem elimina anche tutti i tuoi accessi e i dati legati al connettore.
Domande frequenti
PokéItem legge le mie conversazioni con l'assistente?
PokéItem riceve solo i parametri delle chiamate agli strumenti, ad esempio il nome di una carta cercata o la carta da aggiungere. Il resto della conversazione resta tra te e il tuo assistente.
L'assistente può modificare il mio album senza il mio consenso?
Può modificarlo solo se gli hai concesso il permesso «Modifica album». Ogni eliminazione chiede inoltre la tua conferma.
Dove vedo che cosa ha fatto l'assistente sul mio account?
In Profilo → Impostazioni → Agente IA: il registro elenca le chiamate degli ultimi 90 giorni, con lo strumento usato e un breve riepilogo della richiesta.
Come scollego un assistente?
In Profilo → Impostazioni → Agente IA, tocca «Revoca» accanto all'assistente. Puoi anche rimuovere PokéItem dalle impostazioni del tuo assistente.
Hai una domanda?
Scrivici a contact@pokeitem.fr, per un problema di collegamento come per una richiesta sui tuoi dati.