Collegare PassportCraft
Prepari i passaporti digitali di prodotto con i suoi strumenti di IA
Colleghi PassportCraft all'assistente che già usa. Legge il suo catalogo, prepara le bozze dei passaporti, allega i suoi documenti e le dice che cosa manca ancora. La pubblicazione resta un suo clic.
Guardi come nasce una bozza di passaporto
Trascini una scheda tecnica in ChatGPT o Claude e chieda un passaporto. PassportCraft crea una bozza nel suo spazio di lavoro. Lei la legge e preme Pubblica.
Il video si apre su una finestra di chat con il nome ChatGPT, che poi diventa Claude. Viene trascinata dentro una scheda tecnica, e la richiesta dice «PassportCraft, draft a passport from this spec sheet.» Poi scorre la scheda tecnica del Merino Crew Sweater, Slate. È di Atelier Nord, il nostro marchio di esempio. 12 dei suoi valori passano in una bozza di passaporto, che poi riporta «12 fields drafted. Waiting for you to publish.» Una persona preme Publish. Il passaporto diventa un codice QR, con «Anyone can scan it.» e l'indirizzo passportcraft.com/01/05701234000013. Segue la frase «Your AI assistant drafts. You publish.», e la parola «AI» prende via via la forma dei loghi di ChatGPT, Claude, Gemini e Cursor. Alla fine i loghi di ChatGPT e Claude diventano il logo di PassportCraft. Sotto compaiono «Now in ChatGPT and Claude.» e passportcraft.com/connector. La musica accompagna tutto il video. Nessuno parla.
Lo attivi in pochi minuti
Scelga il suo client: un URL e un accesso. Nessun SDK e nessun codice.
https://passportcraft.com/api/mcp
Con Team o Enterprise, un proprietario aggiunge prima PassportCraft in Organization settings → Connectors. I membri possono poi collegarlo. Con Team, un membro può selezionare Request per chiederlo a un proprietario. Con un account personale, se la ricerca non trova PassportCraft, selezioni Add in Customize → Connectors e lo aggiunga come connettore personalizzato con l’URL del server mostrato qui. Lasci vuoti OAuth Client ID e Client Secret. Se viene richiesto un metodo di accesso, scelga Dynamic Client Registration (DCR).
Claude
- 1Trovare PassportCraft
In Claude, apra Customize → Connectors e cerchi PassportCraft. Aprire in Claude ↗
- 2Collegare il suo spazio di lavoro
Selezioni Connect e acceda a PassportCraft. Selezioni il suo spazio di lavoro e verifichi l’accesso prima di autorizzarlo.
- 3Usarlo in una chat
Faccia domande sui suoi passaporti in una nuova chat. Se Claude non usa PassportCraft, lo attivi con + → Connectors.
Crei un account gratuito per collegare i suoi strumenti di IA. Il connettore è incluso in tutti i piani. Qualsiasi client MCP che supporta HTTP può utilizzare lo stesso URL.
https://passportcraft.com/api/mcpUna volta collegato, chieda «Che cosa posso fare con PassportCraft?» e il suo assistente le descriverà tutto ciò che il connettore sa fare.
- Trasporto
- Streamable HTTP
- Accesso
- OAuth 2.0: nessuna chiave API da incollare
- Portata
- Un'area di lavoro per ogni connessione
- Piani
- Tutti, anche quello gratuito
- Revoca
- Quando vuole, dalle Impostazioni
Come funziona
Una connessione, tre idee.
Colleghi una volta sola
Lei accede e sceglie quale area di lavoro raggiunge l'assistente. La schermata che autorizza mostra l'indirizzo a cui sta inviando, non il nome che un'applicazione dà a se stessa: un nome si può copiare, un indirizzo no.
Lavori nella chat
Bozze, modifiche, documenti inviati dalla chat e un controllo che nomina le lacune esatte.
Pubblica lei
L'assistente può soltanto chiedere. Lei riceve un link, legge che cosa ha scritto e preme Pubblica.
Cose da chiedere
Una volta collegato, il lavoro sui passaporti sta in una frase.
«Crea i passaporti per i dodici modelli di questa scheda di collezione.»
«In quali delle mie bozze manca ancora la percentuale di materiale riciclato?»
«Allega questo certificato della filatura alla bozza dell'articolo 4471.»
«Controlla le mie bozze in lino e dimmi che cosa blocca la pubblicazione.»
«Cambia il paese di origine delle bozze primaverili in Portogallo.»
«Chiedimi di pubblicare tutto ciò che supera il controllo.»
Che cosa può fare l'assistente
Ventuno strumenti usano la stessa API del resto di PassportCraft. Restano gli stessi limiti di accesso all’area di lavoro, limiti d’uso e registri delle modifiche.
Che cosa può fare l'assistente
Ventuno strumenti usano la stessa API del resto di PassportCraft. Restano gli stessi limiti di accesso all’area di lavoro, limiti d’uso e registri delle modifiche.
| Strumento | A che cosa serve | Portata |
|---|---|---|
| list_passports · get_passport | Legge il suo catalogo e qualsiasi passaporto per intero, bozze e pubblicati. | Lettura |
| get_category_schema | Chiede che cosa richiede una categoria di prodotto, prima di scrivere qualsiasi cosa. | Lettura |
| list_custom_fields | Legge i campi personalizzati dell’area di lavoro e le relative opzioni. | Lettura |
| validate_passport | Controlla una bozza e restituisce le lacune esatte che bloccano la pubblicazione. | Lettura |
| create_passport | Crea un passaporto. Sempre come bozza. | Solo bozze |
| update_passport | Modifica una bozza. Ogni campo che scrive viene contrassegnato come suo. | Solo bozze |
| upload_document | Mette una piccola immagine della chat nella sua libreria e la allega a una bozza. Per una scheda tecnica o una dichiarazione, l’assistente le fornisce un link che apre la bozza pronta a ricevere il file: lo sceglie lei e arriva integro. Tutto resta fuori dalla portata del pubblico. | Solo bozze |
| attach_document · list_documents | Allega un file già presente nella sua libreria ed elenca ciò che un passaporto contiene. | Solo bozze |
| list_library | Mostra i file già presenti nella sua libreria, così ne riusa uno invece di inviarlo due volte. | Lettura |
| list_variants | Legge i codici a barre, le taglie e i colori salvati in un passaporto tessile o di prodotto generico. | Lettura |
| add_variants | Aggiunge i codici a barre, le taglie e i colori che Lei fornisce alla bozza di un passaporto tessile o di prodotto generico. | Solo bozze |
| list_units · create_unit · list_unit_readings | Registra i numeri di serie di un modello di batteria. | Scrittura |
| request_publish | Le chiede di pubblicare. Restituisce un link che apre lei. Non pubblica mai. | Decide lei |
| get_publish_approval | Legge che fine ha fatto quella richiesta. Una richiesta il cui termine è passato scade da sola, e questa lettura è ciò che lo registra. | Lettura |
| propose_changes | Propone modifiche a un passaporto già pubblicato. Sulla pagina pubblica non cambia nulla finché Lei non approva. | Decide lei |
| get_proposal | Legge che fine ha fatto una proposta: approvata, superata, scaduta, sostituita o ritirata. | Lettura |
| withdraw_proposal | Ritira una proposta quando Lei gli dice che non la vuole. | Scrittura |
L'assistente non ha uno strumento per nulla di tutto questo: pubblicare, cancellare qualsiasi cosa, togliere un prodotto dalla sua pagina pubblica, spostarlo nel cestino o recuperarlo, presentare dichiarazioni allo Stato francese. Il ritiro, il cestino e la dichiarazione sono inoltre respinti sulla connessione, quindi un connettore non li raggiunge nemmeno per altra strada.
Pubblica lei
Un passaporto pubblicato è una dichiarazione che lei rende a un'autorità. Queste quattro regole tengono quel momento, e tutto ciò che il pubblico può vedere, nelle sue mani.
Non può mai pubblicare
Quando chiede di pubblicare, deposita una richiesta e riceve un link. Lei apre il link e preme Pubblica. Questo passaggio non si può aggirare.
Non modifica ciò che è pubblicato senza di lei
Scrive nelle bozze. Per modificare un passaporto che il pubblico vede già, propone la modifica: lei vede ogni nuovo valore accanto a quello che sostituisce, e la pagina pubblica cambia solo quando lei approva. Un'eccezione, nominata invece che nascosta: può registrare numeri di serie su un modello di batteria che lei ha già pubblicato.
Ogni valore che scrive è contrassegnato
I campi scritti dall'assistente sono contrassegnati nell'editor ed elencati con i loro valori nella schermata che lei conferma prima di pubblicare. Ne cambi uno lei stesso e il contrassegno sparisce: il valore è suo.
Stretto, e lei può porvi fine
Sei permessi fissi, e la dichiarazione a un'autorità non è tra questi. Un'area di lavoro per ogni connessione. La revochi nelle Impostazioni e si ferma subito.
Domande
L'assistente può pubblicare un passaporto?
No. Quando chiede di pubblicare riceve un link. Lei apre quel link, legge ogni campo che l'assistente ha scritto, con i valori che ha scritto, e preme Pubblica lei stesso. Questo passaggio non si può aggirare.
Può modificare un passaporto già pubblicato?
Solo con la sua approvazione, e vale la pena conoscere un'eccezione. Un passaporto che il pubblico può vedere è una dichiarazione che lei ha reso, quindi l'assistente propone una modifica invece di applicarla lui stesso. Lei vede ogni nuovo valore accanto a quello che sostituisce, e nulla cambia nella pagina pubblica finché lei non approva. L'eccezione è la registrazione dei numeri di serie su un modello di batteria già pubblicato: un'emissione di routine, che il resto della nostra interfaccia tratta allo stesso modo. Lo stato di ogni batteria è limitato a un elenco fisso. Il numero di serie invece è testo libero e compare sulla pagina pubblica quando qualcuno scansiona quella batteria, quindi lo tratti come tutto ciò che pubblica.
Come rifiuto una richiesta di pubblicazione?
Non c'è un pulsante per rifiutare. Lasci stare la richiesta e scadrà da sola dopo sette giorni. Viene inoltre ritirata non appena l'assistente modifica di nuovo la bozza, sia cambiando un valore sia aggiungendo un file. Le modifiche che fa lei non la ritirano: la richiesta resta in attesa finché non pubblica o finché non scade. Una proposta di modifica a un passaporto pubblicato funziona allo stesso modo: dica di no al suo assistente e ritirerà la proposta, oppure lasci stare e scadrà dopo sette giorni.
Quanto costa?
Il connettore è incluso in ogni piano, anche in quello gratuito. Preparare le bozze non costa nulla. È la pubblicazione a richiedere un piano: il piano gratuito pubblica tre passaporti.
Con quali strumenti di chat funziona?
Claude sul web e sul desktop, Claude Code, ChatGPT, Cursor, Windsurf, VS Code con GitHub Copilot e Gemini CLI, e qualsiasi altro strumento che parli MCP su HTTP con accesso OAuth. In Claude, colleghi PassportCraft dalla directory dei connettori. In ChatGPT, lo installi dalla directory dei plugin.
Come faccio a sapere che cosa ha scritto l'assistente?
I suoi campi sono contrassegnati nell'editor ed elencati con i loro valori nella schermata di conferma che lei attraversa prima di pubblicare. Quell'elenco non viene mai accorciato. Cambi un valore lei stesso e il contrassegno sparisce.
Che cosa succede a un file inviato dall'assistente?
Entra nella libreria della sua area di lavoro e nella bozza, conservato fuori dalla portata del pubblico finché non lo pubblica lei a mano. Due cose da sapere: resta nella libreria anche quando la bozza non c'è più, e la libreria non distingue il file di un assistente da quello di una persona.
Che cosa promettete esattamente sull'assistente?
Nulla sul suo comportamento: il modello e la chat sono suoi, non nostri. La nostra promessa sta invece nella connessione stessa: scrive bozze, non può mai pubblicare, può solo proporre una modifica a un passaporto pubblicato, e ogni valore che scrive è contrassegnato e le viene nominato prima che raggiunga il pubblico. L'unica scrittura che raggiunge il pubblico senza la sua approvazione è un numero di serie su un modello di batteria già pubblicato, e lo stato di ciascuno è limitato a un elenco fisso.
Come lo scollego?
Revochi la connessione nelle Impostazioni. Si ferma subito, e i passaporti che ha preparato restano esattamente dove sono.
Colleghi oggi il suo strumento di IA
Funziona con ogni piano, anche quello gratuito. Prepari il suo primo passaporto dalla chat in pochi minuti e lo pubblichi lei stesso.