MCP

Aion dentro il tuo assistente

Aion Vibes espone un server MCP: colleghi Claude — o qualunque altro client che parli lo stesso protocollo — e da lì cerchi eventi, ti iscrivi, segui una community. Con un account collegato, crei e pubblichi le tue serate. Senza aprire il sito.

Metà degli strumenti non richiede un account.

Cercare eventi, leggerne i dettagli, iscriversi e seguire una community funzionano appena aggiungi il server: l'iscrizione manda il QR via mail e i link per il wallet, senza che nessuno debba registrarsi prima. L'account serve per creare e pubblicare — cioè per agire a nome di qualcuno.

Collegalo in quattro passi

  1. 1

    Aggiungi il server

    Nel tuo client MCP indica l’indirizzo. Non serve nessuna chiave: il client si registra da solo.

    claude mcp add --transport http aion https://api.aionvibes.com/mcp/
  2. 2

    Autorizza dal browser

    Il client apre una pagina di Aion che dice chi sta chiedendo accesso e cosa potrà fare. Accedi con Google o con la tua email, e premi Autorizza.

  3. 3

    Riapri il terminaleSalta a tutti

    Chiudi la finestra da cui hai lanciato il comando e aprine una nuova. La sessione che avevi aperto ha caricato l’elenco degli strumenti quando è partita — prima che il token esistesse — e continuerà a non vedere Aion: non è un errore da riprovare. Da un terminale nuovo, claude mcp list risponde ✔ Connected.

  4. 4

    Chiedi

    "Pubblica un evento il 15 ottobre a Brescia su Local AI vs Cloud AI, con una copertina notturna" diventa una bozza, una copertina e un evento online.

Cosa succede alle tue credenziali

Niente password nel client. Il collegamento passa da OAuth 2.1: accedi su aionvibes.com, e il client riceve un token che vale solo per lui.

PKCE obbligatorio. Il codice di autorizzazione che torna al client non basta a ottenere un token: serve un segreto che il client si è tenuto e che non è mai passato dal browser.

Un uso solo. Codici e refresh token si consumano al primo utilizzo. Il token di accesso dura un'ora e si rinnova da solo; se smetti di usarlo, dopo trenta giorni il collegamento scade.

I tuoi permessi, non di più. Il client agisce come te: vede le community che gestisci, e nient'altro. Le analytics di piattaforma rispondono solo all'account dell'amministrazione.

Gli strumenti

Trovare

Senza account

Cosa si fa, e dove. Funziona anche per chi non ha mai visto Aion.

find_events

Cerca per città, periodo, categoria o testo libero.

Include anche segnalazioni da altre piattaforme, marcate come tali: si aprono al link della fonte, non si prenotano da qui.

get_event

Il dettaglio di un evento: orario, luogo, prezzo, capienza.

Dice anche se l’iscrizione è immediata o se l’organizzatore deve approvarla.

list_event_categories

Le categorie, con slug e colore.

list_cities

Dove Aion ha eventi, e quanti.

list_featured_communities

Chi organizza con continuità.

whats_on_digest

Un riassunto di cosa si fa in città, già ridotto e ordinato.

Pensato per essere riscritto in un messaggio da incollare in un gruppo, non per essere consultato.

Partecipare

Senza account

Il punto in cui una conversazione diventa una persona iscritta a una serata. Sempre senza account.

rsvp_to_event

Iscrive qualcuno: nome, email, e il QR parte via mail.

Nessuna app da scaricare prima, nessun account da creare prima. La risposta porta già i link per il wallet, e l’iscrizione resta marcata come arrivata da un assistente.

get_wallet_pass

I link per aggiungere un biglietto ad Apple o Google Wallet.

Per chi si è iscritto e non vuole ripescare la mail.

follow_community

Il link per ricevere gli eventi di una community nel proprio calendario.

Un abbonamento iCalendar: gli eventi nuovi arrivano da soli, per sempre, senza installare niente.

Reclamare

Misto

Il tuo evento è già segnalato qui? Cercarlo è libero; prendertelo richiede un account.

find_my_listingSenza account

Cerca la tua serata fra le segnalazioni, con l’interesse che ha già raccolto.

Reazioni e follower che le persone su Aion hanno già lasciato su quell’evento — pubblico che oggi non stai vedendo.

claim_listingServe l’account

Trasforma una segnalazione in un tuo evento Aion, già compilato.

Nome, luogo, data, descrizione e copertina arrivano dalla segnalazione. Nasce in bozza: prezzo e capienza restano da impostare. Richiede un account.

