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 horários disponíveis de um host (por username, data e duração).
• book_slot — Agenda uma reunião em um horário disponível.

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 conexão e retorna seus dados.
• get_settings — Retorna todas as configurações de agendamento.
• update_working_hours — Altera seus dias e horários de trabalho.
• update_slot_duration — Define as durações de reunião disponíveis.
• update_buffer — Altera o intervalo entre reuniões.
• update_booking_rules — Altera antecedência mínima, janela de agendamento, nome da reunião, link do Meet e permissão de convidados.
• list_calendar_accounts — Lista contas do Google Calendar conectadas e suas seleções.

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, peça ao seu assistente de IA:

• “Quais são os horários disponíveis do rafael para amanhã?”
• “Agende uma reunião de 30 min com rafael amanhã às 14h”
• “Mostre minhas configurações de agendamento”
• “Altere meu buffer entre reuniões para 15 minutos”
• “Configure meu horário de trabalho para segunda a sexta, 9h às 18h”

Requisitos

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