PER GLI ORGANIZZATORI E I LORO ASSISTENTI
Collega un assistente con MCP, prepara una galleria dell'evento, controlla l'abbinamento dei volti ed esporta i link di invito in CSV.
Leggi in Markdown · Schemi degli strumenti in JSON
findmypictures.com aiuta gli organizzatori a condividere le foto degli eventi, così gli ospiti possono trovare sé stessi e i propri amici. È adatto a matrimoni, conferenze, meetup tech, hackathon, eventi di team e celebrazioni in cui sfogliare una grande cartella condivisa sarebbe faticoso.
Gli organizzatori creano un evento, aggiungono foto e condividono l'accesso alla galleria. Gli ospiti possono sfogliare l'evento, caricare un ritratto autorizzato in «La tua selezione» per trovare le corrispondenze, scegliere singole foto, selezionare gli amici dal volto e scaricare la selezione combinata. Un download distinto comprende tutte le foto dell'evento.
Un assistente può preparare e controllare la galleria tramite MCP remoto. La consegna degli inviti consigliata è un CSV scaricato con i dati degli ospiti e i link personali, da usare nell'email o nella piattaforma eventi che l'organizzatore usa già. È previsto un supporto più dedicato per gli inviti; non promettere la sincronizzazione automatica dei partecipanti né la gestione delle campagne.
Prima di impegnarti su un evento, verifica sul sito questi dati aggiornati: disponibilità dell'account, prezzi e limiti del piano. Una connessione MCP non aggira i limiti dell'account. L'abbinamento dei volti è approssimativo; controlla i risultati. La personalizzazione non limita ciascun ospite alle sole proprie foto.
Usa un client che supporti MCP remoto su Streamable HTTP e OAuth nel browser. Un prompt incollato non può installare il supporto MCP in un client che ne è privo. La disponibilità della connessione dipende dal client, dal piano dell'account e dall'amministratore dell'area di lavoro.
Nelle impostazioni di connessione MCP personalizzata dell'assistente, inserisci l'URL del server qui sotto e scegli OAuth. Apri il flusso di autorizzazione nel browser, accedi a findmypictures.com, controlla l'indirizzo di callback e approva la connessione. Non incollare mai in chat le password dell'account, i cookie di sessione o i token di accesso.
Per Claude, usa Settings → Connectors → Add custom connector. Per ChatGPT, usa i controlli di app personalizzata o MCP disponibili per il tuo account. Potrebbe essere necessaria la developer mode, oppure l'approvazione di un amministratore. I client di sviluppo devono usare la propria configurazione MCP su HTTP remoto con questo stesso URL. Se il menu è diverso, controlla le istruzioni aggiornate del client.
Per un client personalizzato: individua il server di autorizzazione tramite la challenge WWW-Authenticate e i metadati della risorsa protetta. Usa la registrazione dinamica del client con token_endpoint_auth_method none, authorization code con PKCE S256 e scope app:manage. Invia i token bearer nell'header Authorization, mai nell'URL. I token di accesso scadono dopo un'ora; usa il flusso di refresh OAuth e conserva il refresh token sostitutivo.
Dopo l'autorizzazione, inizializza MCP, scopri gli strumenti con tools/list e chiama list_events per verificare l'accesso. Un elenco vuoto può indicare una connessione riuscita senza eventi. Sono accessibili solo gli eventi dell'account collegato. Il server espone strumenti; non presumere che esistano gli endpoint resources o prompts di MCP.
Gestisci e revoca le connessioni da «Collega l'IA» nel tuo account organizzatore. La revoca blocca le chiamate future e i refresh del token; il lavoro già in coda può continuare. Questa connessione ha accesso di gestione, che include la rimozione di foto e ospiti e l'invio facoltativo di email; non è una connessione in sola lettura.
URL del server: https://findmypictures.com/mcp
Metadati della risorsa protetta: https://findmypictures.com/.well-known/oauth-protected-resource/mcp
Metadati del server di autorizzazione: https://findmypictures.com/.well-known/oauth-authorization-serverEsempio di richiesta dell'utente:
«Crea una galleria per il meetup della nostra comunità a partire da questo ZIP. Controlla l'elaborazione e dammi i dettagli di accesso alla galleria. L'invito lo distribuisco io.»
Esempio di argomenti di tools/call per create_event:
{"name":"create_event","arguments":{"title":"Community meetup","request_key":"meetup-create-20261104-01"}}L'esportazione CSV è il flusso principale per gli inviti. Prepara la consegna, che l'organizzatore invia con la propria email, con la stampa unione o con la piattaforma eventi. L'esportazione non invia messaggi, non sincronizza una piattaforma di partecipanti e non traccia una campagna. È previsto un supporto più dedicato per gli inviti.
Esempio di input ospiti:
email,name,linkedin,image_url
[email protected],Ada,,
[email protected],Sam,,https://images.example.com/authorized-portrait.jpg
Esempio di richiesta:
«Importa questo CSV ospiti, controlla i risultati dei ritratti e prepara un CSV di invito per il mio strumento email. Non inviare messaggi.»
Invito suggerito:
«Le foto dell'evento [titolo dell'evento] sono pronte: [URL della galleria]. Password: [password].
Il tuo link personale: [personal_link]. Sfoglia l'evento o aggiungi un ritratto per trovare le tue foto. Puoi anche selezionare gli amici dal volto. Per correzioni o richieste di rimozione, contatta [organizzatore].»Un'associazione ospite collega un indirizzo email, un nome facoltativo, le origini del ritratto e un link personale alla galleria. Il recupero del ritratto e l'elaborazione del volto avvengono in background. Il recupero da LinkedIn può fallire; un ritratto fornito può non contenere un volto utilizzabile. Un ritratto pronto può comunque avere zero corrispondenze con le foto.
Controlla portrait_status, portrait_error e match_count con list_guests. Usa guest_matches per le foto effettivamente abbinate. Se hai l'autorizzazione, carica un ritratto più nitido per quell'ospite, poi controlla di nuovo l'elaborazione. L'abbinamento può non trovare una persona oppure includere la persona sbagliata; i conteggi non sono una prova di identità né di copertura completa.
Gli ospiti possono sfogliare l'intera raccolta dell'evento, usare «La tua selezione» per cercare da un ritratto, scegliere singole foto e selezionare i volti degli amici per ampliare la selezione combinata. I link personali organizzano l'esperienza intorno a un ospite; non la rendono una galleria in cui quell'ospite accede solo alle proprie immagini.
Quando aggiungi foto a un evento esistente, usa lo stesso event_id, trasferisci solo le aggiunte previste, controlla duplicati e risultati dell'importazione e attendi l'elaborazione. Controlla di nuovo le corrispondenze degli ospiti prima di dire che le selezioni personali sono state aggiornate.
set_social_settings cambia se la condivisione social è attiva per l'evento, la scelta della piattaforma tra LinkedIn e X e la didascalia. Configura il comportamento della condivisione; un aggiornamento riuscito delle impostazioni non significa che un post sia stato pubblicato. Non invia inviti. Chiedi all'organizzatore di controllare il risultato visibile agli ospiti prima di distribuire la galleria.
download_photos restituisce un URL HTTP autenticato per tutte le foto oppure per gli ID delle foto selezionate. Il client deve recuperarlo con il token bearer OAuth. Non è un invito pubblico né un link di download per gli ospiti. I download selezionati accettano fino a 400 ID foto; il pacchetto di tutte le foto considera fino a 8.000 foto pronte. Non affermare, senza controllare, che una raccolta in corso o più ampia sia rappresentata per intero.
delete_photo rimuove in modo permanente una foto dell'evento. delete_guest rimuove l'associazione ospite, il ritratto e le corrispondenze. Usali solo se l'utente ha autorizzato quella rimozione. Tramite MCP non sono disponibili né l'eliminazione dell'evento né la modifica della password dell'account o della galleria; per queste operazioni usa il browser.
send_invitations è una capacità facoltativa di email diretta, non la consegna degli inviti consigliata. Usala solo se l'utente chiede espressamente l'invio tramite l'app. Nel risultato controlla configured, ok, sent, failures ed error. Se l'email non è configurata, il risultato contiene bozze e non è avvenuta alcuna consegna. Segnala gli errori parziali. Non ritentare un invio incerto con una nuova chiave.
Accerta i permessi necessari e la base giuridica per tutte le persone interessate prima di caricare ed elaborare le loro immagini. Gli ospiti possono sfogliare l'evento senza usare la ricerca per ritratto. Nell'invito indica un contatto per correzioni e rimozioni.
Le password della galleria proteggono l'interfaccia della galleria, ma gli URL diretti delle immagini possono essere aperti da chiunque li conosca. Non descrivere il prodotto come un caveau confidenziale di immagini, come cifrato end-to-end, come certificato GDPR in modo indipendente o come un sistema di controllo degli accessi per persona.
Il periodo di disponibilità delle gallerie dipende dal piano: le gallerie del piano Gratuito sono disponibili per sei mesi dalla prima pubblicazione, le gallerie del piano Evento singolo per 365 giorni dalla prima pubblicazione e le gallerie del piano Organizzatore finché l'abbonamento è attivo. Al termine di un abbonamento Organizzatore si applicano i limiti del piano Gratuito. La scadenza dell'accesso non significa di per sé che le foto, le anteprime, i ritratti o le caratteristiche facciali memorizzati siano stati eliminati. Gli organizzatori possono eliminare le gallerie quando non sono più necessarie. I dati dell'account sono conservati per l'uso dell'account; puoi richiederne l'eliminazione via email. I dati necessari per obblighi di legge o pretese legali possono essere conservati con uso limitato.
La scadenza dell'accesso non è una cancellazione. L'organizzatore elimina una galleria nel browser quando la condivisione deve terminare. Scollegare un assistente non elimina l'evento. Revocare la connessione blocca le chiamate future e i refresh del token; il lavoro già in coda può continuare. Rimuovere una foto o un'associazione ospite è un'azione separata e avviene solo quando la autorizzi. Leggi le pagine su privacy e sicurezza dei dati prima di scegliere il servizio per foto sensibili.
Dopo la connessione, consulta tools/list per gli schemi di input autorevoli. Gli strumenti in sola lettura ispezionano i dati; le mutazioni richiedono request_key. La disponibilità di uno strumento non dimostra che un client possa trasferire file.
list_eventsElenca i tuoi eventi con i conteggi di foto e di ospiti.
Scegli una galleria esistente ed evita di crearne un duplicato.
{
"additionalProperties": false,
"properties": {},
"title": "Args",
"type": "object"
}get_eventLeggi i dettagli dell'evento e i dettagli di accesso alla galleria. Tratta le credenziali della galleria come private.
Recupera i dettagli di accesso generale per gli ospiti e l'URL dell'organizzatore; tieni private le credenziali.
{
"additionalProperties": false,
"properties": {
"event_id": {
"format": "uuid",
"title": "Event Id",
"type": "string"
}
},
"required": [
"event_id"
],
"title": "Event",
"type": "object"
}create_eventCrea una galleria dell'evento con impostazioni facoltative di condivisione social.
Crea una galleria, non foto né inviti. Si applicano i limiti dell'account sul numero di eventi.
{
"additionalProperties": false,
"properties": {
"request_key": {
"description": "Unique operation key; reuse only for retries of identical arguments.",
"maxLength": 100,
"minLength": 8,
"title": "Request Key",
"type": "string"
},
"social_caption": {
"default": "",
"maxLength": 280,
"title": "Social Caption",
"type": "string"
},
"social_enabled": {
"default": true,
"title": "Social Enabled",
"type": "boolean"
},
"social_platform": {
"default": "linkedin",
"enum": [
"linkedin",
"x"
],
"title": "Social Platform",
"type": "string"
},
"title": {
"maxLength": 140,
"minLength": 2,
"title": "Title",
"type": "string"
}
},
"required": [
"request_key",
"title"
],
"title": "Create",
"type": "object"
}list_photosElenca le foto e gli stati di elaborazione; segui l'offset next restituito.
Controlla gli stati delle foto e segui l'offset next restituito.
{
"additionalProperties": false,
"properties": {
"event_id": {
"format": "uuid",
"title": "Event Id",
"type": "string"
},
"offset": {
"default": 0,
"maximum": 20000,
"minimum": 0,
"title": "Offset",
"type": "integer"
}
},
"required": [
"event_id"
],
"title": "Page",
"type": "object"
}event_statusLeggi l'avanzamento dell'elaborazione di foto e ritratti e lo stato di importazione della sorgente.
Distingui l'elaborazione dall'importazione della sorgente; il lavoro in sospeso e quello non riuscito richiedono attenzione.
{
"additionalProperties": false,
"properties": {
"event_id": {
"format": "uuid",
"title": "Event Id",
"type": "string"
}
},
"required": [
"event_id"
],
"title": "Event",
"type": "object"
}list_guestsElenca le associazioni email/LinkedIn degli ospiti, gli stati dei ritratti e i conteggi delle corrispondenze, 80 per pagina.
Controlla i ritratti e i conteggi delle corrispondenze; segui gli offset next, 80 ospiti per pagina.
{
"additionalProperties": false,
"properties": {
"event_id": {
"format": "uuid",
"title": "Event Id",
"type": "string"
},
"offset": {
"default": 0,
"maximum": 20000,
"minimum": 0,
"title": "Offset",
"type": "integer"
}
},
"required": [
"event_id"
],
"title": "Page",
"type": "object"
}guest_matchesLeggi le foto abbinate a un ospite.
Controlla le corrispondenze foto attuali di un ospite; l'abbinamento è approssimativo.
{
"additionalProperties": false,
"properties": {
"event_id": {
"format": "uuid",
"title": "Event Id",
"type": "string"
},
"guest_id": {
"format": "uuid",
"title": "Guest Id",
"type": "string"
}
},
"required": [
"event_id",
"guest_id"
],
"title": "Guest",
"type": "object"
}import_guests_csvImporta associazioni CSV/TSV in UTF-8; unisci per email e restituisci gli avvisi di validazione.
Unisci per email; controlla gli avvisi. Le origini del ritratto possono mettere in coda l'abbinamento.
{
"additionalProperties": false,
"properties": {
"csv_text": {
"maxLength": 2000000,
"title": "Csv Text",
"type": "string"
},
"event_id": {
"format": "uuid",
"title": "Event Id",
"type": "string"
},
"request_key": {
"description": "Unique operation key; reuse only for retries of identical arguments.",
"maxLength": 100,
"minLength": 8,
"title": "Request Key",
"type": "string"
}
},
"required": [
"request_key",
"event_id",
"csv_text"
],
"title": "CSV",
"type": "object"
}export_guests_csvConsegna principale degli inviti: esporta come testo CSV le associazioni ospiti, i link personali alla galleria e i conteggi delle corrispondenze. Non invia inviti.
Consegna principale degli inviti: restituisce testo CSV con i link personali; non invia messaggi.
{
"additionalProperties": false,
"properties": {
"event_id": {
"format": "uuid",
"title": "Event Id",
"type": "string"
}
},
"required": [
"event_id"
],
"title": "Event",
"type": "object"
}upload_instructionsOttieni gli URL per caricare direttamente CSV e ritratti e le istruzioni per il caricamento riprendibile delle foto.
Ottieni gli endpoint autenticati per il trasferimento dei dati grezzi e un'alternativa nel browser.
{
"additionalProperties": false,
"properties": {
"event_id": {
"format": "uuid",
"title": "Event Id",
"type": "string"
}
},
"required": [
"event_id"
],
"title": "Event",
"type": "object"
}create_photo_uploadRiserva un caricamento tus riprendibile per una foto o uno ZIP. Restituisce l'URL di caricamento; invia i byte via HTTP.
Riserva un caricamento tus; i byte vanno ancora trasferiti ed elaborati.
{
"additionalProperties": false,
"properties": {
"event_id": {
"format": "uuid",
"title": "Event Id",
"type": "string"
},
"filename": {
"maxLength": 240,
"minLength": 1,
"title": "Filename",
"type": "string"
},
"request_key": {
"description": "Unique operation key; reuse only for retries of identical arguments.",
"maxLength": 100,
"minLength": 8,
"title": "Request Key",
"type": "string"
},
"size_bytes": {
"exclusiveMinimum": 0,
"maximum": 10737418240,
"title": "Size Bytes",
"type": "integer"
}
},
"required": [
"request_key",
"event_id",
"filename",
"size_bytes"
],
"title": "Upload",
"type": "object"
}import_fileImporta un file o un riferimento allegato, oppure un URL di file HTTPS: foto/ZIP fino a 80 MiB, CSV fino a 2 MB, ritratto fino a 15 MiB. Le gallerie più grandi usano il caricamento riprendibile.
Importa un URL di file leggibile; controlla il lavoro in coda e non presumere che sia pronto.
{
"$defs": {
"FileRef": {
"additionalProperties": false,
"properties": {
"download_url": {
"maxLength": 8000,
"title": "Download Url",
"type": "string"
},
"file_id": {
"maxLength": 300,
"title": "File Id",
"type": "string"
},
"file_name": {
"default": "",
"title": "File Name",
"type": "string"
},
"mime_type": {
"default": "",
"title": "Mime Type",
"type": "string"
}
},
"required": [
"download_url",
"file_id"
],
"title": "FileRef",
"type": "object"
}
},
"additionalProperties": false,
"properties": {
"event_id": {
"format": "uuid",
"title": "Event Id",
"type": "string"
},
"file": {
"$ref": "#/$defs/FileRef"
},
"filename": {
"maxLength": 240,
"minLength": 1,
"title": "Filename",
"type": "string"
},
"guest_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Guest Id"
},
"purpose": {
"enum": [
"photos",
"guests_csv",
"portrait"
],
"title": "Purpose",
"type": "string"
},
"request_key": {
"description": "Unique operation key; reuse only for retries of identical arguments.",
"maxLength": 100,
"minLength": 8,
"title": "Request Key",
"type": "string"
}
},
"required": [
"request_key",
"event_id",
"file",
"purpose",
"filename"
],
"title": "FileImport",
"type": "object"
}upload_statusLeggi l'offset durevole del caricamento, lo stato di importazione e i risultati.
Controlla offset durevole, stato di importazione, risultato ed errore di un caricamento.
{
"additionalProperties": false,
"properties": {
"event_id": {
"format": "uuid",
"title": "Event Id",
"type": "string"
},
"upload_id": {
"pattern": "^[a-f0-9]{32}$",
"title": "Upload Id",
"type": "string"
}
},
"required": [
"event_id",
"upload_id"
],
"title": "UploadStatus",
"type": "object"
}import_gallery_sourceImporta foto da un URL supportato di galleria o di condivisione esterna. Restituisce un job in background.
Metti in coda l'importazione di un album esterno; monitora source_import in event_status.
{
"additionalProperties": false,
"properties": {
"event_id": {
"format": "uuid",
"title": "Event Id",
"type": "string"
},
"password": {
"default": "",
"maxLength": 500,
"title": "Password",
"type": "string"
},
"request_key": {
"description": "Unique operation key; reuse only for retries of identical arguments.",
"maxLength": 100,
"minLength": 8,
"title": "Request Key",
"type": "string"
},
"url": {
"maxLength": 2000,
"title": "Url",
"type": "string"
}
},
"required": [
"request_key",
"event_id",
"url"
],
"title": "Source",
"type": "object"
}set_social_settingsConfigura la condivisione LinkedIn/X e la didascalia di un evento.
Configura le impostazioni di condivisione; non dimostra che un post social sia stato pubblicato.
{
"additionalProperties": false,
"properties": {
"caption": {
"default": "",
"maxLength": 280,
"title": "Caption",
"type": "string"
},
"enabled": {
"title": "Enabled",
"type": "boolean"
},
"event_id": {
"format": "uuid",
"title": "Event Id",
"type": "string"
},
"platform": {
"default": "linkedin",
"enum": [
"linkedin",
"x"
],
"title": "Platform",
"type": "string"
},
"request_key": {
"description": "Unique operation key; reuse only for retries of identical arguments.",
"maxLength": 100,
"minLength": 8,
"title": "Request Key",
"type": "string"
}
},
"required": [
"request_key",
"event_id",
"enabled"
],
"title": "Social",
"type": "object"
}send_invitationsEmail diretta facoltativa, solo quando viene richiesta in modo esplicito. Per la consegna degli inviti preferisci export_guests_csv. Controlla i risultati di consegna; le bozze non sono email inviate.
Email diretta facoltativa, solo su richiesta esplicita. Controlla la consegna rispetto alle bozze.
{
"additionalProperties": false,
"properties": {
"emails": {
"items": {
"maxLength": 254,
"minLength": 3,
"type": "string"
},
"maxItems": 500,
"minItems": 1,
"title": "Emails",
"type": "array"
},
"event_id": {
"format": "uuid",
"title": "Event Id",
"type": "string"
},
"personal": {
"default": true,
"title": "Personal",
"type": "boolean"
},
"request_key": {
"description": "Unique operation key; reuse only for retries of identical arguments.",
"maxLength": 100,
"minLength": 8,
"title": "Request Key",
"type": "string"
}
},
"required": [
"request_key",
"event_id",
"emails"
],
"title": "Email",
"type": "object"
}download_photosOttieni un URL di download HTTP autenticato per tutte le foto o per quelle selezionate.
Restituisce un URL autenticato con bearer, non un link pubblico per gli ospiti.
{
"additionalProperties": false,
"properties": {
"event_id": {
"format": "uuid",
"title": "Event Id",
"type": "string"
},
"kind": {
"default": "all",
"enum": [
"all",
"selected"
],
"title": "Kind",
"type": "string"
},
"photo_ids": {
"default": [],
"items": {
"format": "uuid",
"type": "string"
},
"maxItems": 400,
"title": "Photo Ids",
"type": "array"
}
},
"required": [
"event_id"
],
"title": "Download",
"type": "object"
}delete_photoElimina in modo permanente una foto dal tuo evento.
Rimuovi in modo permanente una foto solo con l'autorizzazione dell'utente.
{
"additionalProperties": false,
"properties": {
"event_id": {
"format": "uuid",
"title": "Event Id",
"type": "string"
},
"photo_id": {
"format": "uuid",
"title": "Photo Id",
"type": "string"
},
"request_key": {
"description": "Unique operation key; reuse only for retries of identical arguments.",
"maxLength": 100,
"minLength": 8,
"title": "Request Key",
"type": "string"
}
},
"required": [
"request_key",
"event_id",
"photo_id"
],
"title": "RemovePhoto",
"type": "object"
}delete_guestRimuovi dal tuo evento un'associazione ospite, il ritratto e le corrispondenze.
Rimuovi un'associazione ospite, il ritratto e le corrispondenze solo con l'autorizzazione dell'utente.
{
"additionalProperties": false,
"properties": {
"event_id": {
"format": "uuid",
"title": "Event Id",
"type": "string"
},
"guest_id": {
"format": "uuid",
"title": "Guest Id",
"type": "string"
},
"request_key": {
"description": "Unique operation key; reuse only for retries of identical arguments.",
"maxLength": 100,
"minLength": 8,
"title": "Request Key",
"type": "string"
}
},
"required": [
"request_key",
"event_id",
"guest_id"
],
"title": "RemoveGuest",
"type": "object"
}Leggi le informazioni sulla privacy e le informazioni sulla sicurezza dei dati. Consulta i piani attuali prima di scegliere una galleria.