MCP SERVER

EasyWeek

Server MCP per la piattaforma di prenotazioni EasyWeek. Gestisci prenotazioni, clienti, servizi, personale e sedi tramite l'IA.

https://mcp-next.easyweek.io/mcp

Funzionalità

22 strumenti MCP suddivisi in 6 ambiti: Prenotazioni, Personale, Clienti, Servizi, Sedi, Disponibilità
OAuth 2.1 con PKCE — si collega a una specifica azienda EasyWeek
Registrazione dinamica dei client (RFC 7591) — gli strumenti di IA si registrano automaticamente
Annotazioni di sicurezza su ogni strumento (readOnlyHint, destructiveHint)
Trasporto HTTP stateless — compatibile con Claude, ChatGPT, Cursor e qualsiasi client MCP

Collegarsi a Claude.ai

Apra claude.ai, clicchi sull'icona del menu (in basso a sinistra), poi su Personalizza
Vada su Connettori, clicchi sul pulsante +
Inserisca un nome (es. «EasyWeek») e incolli l'URL: https://mcp.easyweek.io/mcp
Acceda con il suo account EasyWeek e autorizzi l'accesso
Chieda a Claude di gestire le sue prenotazioni, i suoi clienti e la sua agenda

Esempi

Esempio 1: Controllare l'agenda di oggi

Utente: «Mostrami tutte le prenotazioni di oggi»

Claude chiama list_bookings e restituisce:

Ha 3 prenotazioni oggi:
10:00 — Taglio di capelli con John Doe (confermata)
13:00 — Colorazione con Jane Smith (nuova)
16:30 — Taglio di capelli con Mike Brown (confermata)

Esempio 2: Prenotare un appuntamento

Utente: «Prenota un taglio di capelli per Anna Mueller, +49123456789, domani alle 14:00»

Claude chiama get_availability per verificare lo slot, poi create_booking:

Prenotazione creata per Anna Mueller:
Servizio: Taglio di capelli — 10.00 EUR
Data: 31 marzo 2026 alle 14:00 (Europe/Berlin)
Stato: Nuova

Esempio 3: Trovare il prossimo slot disponibile

Utente: «Qual è il prossimo slot disponibile per una colorazione?»

Claude chiama get_next_available_slot:

Prossimo slot disponibile: lunedì 31 marzo alle 09:00 (Europe/Berlin)
Servizio: Colorazione — 120 min, 21.00 EUR

Strumenti disponibili

Strumenti di sola lettura

Domain	Tool	Description
Workspace	`get_workspace`	Get current company info
Locations	`list_locations`	List all locations
Locations	`get_location`	Get location details
Staff	`list_staff`	List staff at location
Staff	`list_staff_categories`	List staff categories
Services	`list_services`	List services at location
Services	`get_service`	Get service details
Services	`list_service_categories`	List service categories
Services	`list_payment_accounts`	List payment accounts
Availability	`get_availability`	Get available time slots
Availability	`get_next_available_slot`	Get next available slot
Bookings	`list_bookings`	List bookings with date, location, staff and status filters
Bookings	`get_booking`	Get booking details
Bookings	`list_booking_statuses`	List available statuses
Customers	`list_customers`	List customers
Customers	`find_customer`	Find a customer by phone or email
Customers	`get_customer`	Get customer details
Customers	`get_customer_bookings`	Get customer's bookings
Orders	`list_orders`	List point-of-sale orders
Orders	`get_order`	Get order details
Goods	`list_goods`	List products (goods)
Vouchers	`list_voucher_templates`	List gift voucher templates
Messaging	`get_messaging_balance`	Wallet balances, limits and auto-reload
Messaging	`get_message_history`	Sent messages with delivery status
Messaging	`get_message_status`	One sent message with its status
Messaging	`check_phone`	Can a phone number receive SMS
Reminders	`list_reminders`	Automatic reminders with status and channel
Reminders	`get_reminder_templates`	Templates of a reminder per channel and locale
Reminders	`get_moderation_status`	Templates waiting for moderation

Strumenti di scrittura

Domain	Tool	Description
Bookings	`create_booking`	Create new booking
Bookings	`create_blocked_spot`	Block time on a staff member's calendar
Customers	`create_customer`	Create a customer
Orders	`create_order`	Create a point-of-sale order
Services	`create_service`	Create a service
Vouchers	`create_voucher_template`	Create a gift voucher template

Strumenti distruttivi

Domain	Tool	Description
Bookings	`cancel_booking`	Cancel a booking
Bookings	`complete_booking`	Complete a booking
Bookings	`change_booking_status`	Change booking status
Bookings	`reschedule_booking`	Reschedule booking to new date/time
Bookings	`change_booking_staffer`	Reassign a booking to another staff member
Bookings	`replace_booking_service`	Replace the service of a booking
Bookings	`update_booking_notes`	Update booking notes
Customers	`update_customer`	Update a customer's details and messaging contacts
Orders	`refund_order`	Refund a paid order
Orders	`pay_order`	Pay an open order
Services	`update_service`	Update a service
Messaging	`set_autoreload`	Configure automatic wallet top-up
Reminders	`enable_reminder`	Turn a reminder on
Reminders	`pause_reminder`	Pause a reminder
Reminders	`update_reminder_template`	Set channel and texts of a reminder (moderated)

Autenticazione

Lo strumento individua gli endpoint OAuth tramite /.well-known/oauth-protected-resource (RFC 9728)
Si registra automaticamente tramite la registrazione dinamica dei client (RFC 7591)
La reindirizza alla pagina di accesso di EasyWeek per l'autorizzazione
Riceve un token di accesso limitato alla sua azienda

Non servono chiavi API — basta accedere con il suo account EasyWeek.

Privacy e sicurezza

Accesso ai dati: il server MCP può accedere solo ai dati appartenenti all'azienda EasyWeek autorizzata
Inoltro dei token: i token OAuth vengono inoltrati all'API EasyWeek — il server MCP non memorizza i token
HTTPS: tutte le connessioni utilizzano la crittografia TLS
GDPR: EasyWeek GmbH è una società tedesca con server in Germania. Tutto il trattamento dei dati è conforme al GDPR/DSGVO

easyweek.io/business/terms-and-policies

Assistenza

E-mail: support@easyweek.io
Sito web: easyweek.io