Os vossos dados.
Na vossa linguagem.
O servidor YOGO MCP liga o estúdio diretamente ao ChatGPT e ao Claude no browser, além de Claude Desktop, Claude Code e Gemini. Perguntem em linguagem natural, tenham a resposta em segundos. Ou usem o REST API por baixo para construir as vossas próprias integrações com CRM, stack de BI ou app para colaboradores.
# Perguntado no Claude com YOGO MCP > Quantos clientes se inscreveram no mês passado? # O Claude chama a ferramenta MCP: list_customers(auto_paginate: true) < 147 novos clientes em abril, 23% mais que em março. Quer um resumo?
# Uma primeira chamada: obter os clientes curl https://api.yogobooking.com/customers \ -H "X-API-KEY: your_api_key_here"
// Uma primeira chamada: obter os clientes const res = await fetch( 'https://api.yogobooking.com/customers', { headers: { 'X-API-KEY': process.env.YOGO_KEY } } ); const { data, hasMore, next } = await res.json();
Exemplos que podem construir esta semana.
Não é teoria. É exatamente para isto que a YOGO API foi desenhada. Cada integração custa a uma equipa de desenvolvimento alguns dias de trabalho e poupa-vos trabalho manual enquanto o estúdio existir.
Sincronizem aulas como turnos no Planday, Tamigo ou Sameworks.
Extraiam o horário de aulas do YOGO e criem turnos automaticamente no vosso sistema de escalas. O professor vê as suas aulas YOGO como turnos reais, ao lado do resto da equipa, e a exportação para salários corresponde ao que foi efetivamente dado.
// Diariamente: criar turnos no Planday const classes = await paginate( `${YOGO}/classes?from=today&to=+14d` ); for (const c of classes) { for (const teacherId of c.teacherIds) { await planday.shifts.create({ employeeId: mapTeacher(teacherId), departmentId: DEPT, startDateTime: c.startsAt, endDateTime: c.endsAt }); } }
Reatribuam professores a partir de um chat, sem abrir o módulo de admin.
Perguntem ao Claude em linguagem natural. Ele encontra a aula e o
professor através de list_classes e list_teachers,
e depois corre set_class_teachers. Cada escrita fica
registada no registo de auditoria e pode ser obtida via
list_write_logs.
# Prompt de exemplo no Claude Desktop > Põe a Mette no Vinyasa de quinta 07:00. # O Claude encontra a aula e o professor: list_classes({ from: "2026-05-14", to: "2026-05-14" }) list_teachers({ search: "Mette" }) # Escreve a alteração: set_class_teachers({ classId: 12345, teacherIds: [678] }) # Audit-log: list_write_logs({ entityType: "class.teachers" })
Sincronizem sócios no HubSpot, Mailchimp ou Klaviyo.
Corram um job noturno que obtém todos os clientes com o histórico de reservas e envia para a vossa plataforma de marketing. Segmentem por comportamento real, ativos, inativos ou recém-inscritos, e enviem campanhas adequadas.
# Noturno: sincronizar clientes para o Mailchimp let cursor; do { const res = await fetch( `${YOGO}/customers?after=${cursor || ''}`, { headers: { 'X-API-KEY': KEY } } ).then(r => r.json()); await mailchimp.lists.batchSubscribe( LIST_ID, res.data.map(toMailchimpMember) ); cursor = res.hasMore ? extractAfter(res.next) : null; } while (cursor);
Dashboards em tempo real no Power BI ou Looker Studio.
Levem reservas e dados de aulas para a vossa stack de BI, combinados com dados financeiros da contabilidade, dados de treino do Strava ou o que mais usarem. Finalmente um relatório de gestão que cobre tudo.
# Daily ETL → Power BI dataset const bookings = await paginate( `${YOGO}/bookings?from=${yesterday}` ); // Reservas + expansão de aula (requer expand=class) const bookings = await paginate( `${YOGO}/bookings?from=yesterday&to=today&expand=class` ); const rows = bookings.map(b => ({ date: b.class.startsAt, className: b.class.className, status: b.cancelledAt ? 'cancelled' : b.checkedInAt ? 'checked-in' : 'booked', customerId: b.customerId })); await powerbi.pushRows(DATASET, rows);
Enviem professores e aulas para a vossa app de colaboradores.
Sincronizem o horário de aulas e os dados dos professores para a vossa app de colaboradores, por exemplo a Monotree, para que a equipa tenha os turnos do dia, contactos e detalhes das aulas no bolso, juntamente com onboarding e comunicação interna. Uma app, uma fonte de dados.
// Envio diário para a Monotree const classes = await paginate( `${YOGO}/classes?from=today&to=+14d&expand=classType,room` ); const shifts = classes.map(c => ({ date: c.startsAt, title: c.classType.name, teacherIds: c.teacherIds, room: c.room.name })); await monotree.shifts.upsert(shifts);
O Kristian construiu uma integração sGTM e tornou-a open source.
Kristian Krogh Bang construiu uma pipeline open source que consulta
/orders, /bookings e
/customers a cada 60 segundos e encaminha os dados para
GTM server-side, e daí para GA4, Meta CAPI, Klaviyo ou o que usarem.
Todo o projeto está licenciado sob Apache 2.0 no GitHub. Boa
referência se quiserem construir algo semelhante.
Todo o estúdio.
Num só chat.
O servidor YOGO MCP corre em mcp.yogobooking.com/mcp
e expõe cada endpoint REST como uma ferramenta MCP. Com OAuth
ligam-no diretamente no ChatGPT e no Claude no browser,
ou usam a vossa chave de API no Claude Desktop, Claude Code e Gemini.
Mesma autenticação, mesmo registo de auditoria. Sem código de ligação, sem servidores para gerir.
Todo o estúdio como ferramentas
Clientes, professores, encomendas, reservas e aulas. Cada
endpoint REST está exposto como ferramenta MCP, incluindo
set_class_teachers para reatribuir professores
diretamente a partir do chat.
Mesma chave de API, mesmas regras
O servidor MCP usa a vossa chave de API existente como bearer token.
O mesmo controlo por plano e o mesmo registo de auditoria via list_write_logs.
Ligado em 5 minutos
ChatGPT, Claude no browser, Claude Desktop, Claude Code e Gemini são suportados. No browser entram com OAuth, no desktop usam a chave de API. Não é preciso código.
Um preço fixo. Tudo incluído.
O acesso à API é um add-on aos planos Studio e Studio+App.
Requer um plano Studio ou Studio+App ativo.
- Documentação pública completa
- Acesso a todos os endpoints existentes
- Novos endpoints à medida que saem, sem custo adicional
- Alojado na UE, conforme o RGPD
As letras pequenas
Disponibilizamos documentação de API completa, mas não damos apoio ao próprio trabalho de integração. Isso significa que precisam de capacidade interna para construir e manter a integração. Do nosso lado mantemos e atualizamos a API continuamente. Se tiverem dúvidas sobre o funcionamento da API, podem contactar-nos.
Se ligarem um serviço de IA através de MCP, os dados são tratados por esse fornecedor, não pelo YOGO. Usem uma conta empresarial com contrato de subcontratação, mencionem o fornecedor na vossa política de privacidade e revejam as respostas da IA antes de agir sobre algo relevante.
O que nos perguntam mais.
O que é a YOGO API?
A YOGO API é o REST API oficial da plataforma YOGO Booking. Permite que estúdios de yoga, ginásios e negócios de wellness extraiam os seus próprios dados, incluindo clientes, encomendas, reservas, aulas e professores, e construam integrações com CRM, email marketing, stacks de BI, escalas de pessoal e apps para colaboradores.
Quanto custa a YOGO API?
O acesso à API custa 79 € por mês, como add-on aos planos YOGO Studio e Studio+App. O preço inclui acesso a todos os endpoints existentes, ao servidor MCP e a endpoints futuros sem custo adicional. A documentação pública completa está disponível gratuitamente em docs.api.yogobooking.com.
O que é o servidor YOGO MCP?
O servidor YOGO MCP é um servidor Model Context Protocol que expõe os endpoints REST do YOGO como ferramentas diretamente no ChatGPT, no Claude no browser, no Claude Desktop, no Claude Code e no Gemini. Corre em mcp.yogobooking.com/mcp e partilha o mesmo registo de auditoria que o REST API. No browser ligam-se com OAuth, no desktop com a vossa chave de API como bearer token. A ligação leva cinco minutos e não exige código.
O YOGO MCP suporta OAuth?
Acrescentam mcp.yogobooking.com/mcp como conector MCP, são encaminhados para o YOGO, entram com a vossa própria conta e aprovam o acesso. Depois disso podem perguntar em linguagem natural.
Clientes como Claude Desktop, Claude Code e Gemini continuam a usar uma chave de API como bearer token. Ambos os métodos atingem os mesmos endpoints e o mesmo registo de auditoria.
Que integrações posso construir com a YOGO API?
Integrações típicas: sincronizar dados de clientes para CRM (HubSpot, Klaviyo, Mailchimp), dashboards em tempo real em ferramentas de BI (Power BI, Looker Studio, BigQuery), escalas de pessoal em que os professores aparecem como turnos (Planday, Tamigo, Sameworks), apps para colaboradores com a vossa marca e as aulas do dia (por exemplo Monotree), widgets de reserva personalizados no vosso site (Squarespace, Webflow, Next.js) e tracking de analytics server-side (sGTM → GA4, Meta CAPI). Um developer constrói normalmente uma integração padrão em poucos dias.
O YOGO dá apoio ao próprio trabalho de integração?
Não. Disponibilizamos documentação de API completa, mas não damos apoio ao próprio trabalho de integração. Isso significa que precisam de capacidade interna para construir e manter a integração, ou de contratar um developer externo. Do nosso lado mantemos e atualizamos a API continuamente, e podem contactar-nos com dúvidas sobre o funcionamento da API.
Que planos YOGO têm acesso à API?
O acesso à API está disponível como add-on aos planos YOGO Studio e Studio+App. Precisam de um plano Studio ou Studio+App ativo e depois ativam o acesso à API por 79 € por mês.
A YOGO API cumpre o RGPD?
Nota: o serviço de IA que ligam por vossa iniciativa (por exemplo Claude, ChatGPT ou Gemini) é o vosso próprio subcontratante, não o do YOGO. Os dados que a IA obtém através da API são tratados por esse fornecedor, em regra nos EUA.
Isso é lícito quando usam uma conta empresarial (Team/Business, Enterprise ou API) com contrato de subcontratação. O contrato baseia-se nas Cláusulas Contratuais-Tipo da UE e, no caso da Google, no EU-US Data Privacy Framework, o que torna a transferência para os EUA lícita.
Uma conta pessoal, mesmo paga como ChatGPT Plus ou Claude Pro, não tem contrato de subcontratação. Podem desativar o treino com os vossos dados nas definições, e devem fazê-lo, mas isso não resolve o problema: sem contrato de subcontratação continua a faltar-vos a base legal que o artigo 28 do RGPD exige quando um fornecedor trata dados pessoais em vosso nome. Lembrem-se também de mencionar o fornecedor de IA na vossa política de privacidade.
Consigo ver o que a IA fez e revogar o acesso?
A chave de API é criada no admin do YOGO em Definições e podem desativá-la a qualquer momento. Se usarem OAuth, o acesso pode ser revogado no mesmo local, sem afetar as restantes integrações.
O registo de auditoria também pode ser obtido programaticamente através de list_write_logs, para o integrarem na vossa própria monitorização.
Que conta devemos usar no fornecedor de IA?
- Claude: Team, Enterprise ou acesso à API através da Anthropic.
- ChatGPT: Business, Enterprise ou acesso à API através da OpenAI.
- Gemini: Google Workspace ou Google Cloud (Vertex AI).
Verifiquem sempre os termos e a política de privacidade do fornecedor. São eles que determinam como os vossos dados são tratados depois de saírem do YOGO.
Desativar o treino é uma boa prática em qualquer tipo de conta, mas não substitui um contrato de subcontratação. São dois problemas diferentes.
Quem é responsável pelas respostas da IA?
O YOGO fornece os dados através da API. A interpretação, o resumo e a conclusão vêm do serviço de IA, que pode errar. Usem-no como ferramenta de trabalho, não como um relatório validado por auditor.
Para operações de escrita recomendamos ativar a aprovação, para que uma pessoa confirme a alteração antes de ser guardada.
Onde corre o servidor YOGO MCP?
O servidor MCP não guarda os vossos dados. Encaminha as chamadas para o REST API do YOGO e devolve a resposta ao cliente de IA que aprovaram. Todo o tráfego é encriptado e o acesso está associado à vossa própria conta, pelo que a API só expõe dados do vosso estúdio.
Comecem pela documentação.
A documentação completa e atualizada é pública. Escrevam-nos quando estiverem prontos para ativar o acesso à API na vossa conta.