Aderire al registro — per portali di annunci e software per rivenditori

Se Lei gestisce un portale di annunci, il sito web di un rivenditore o di un'agenzia, oppure un software che pubblica annunci per molti rivenditori o agenzie, può permettere agli assistenti di IA di continuare a sorvegliare la Sua offerta per conto delle persone — nel Suo Paese, nella Sua lingua, sul Suo sito. L'adesione è gratuita, non richiede alcun account né alcuna approvazione da parte nostra e di solito richiede a uno sviluppatore circa una giornata.

Che cosa ottiene#

• Le persone che usano assistenti di IA trovano i Suoi annunci. Un assistente che legge il registro (registry) vede che Lei serve, per esempio, auto usate in Polonia, e può lasciare presso di Lei il desiderio di una persona («una station wagon sotto i 60.000 zł, benzina, entro la primavera»).
• L'acquirente resta Suo. Il desiderio viene confermato sulla Sua pagina, con un indirizzo e-mail che la persona digita lì. Le corrispondenze vanno da Lei alla persona, con link ai Suoi annunci. Nulla che riguardi l'acquirente passa attraverso il registro o attraverso di noi.
• Nessun costo, nessuna esclusiva. L'iscrizione al registro è gratuita. Lei mantiene i Suoi annunci, i Suoi prezzi e il Suo flusso di contatto; può andarsene in qualsiasi momento.

Che cosa Le serve#

1. Un descrittore del detentore (holder descriptor) — un piccolo file JSON all'indirizzo https://<your host>/.well-known/isto-intents.json che dice chi è Lei e quali server gestisce (schema, esempio). Per essere iscritto, contiene "registry": { "listing": "requested", "terms": "https://istointents.org/registry/terms/" }. Scriva "specVersion": "1.0": tutto ciò di cui un portale ha bisogno qui è stabile dalla versione 1.0 e cambia solo in modo compatibile fino alla 2.0 (gestione delle versioni).
2. Un server MCP sullo stesso host, Streamable HTTP, che implementi il binding MCP con il profilo consent-link: i quattro strumenti intent_publish_intent, intent_get_intent, intent_list_matches e intent_withdraw_intent, con i nomi dei campi della sua interfaccia esatta. All'assistente non serve alcun accesso: intent_publish_intent restituisce un link alla Sua pagina, e solo la persona può confermare lì.
3. Due regole che la verifica fa rispettare: uno strumento non chiede né restituisce mai dati di contatto (nessuna e-mail, telefono, nome o indirizzo in alcuno strumento), e il server si trova sull'host che pubblica il descrittore.

Come trova le corrispondenze per un desiderio — la Sua ricerca, il Suo ordinamento, le Sue notifiche — spetta a Lei. Il protocollo definisce soltanto ciò che un assistente invia e ciò che riceve in risposta.

Parte da zero? Il detentore di riferimento è tutto quanto sopra in un unico file Node senza dipendenze — i quattro strumenti, la pagina di consenso (consent page) con double opt-in e la prova dell'inoltratore (forwarder) — con i test. Lei collega il Suo sistema di invio e-mail e la Sua ricerca; così com'è, supera la verifica e l'esecuzione di prova (trial run) descritte sotto. Per vedere di quali Paesi le persone chiedono, consulti la domanda per Paese.

Passaggi#

1. Pubblichi il descrittore e il server MCP.
2. Verifichi il Suo host qui sotto. La verifica legge il Suo descrittore e controlla i Suoi server esattamente come farà il registro, ma non iscrive nulla — la esegua tutte le volte che vuole (una volta al minuto per host).
3. Quando indica ready, invii il Suo host: POST https://istointents.org/registry/v0/submit con { "host": "<your host>" }. Viene iscritto subito e ricontrollato automaticamente; le modifiche al Suo descrittore compaiono senza un nuovo invio.
4. Facoltativo — ricevere desideri da assistenti di IA che non La conoscono ancora. La maggior parte delle persone non collega il proprio assistente a un portale; lo collega una sola volta a un inoltratore, che affida ogni desiderio a un portale che serve il Paese della persona. Per ricevere questi desideri, aggiunga al Suo descrittore "forwarding": { "accept": "requested", "terms": "https://istointents.org/forwarding/terms/" }. L'inoltratore all'indirizzo https://istointents.com/mcp chiama allora i Suoi quattro strumenti per persone dei Paesi e delle categorie che Lei serve; la persona conferma comunque sulla Sua pagina, con un indirizzo e-mail che digita lì, e l'inoltratore non lo vede mai. È gratuito e può disattivarlo in qualsiasi momento con "accept": "withdrawn". Legga prima il capitolo Inoltro (Forwarding) e le condizioni di inoltro. Prima di attivarlo, spunti esecuzione di prova nella verifica qui sotto (oppure invii "trial": "publish"): il registro chiama allora i Suoi quattro strumenti una volta, come farebbe un inoltratore, con una chiamata contrassegnata come test e ritirata subito, e risponde se Lei è pronto per l'inoltro (come funziona l'esecuzione di prova).

Un'iscrizione non è una certificazione: la verifica riguarda solo l'interfaccia (come funziona). Ogni operatore è responsabile del proprio servizio. Condizioni del registro.

Privacy. Chi è titolare del trattamento in ciascun caso e cosa aggiungere alla Sua informativa sulla privacy: il kit privacy per i portali (non è una consulenza legale; in inglese).

Domande#

Scriva al curatore del protocollo tramite istointents.com. Qui non vendiamo nulla, e non ha bisogno di parlare con noi per aderire.