Come collegare Lodgify a Meta Muse via MCP

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → Lodgify, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente git clone, niente server locale.

Lodgify + Meta Muse

Gestione di affitti brevi con Lodgify: strutture e tipi di camera, calendari di disponibilità, tariffe per notte e preventivi, prenotazioni e richieste, conversazioni con gli ospiti, check-in e check-out, codici di accesso e cambi di stato delle prenotazioni. Funziona con la chiave Public API dell'account.

Prerequisiti

Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:

LODGIFY_API_KEY

Step 1 — Ottieni le credenziali

La configurazione richiede circa 2 minuti. Ti serve il titolare dell'account Lodgify, perché solo lui vede la chiave API.

1. In Lodgify (https://app.lodgify.com) apri Settings > Public API e copia la chiave API.
2. Incollala in LODGIFY_API_KEY. Viene inviata nell'header X-ApiKey.
3. Installa il connettore ed esegui lodgify_list_properties per verificare la chiave.

La chiave dà accesso completo all'account: chiunque usi questo connettore lavora su tutte le strutture, prenotazioni e conversazioni con gli ospiti dell'account.

Cosa legge:

• Strutture e tipi di camera: lodgify_list_properties, lodgify_get_property, lodgify_list_property_rooms (gli id dei tipi di camera che servono per tariffe, disponibilità, preventivi e prenotazioni), lodgify_get_room, le strutture eliminate da una certa data, gli extra e i metodi di pagamento di una struttura.
• Disponibilità: il calendario dell'intero account, di una struttura o di un tipo di camera per un periodo, se vuoi con le prenotazioni e i periodi chiusi che bloccano le date.
• Prezzi: tariffe per notte e soggiorno minimo per giorno (lodgify_get_rates_calendar), impostazioni tariffarie (tasse, spese, acconto, regole di cancellazione, prezzo per ospite in più) e lodgify_get_quote, il totale di un possibile soggiorno con tariffa, spese, tasse, extra e codice promozionale.
• Prenotazioni: lodgify_list_bookings con stay_filter Upcoming, Current, Historic, All, oppure ArrivalDate e DepartureDate insieme a stay_filter_date (per esempio gli arrivi di oggi); lodgify_get_booking con ospite, camere, totali, importo pagato e da pagare, note, codici di accesso e conversazione; le prenotazioni dei canali collegate (Airbnb, Booking.com, Vrbo, ...); il preventivo della prenotazione e il link di pagamento per l'ospite.
• Posta in arrivo: lodgify_list_inbox (prenotazioni e richieste insieme, dalle più recenti), lodgify_count_unread, lodgify_get_enquiry e lodgify_get_thread con il thread_uid di una prenotazione o richiesta.

Cosa scrive:

• Nuova prenotazione: l'AI controlla lodgify_get_room_type_availability e lodgify_get_quote, poi chiama lodgify_create_booking. Lì Lodgify ignora lo stato, quindi l'AI conferma la prenotazione con lodgify_set_booking_booked o blocca le date con lodgify_set_booking_tentative. Con from_enquiry_id una richiesta esistente diventa la prenotazione.
• Cambi di stato: lodgify_decline_booking (le date tornano libere) e lodgify_reopen_booking (di nuovo Open; una prenotazione Booked libera le sue date).
• Arrivo e partenza: lodgify_update_key_codes imposta i codici della porta o della cassetta chiavi mostrati all'ospite; lodgify_check_in_booking e lodgify_check_out_booking registrano l'orario di arrivo e di partenza.
• Messaggi: lodgify_add_booking_messages e lodgify_add_enquiry_messages aggiungono messaggi a una conversazione; il tipo Comment salva una nota interna che l'ospite non vede. lodgify_mark_booking_replied e lodgify_mark_booking_not_replied archiviano la conversazione nella posta in arrivo.

Email agli ospiti: i messaggi con send_notification: true, lodgify_request_payment e request_payment: true in un cambio di stato inviano un'email all'ospite. L'AI ti mostra il testo e aspetta il tuo sì prima di inviare.

Disattivati all'installazione: nessuno strumento. Il connettore non ha strumenti di eliminazione e una prenotazione rifiutata si può riaprire con lodgify_reopen_booking.

Formati dei dati: gli id di strutture, tipi di camera e prenotazioni sono interi; una conversazione è un GUID (thread_uid). Le date sono YYYY-MM-DD; gli orari di check-in e check-out sono HH:mm:ss nel fuso orario della struttura; le date di modifica sono ISO 8601. Gli importi sono nella valuta della struttura (currency_code), in unità intere (120.5 = 120,50). Lo stato di una prenotazione è Open (una richiesta), Tentative, Booked o Declined; source indica il canale (Manual, AirbnbIntegration, BookingCom, ...).

Paginazione: le liste v2 accettano page (da 1) e size (predefinito 50); con include_count: true il totale arriva in count. lodgify_list_inbox usa offset e limit e restituisce total.

Errori comuni: 401 o 403 indica una chiave API mancante o errata, 404 un id sconosciuto, 400 date o parametri non validi (il corpo della risposta dice quali). 429 è il limite di richieste: l'AI aspetta e riprova.

Il connettore non modifica tariffe o disponibilità, non crea link di pagamento, non gestisce webhook e non sposta prenotazioni nel cestino.

Step 2 — Installa l'adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Step 3 — Aggiungi il connettore in Muse

L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostra YOUR_SERVER_ID.

Muse aggiunge i server MCP remoti come connettori personalizzati e vi accede con OAuth.

1. In Muse apri Settings → Connectors e scegli Add custom connector.
2. Incolla l'URL del server MCP https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.
3. Muse apre la pagina di accesso di AnythingMCP: accedi e approva l'accesso.
4. In una chat, chiedi a Muse qualcosa che richiede i tool di Lodgify.

Puoi configurarlo anche da una chat, sul web, nelle app per iOS e Android o su WhatsApp. Invia a Muse questo messaggio:

Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth

Usi il self-hosting? Usa l'indirizzo HTTPS pubblico della tua istanza al posto di https://cloud.anythingmcp.com. Muse si collega dal cloud di Meta, quindi localhost non funziona.

Tool disponibili

Esempi di prompt

• "Chi arriva oggi nelle nostre strutture? Mostrami nome dell'ospite, struttura, numero di persone e importo ancora da pagare."
• "Il Sea View Apartment è libero dal 12 al 19 luglio per 2 adulti e un cane? Quanto costerebbe il soggiorno?"
• "Quali messaggi degli ospiti non hanno ancora una risposta? Riassumi ogni conversazione."
• "Imposta il codice della cassetta chiavi 4821 per la prenotazione 1234567 e prepara un messaggio di check-in per l'ospite. Mostramelo prima di inviarlo."
• "Crea una prenotazione per Laura Bianchi nel Garden Studio dal 3 al 7 marzo e confermala."

FAQ

Dove è disponibile Muse? Al momento Meta offre Muse negli Stati Uniti e in Canada, sul web, nelle app per iOS e Android e su WhatsApp.

Meta verifica questo connettore? No. Meta non verifica i connettori personalizzati. Muse vede solo i tool che hai attivato per questo server MCP in AnythingMCP, e puoi scollegarlo in qualsiasi momento da Settings → Connectors.

Prossimi passi

• Landing del connettore
• Collegare a Claude
• Collegare a ChatGPT
• Collegare a Cursor
• Collegare a Gemini
• Collegare a Microsoft Copilot