MCP SERVER

EasyWeek

Servidor MCP para a plataforma de marcações EasyWeek. Faça a gestão de marcações, clientes, serviços, colaboradores e locais através de IA.

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

Funcionalidades

22 ferramentas MCP em 6 domínios: Marcações, Colaboradores, Clientes, Serviços, Locais, Disponibilidade
OAuth 2.1 com PKCE — liga-se a uma empresa EasyWeek específica
Registo Dinâmico de Cliente (RFC 7591) — as ferramentas de IA registam-se automaticamente
Anotações de segurança em cada ferramenta (readOnlyHint, destructiveHint)
Transporte HTTP sem estado — compatível com o Claude, ChatGPT, Cursor e qualquer cliente MCP

Ligar ao Claude.ai

Abra o claude.ai, clique no ícone de menu (canto inferior esquerdo) e depois em Personalizar
Vá a Conectores e clique no botão +
Introduza um nome (por exemplo, “EasyWeek”) e cole o URL: https://mcp.easyweek.io/mcp
Inicie sessão com a sua conta EasyWeek e autorize o acesso
Peça ao Claude para gerir as suas marcações, clientes e agenda

Exemplos

Exemplo 1: Consultar a agenda de hoje

Utilizador: “Mostra-me todas as marcações de hoje”

O Claude chama list_bookings e devolve:

Tem 3 marcações hoje:
10:00 — Corte de cabelo com John Doe (confirmada)
13:00 — Coloração de cabelo com Jane Smith (nova)
16:30 — Corte de cabelo com Mike Brown (confirmada)

Exemplo 2: Criar uma marcação

Utilizador: “Marca um corte de cabelo para a Anna Mueller, +49123456789, amanhã às 14:00”

O Claude chama get_availability para verificar o horário e depois create_booking:

Marcação criada para Anna Mueller:
Serviço: Corte de cabelo — 10.00 EUR
Data: 31 de março de 2026 às 14:00 (Europe/Berlin)
Estado: Nova

Exemplo 3: Encontrar o próximo horário disponível

Utilizador: “Quando é o próximo horário disponível para coloração de cabelo?”

O Claude chama get_next_available_slot:

Próximo disponível: segunda-feira, 31 de março às 09:00 (Europe/Berlin)
Serviço: Coloração de cabelo — 120 min, 21.00 EUR

Ferramentas disponíveis

Ferramentas só de leitura

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

Ferramentas de escrita

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

Ferramentas destrutivas

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)

Autenticação

A ferramenta descobre os endpoints OAuth através de /.well-known/oauth-protected-resource (RFC 9728)
Regista-se automaticamente através do Registo Dinâmico de Cliente (RFC 7591)
Redireciona-o para a página de início de sessão da EasyWeek para autorização
Recebe um token de acesso limitado à sua empresa

Não são necessárias chaves de API — basta iniciar sessão com a sua conta EasyWeek.

Privacidade e segurança

Acesso a dados: O servidor MCP só pode aceder a dados pertencentes à empresa EasyWeek autorizada
Encaminhamento de tokens: Os tokens OAuth são encaminhados para a API da EasyWeek — o servidor MCP não armazena tokens
HTTPS: Todas as ligações utilizam encriptação TLS
RGPD: A EasyWeek GmbH é uma empresa alemã com servidores na Alemanha. Todo o tratamento de dados cumpre o RGPD/DSGVO

easyweek.io/business/terms-and-policies

Apoio

E-mail: support@easyweek.io
Site: easyweek.io