Organizzare

Serve l’account

Da qui serve un account collegato.

list_my_communities

Le community che gestisci, con il loro id.

È il primo passo: un evento senza calendario non compare nella pagina di nessuna community. Ogni riga dice se l’hai creata tu o se la gestisci per qualcun altro.

create_public_event

Crea un evento — titolo, quando, dove, prezzo, capienza.

Nasce in bozza: non lo vede nessuno finché non lo pubblichi.

update_public_event

Corregge un evento, prima o dopo la pubblicazione.

Tocca solo i campi che passi: gli altri restano come sono.

design_event_cover

Compone la copertina nella tinta del topic dell'evento. Gratis.

Nessun modello dietro: nessun credito, risposta immediata, e lo stesso evento dà sempre la stessa immagine.

generate_event_cover

Genera la copertina da una descrizione e la applica.

Serve una scena vera — un locale, un palco, un piatto. Descrivi l’immagine, non l’evento. Consuma crediti.

publish_public_event

Pubblica la bozza.

Da qui l'indirizzo è raggiungibile e l'evento compare su Discover.

set_event_coupons

I codici sconto dell'evento.

Rilegge le impostazioni prima di scrivere, così non cancella domande di registrazione e template.

get_event_template

Una struttura già impostata da riempire: RSVP corto, prenotazione a persona, blocchi di pagina.

Le domande hanno chiavi che interagiscono — prezzi, condizioni, pagine — e sbagliarne una produce un modulo che sembra a posto e si comporta male.

set_registration_questions

Le domande che chi si iscrive compila: tipi, prezzi, condizioni, pagine.

Su un evento a persona il prezzo vive qui, non sul biglietto: il totale conta la base una volta sola.

set_page_sections

Programma giorno per giorno, galleria, video, FAQ, link.

È ciò che separa una pagina evento da un modulo.

set_community_sections

Gli stessi blocchi, ma appesi alla community.

Le FAQ descrivono la community e sarebbero identiche su ogni sua edizione: qui non vanno duplicate.

schedule_event_series

Una serata ricorrente: tutte le date in un colpo solo.

"Ogni giovedì fino a dicembre". La regola si espande subito in eventi veri, ognuno con la sua pagina.

list_my_public_events

Cosa hai in programma, o cosa è già passato.

Pianificare e mandare avanti la serata

Serve l’account

Quando farla, se è pronta, e come farla entrare dalla porta.

suggest_event_slot

Quale sera scegliere, guardando cosa c’è già in città quella notte.

Il conteggio viene dai listing pubblici delle altre piattaforme: è la concorrenza vera di quella sera, non quanto è pieno il nostro calendario.

event_health_check

Cosa manca a un evento prima di pubblicarlo.

Distingue quello che farà rimbalzare la pubblicazione da quello che farà solo scorrere oltre chi legge.

create_tracked_invite

Un link d’invito diverso per ogni canale.

Il codice viaggia nel parametro ref e resta sull’iscrizione. I risultati si leggono in Amministrazione › Crescita, sotto "Iscrizioni agli eventi".

check_in_guest

Segna una persona come entrata, senza aprire lo scanner.

Accetta il QR o il codice corto che l’ospite legge ad alta voce. Ripassare la stessa persona non la conta due volte.

Misurare

Serve l’account

Come sta andando.

event_registrations

Quante iscrizioni, in che stato, con le risposte al questionario.

platform_analytics

Utenti, organizzatori, eventi, iscrizioni — con il confronto sul periodo precedente.

Riservato all’account amministratore.

Per chi integra

Trasporto Streamable HTTP su https://api.aionvibes.com/mcp/. Senza intestazione Authorization la connessione riesce e gli strumenti aperti rispondono: quelli riservati restituiscono un errore che spiega come collegarsi, invece di un errore di trasporto.

Un Authorization presente ma non valido riceve 401 con l'intestazione WWW-Authenticate che indica i metadata della risorsa: è da lì che un client scopre l'authorization server da solo.

GET  /.well-known/oauth-protected-resource
GET  /.well-known/oauth-authorization-server
POST /oauth/register    registrazione dinamica (RFC 7591)
GET  /oauth/authorize   PKCE S256 obbligatorio
POST /oauth/token       authorization_code | refresh_token

I client sono pubblici: nessun client_secret da custodire. A tenere in piedi il flusso è PKCE.

Qualcosa non torna? Scrivici da akaion@akaion.com.