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.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	`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
Bookings	`get_booking`	Get booking details
Bookings	`list_booking_statuses`	List available statuses
Customers	`list_customers`	List customers
Customers	`get_customer`	Get customer details
Customers	`get_customer_bookings`	Get customer's bookings

Ferramentas de escrita

Domain	Tool	Description
Bookings	`create_booking`	Create new booking
Bookings	`complete_booking`	Complete a booking
Bookings	`change_booking_status`	Change booking status
Bookings	`reschedule_booking`	Reschedule booking to new date/time
Bookings	`update_booking_notes`	Update booking notes

Ferramentas destrutivas

Domain	Tool	Description
Bookings	`cancel_booking`	Cancel a booking

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