Vai al contenuto

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.

Funziona conClaudeChatGPTCursorWindsurfGitHub Copilot+ qualsiasi client MCP

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.

URL del server
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

  1. 1
    Trovare PassportCraft

    In Claude, apra Customize → Connectors e cerchi PassportCraft. Aprire in Claude ↗

  2. 2
    Collegare il suo spazio di lavoro

    Selezioni Connect e acceda a PassportCraft. Selezioni il suo spazio di lavoro e verifichi l’accesso prima di autorizzarlo.

  3. 3
    Usarlo 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.

URL del server MCP
https://passportcraft.com/api/mcp

Una 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.

01

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.

02

Lavori nella chat

Bozze, modifiche, documenti inviati dalla chat e un controllo che nomina le lacune esatte.

03

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.

StrumentoA che cosa servePortata
list_passports · get_passportLegge il suo catalogo e qualsiasi passaporto per intero, bozze e pubblicati.Lettura
get_category_schemaChiede che cosa richiede una categoria di prodotto, prima di scrivere qualsiasi cosa.Lettura
list_custom_fieldsLegge i campi personalizzati dell’area di lavoro e le relative opzioni.Lettura
validate_passportControlla una bozza e restituisce le lacune esatte che bloccano la pubblicazione.Lettura
create_passportCrea un passaporto. Sempre come bozza.Solo bozze
update_passportModifica una bozza. Ogni campo che scrive viene contrassegnato come suo.Solo bozze
upload_documentMette 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_documentsAllega un file già presente nella sua libreria ed elenca ciò che un passaporto contiene.Solo bozze
list_libraryMostra i file già presenti nella sua libreria, così ne riusa uno invece di inviarlo due volte.Lettura
list_variantsLegge i codici a barre, le taglie e i colori salvati in un passaporto tessile o di prodotto generico.Lettura
add_variantsAggiunge 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_readingsRegistra i numeri di serie di un modello di batteria.Scrittura
request_publishLe chiede di pubblicare. Restituisce un link che apre lei. Non pubblica mai.Decide lei
get_publish_approvalLegge che fine ha fatto quella richiesta. Una richiesta il cui termine è passato scade da sola, e questa lettura è ciò che lo registra.Lettura
propose_changesPropone modifiche a un passaporto già pubblicato. Sulla pagina pubblica non cambia nulla finché Lei non approva.Decide lei
get_proposalLegge che fine ha fatto una proposta: approvata, superata, scaduta, sostituita o ritirata.Lettura
withdraw_proposalRitira 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.