Integração MCP

O QuandoPosso oferece dois servidores MCP (Model Context Protocol) que permitem que assistentes de IA como Claude Desktop, Cursor e outros clientes MCP interajam com a plataforma sem abrir o navegador.

Servidores disponíveis

Booking MCP (público)

Permite consultar disponibilidade e agendar reuniões com qualquer usuário do QuandoPosso. Não requer autenticação.

URL: https://booking-mcp.quandoposso.com/mcp

Ferramentas:

• get_availability — Consulta horarios disponiveis de um host (por username, data e duracao). Aceita o parametro opcional slug para consultar um link de agendamento especifico (ex: quick-chat). Se omitido, usa o link padrao. Retorna accessRestricted: true se o link tiver restricoes de acesso.
• book_slot — Agenda uma reuniao em um horario disponivel. Aceita o parametro opcional slug para agendar em um link especifico. Se omitido, usa o link padrao. Se o link tiver restricoes de acesso, o email do convidado deve estar na lista de permitidos.

Config MCP (autenticado)

Permite ler e alterar suas configurações de agendamento. Requer login com Google na primeira conexão.

URL: https://config-mcp.quandoposso.com/mcp

Ferramentas:

• whoami — Verifica a conexao e retorna seus dados.
• get_settings — Retorna todas as configuracoes de agendamento.
• list_scheduling_links — Lista todos os seus links de agendamento com suas configuracoes.
• create_scheduling_link — Cria um novo link de agendamento. Recebe slug, nome, duracao, descricao, restricoes de acesso (allowedBookers) e demais configuracoes.
• update_scheduling_link — Atualiza as configuracoes de um link existente (identificado pelo slug). Permite alterar nome, duracao, horarios de trabalho, buffers pré/pós-reunião, regras de agendamento, restricoes de acesso e outros campos.
• update_working_hours — Altera dias e horarios de trabalho de um link. Aceita o parametro opcional slug (padrao: default).
• update_slot_duration — Define as duracoes de reuniao. Aceita o parametro opcional slug.
• update_buffer — Altera os buffers pré e pós-reunião. Aceita preMeetingBuffer (0-120 minutos) e postMeetingBuffer (0-120 minutos). Os buffers criam zonas de proteção ao redor de eventos existentes no calendário. Aceita o parametro opcional slug.
• update_booking_rules — Altera antecedencia minima, janela de agendamento, nome da reuniao, link do Meet e permissao de convidados. Aceita o parametro opcional slug.
• list_calendar_accounts — Lista contas do Google Calendar conectadas e suas selecoes.
• list_availability_overrides — Lista janelas de disponibilidade extra (overrides). Aceita filtros opcionais from e to (YYYY-MM-DD).
• create_availability_override — Cria uma janela de disponibilidade extra. Parametros: date, startTime, endTime, ignoreBusy (opcional, padrao: true), linkIds (opcional, lista de IDs de links), label (opcional).
• delete_availability_override — Remove uma janela de disponibilidade extra pelo ID.

Como conectar

Claude Desktop

Adicione ao arquivo ~/.claude/claude_desktop_config.json:

{
  "mcpServers": {
    "quandoposso-booking": {
      "command": "npx",
      "args": ["mcp-remote", "https://booking-mcp.quandoposso.com/mcp"]
    },
    "quandoposso-config": {
      "command": "npx",
      "args": ["mcp-remote", "https://config-mcp.quandoposso.com/mcp"]
    }
  }
}

Reinicie o Claude Desktop. Na primeira vez que usar o Config MCP, o navegador abrirá para login com Google.

Cursor / Windsurf

Use a mesma configuração acima no arquivo de configuração MCP do seu editor.

Outros clientes MCP

Qualquer cliente compatível com MCP pode se conectar usando as URLs acima. O Booking MCP aceita conexões diretas. O Config MCP usa OAuth 2.1 com registro dinâmico de clientes — o fluxo de autenticação é automático.

Exemplos de uso

Depois de conectar, peca ao seu assistente de IA:

• “Quais sao os horarios disponiveis do rafael para amanha?”
• “Veja os horarios do rafael para o link quick-chat”
• “Agende uma reuniao de 30 min com rafael amanha as 14h”
• “Agende no link consultoria do rafael para sexta as 10h”
• “Liste meus links de agendamento”
• “Crie um novo link de agendamento com slug ‘entrevista’ e duracao de 45 minutos”
• “Atualize o buffer pré-reunião do meu link consultoria para 15 minutos e o pós-reunião para 10 minutos”
• “Mostre minhas configuracoes de agendamento”
• “Configure meu horario de trabalho para segunda a sexta, 9h as 18h”

Requisitos

• Node.js 18+ (para o npx mcp-remote)
• Uma conta QuandoPosso (para o Config MCP)