Deixe o Claude marcar os seus clientes: o servidor MCP da Bookatu na prática

É uma quinta-feira à tarde e uma habitual manda email: será que consegue a manicure de gel do costume na sexta de manhã. Responder não tem nada de difícil. Abre o calendário, encontra um horário, cria a marcação, escreve a resposta. Quatro pequenos passos, num momento em que não tem uma mão livre. Agora imagine escrever uma linha a um assistente. Marca a manicure de gel do costume da Priya para sexta de manhã. O assistente consulta a sua disponibilidade real, cria a marcação, e entrega-lhe uma referência para reenviar. É isto que o servidor MCP da Bookatu torna possível.

O MCP num parágrafo

MCP quer dizer Model Context Protocol. É uma norma aberta que permite a um assistente de IA usar ferramentas que um software lhe oferece, em vez de adivinhar coisas sobre o seu negócio a partir do que encontrar pela internet. O software publica uma lista curta de ações, o assistente chama-as, e o software continua a mandar no que cada ação pode fazer. A Bookatu publica assim as suas funções básicas de marcação. Qualquer assistente que fale MCP se pode ligar, e isso inclui o Claude Desktop, o Claude Code e um número crescente de outros agentes.

Ligar é uma questão de uma chave

No seu painel da Bookatu cria uma chave de API. É-lhe mostrada exatamente uma vez, e a Bookatu guarda apenas uma impressão digital dela e não a chave em si, por isso guarde-a num sítio seguro como faria com uma palavra-passe. Depois aponta a configuração MCP do seu assistente para o endpoint da Bookatu com essa chave, e está ligado. Não há nada para instalar do lado da Bookatu e não existe uma conta de agente à parte. A chave identifica o seu negócio, por isso tudo o que o agente vê é seu e só seu.

As chaves existem em duas forças. Uma chave só de leitura pode consultar coisas mas nunca pode marcar nem alterar nada, o que a torna a escolha certa para ferramentas que só precisam de ver os seus dados. Uma chave de leitura e escrita também pode criar marcações. Pode dar uma data de validade a uma chave, e pode revogá-la a partir do painel a qualquer momento, altura em que ela deixa de funcionar imediatamente.

O que um agente ligado pode fazer

A lista de ferramentas que um agente recebe é curta e pensada:

• Ver os seus serviços: nomes, durações e preços, para saber o que é uma manicure de gel e quanto tempo demora.
• Consultar a disponibilidade: os horários realmente livres para um serviço nas datas que pedir, até 60 dias de cada vez.
• Criar uma marcação: pôr um cliente num horário com o nome e os contactos dele, e receber de volta uma referência de marcação.
• Consultar os seus clientes: para poder usar o email e o telefone da Priya a partir dos seus registos em vez de lhe pedir que os escreva.
• Listar as marcações que aí vêm: para poder responder a perguntas como qual é o aspeto da sexta-feira.

Não existe nenhuma ferramenta para apagar seja o que for, nem nada que toque na sua faturação, na sua conta ou no negócio de outra pessoa.

Um exemplo realista do princípio ao fim

De volta à Priya. Você escreve: encontra um horário na sexta de manhã para a manicure de gel do costume da Priya e marca. O assistente lista os seus serviços e encontra a manicure de gel e a sua duração. Puxa os horários livres de sexta e vê que as dez da manhã estão livres. Procura a Priya na sua lista de clientes para obter os contactos, chama a ferramenta de marcação, e volta com uma referência. A marcação está agora no seu calendário e na ficha da Priya, exatamente como se ela tivesse marcado pela sua página.

A parte digna de nota é o que ele não fez. A disponibilidade que viu era a sua disponibilidade em direto, já com o seu horário de abertura, as marcações existentes e os intervalos contabilizados, por isso não podia oferecer um horário em que não pode trabalhar. E se as dez da manhã tivessem sido ocupadas nos segundos entre consultar e marcar, a marcação é recusada em vez de ficar duplicada, e o assistente escolhe simplesmente outro horário.

Os sinais continuam a aplicar-se

Se o serviço leva um sinal, um agente não consegue dar a volta à sua política a falar. A marcação é criada como pendente, e a resposta inclui um link de pagamento para passar ao cliente, que paga da mesma forma que pagaria depois de marcar na sua página. A sua proteção contra faltas funciona da mesma maneira, não importa quem, ou o quê, fez a marcação.

Um agente recebe uma lista curta de coisas que pode fazer. Tudo o resto sobre o seu negócio está simplesmente fora de questão.

Quem manda continua a ser você

A chave é toda a relação. Foi você que a criou, a Bookatu regista quando foi usada pela última vez para que possa ver o que está ligado, e revogá-la fecha a porta na hora. Uma marcação feita por MCP segue as mesmas regras de uma feita na sua página: disponibilidade real, o seu aviso mínimo, a sua política de sinais. Os agentes ligados não têm porta das traseiras. Têm a porta da frente, com uma chave que você mandou fazer e pode recuperar.

Se quiser o detalhe mais profundo, o endpoint, as descrições das ferramentas e exemplos para copiar e colar estão todos na página de programadores da Bookatu. E se nenhuma das suas ferramentas fala MCP ainda, não muda nada para si. A sua página de marcações, os lembretes e o calendário funcionam exatamente como antes. O servidor está simplesmente lá para o dia em que quiser escrever marca a Priya para sexta em qualquer sítio que não seja o seu painel.