MCP: Agenda
Disponibilidade, reuniões e transcrições pelo MCP. 5 ferramentas.
Ferramentas desta área, geradas do código do servidor. As descrições vêm desse código, em português. Para conectar, veja o MCP da XBASE.
cancel-meeting
Cancela uma reunião agendada, pelo ID devolvido por list-meetings ou create-meeting. Confirme com a pessoa antes: o horário deixa de constar na agenda (e o evento some do Google Calendar da agenda do quadro). Passe workspaceId para restringir a reuniões da agenda do quadro daquele workspace; para reuniões da agenda antiga, omita o workspaceId.
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
meetingId | sim | ID da reunião a cancelar |
workspaceId | não | ID do workspace (opcional): restringe a reuniões da agenda do quadro desse workspace |
create-meeting
Agenda uma reunião. PREFIRA passar boardId (quadro da negociação) e threadId: a reunião vai para a agenda do quadro (definida em Configurações do Quadro) — cria o evento no Google Calendar vinculado com link do Meet e convite ao contato, registra no CRM vinculado à thread e recusa (409) horário ocupado sugerindo alternativas; sem endAt usa a duração da agenda (ex.: 40 min). Antes, chame get-meeting-availability e use o startAt exatamente como veio. Para remarcar, passe replaceMeetingId com o ID da reunião antiga. Sem boardId/calendarId/threadId, usa a agenda antiga do workspace (sem Google/Meet; title e endAt obrigatórios). Se vier erro de agenda (quadro sem agenda, Google desconectado/expirado), chame um humano.
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
workspaceId | sim | ID do workspace |
title | não | Título da reunião (ex: "Call de alinhamento"). Obrigatório sem boardId/calendarId/threadId; com eles, o padrão é "Reunião com <contato>" |
startAt | sim | Início em ISO 8601 com fuso (ex: 2026-09-01T14:00:00.000Z) — use o startAt devolvido por get-meeting-availability |
endAt | não | Fim em ISO 8601 com fuso, posterior ao início. Obrigatório sem boardId/calendarId/threadId; com eles, o padrão é a duração da agenda |
boardId | não | ID do quadro: usa a agenda do quadro (recomendado) |
calendarId | não | ID da agenda (alternativa a boardId; não envie os dois) |
threadId | não | ID da thread (negociação) para vincular a reunião; sem boardId/calendarId, usa a agenda do quadro da thread |
durationMinutes | não | Duração em minutos (10 a 480), no lugar de endAt — só com boardId/calendarId/threadId |
createMeet | não | Criar link do Google Meet (padrão true na agenda do quadro; ignorado na agenda antiga) |
replaceMeetingId | não | Remarcação: ID da reunião antiga da mesma thread, cancelada depois que a nova é criada |
description | não | Pauta ou observações |
contactId | não | ID do contato do CRM, para vincular a reunião a ele |
attendees | não | E-mails convidados |
get-meeting-availability
Horários LIVRES na agenda de um quadro (use boardId; a agenda é a definida em Configurações do Quadro → Agenda do Quadro) ou de uma agenda específica (calendarId) — informe exatamente um dos dois. Já desconta o Google Calendar vinculado e as reuniões do CRM, respeita a janela da agenda (ex.: seg–qui 14h–17h, horário de Brasília) e a antecedência mínima, e devolve os mais próximos primeiro. Mostre ao contato o rótulo em horário de Brasília (ex.: "seg, 29/09 às 14:00 (BRT)") e passe o startAt EXATAMENTE como veio para create-meeting (com o mesmo boardId). Se vier erro de agenda (quadro sem agenda, Google desconectado ou expirado), repasse a um humano e não invente horários.
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
workspaceId | sim | ID do workspace (obrigatório) |
boardId | não | ID do quadro (usa a agenda do quadro). Informe boardId OU calendarId. |
calendarId | não | ID da agenda. Informe boardId OU calendarId. |
from | não | A partir de quando buscar, em ISO 8601 (padrão: agora) |
days | não | Quantos dias à frente olhar (1 a 60, padrão 14) |
durationMinutes | não | Duração desejada em minutos (10 a 480; padrão: a duração do horário da agenda) |
limit | não | — |
get-meeting-transcript
Lê o resumo ou a transcrição do Tactiq vinculada a uma reunião da Agenda (as reuniões com "com transcrição" em list-meetings). part: "summary" (padrão) traz o resumo; part: "transcript" traz a transcrição em trechos (offset/limit em caracteres, padrão 40.000). Só leitura; exige token de acesso MCP (xmcp_).
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
meetingId | sim | ID da reunião |
part | não | "summary" (padrão) ou "transcript" |
offset | não | Só em "transcript": caractere inicial (padrão 0) |
limit | não | Só em "transcript": caracteres por trecho (1.000–100.000, padrão 40.000) |
list-meetings
Lista as reuniões agendadas num período. Com boardId (ou calendarId), lista as reuniões da agenda do quadro com ID, horário (Brasília), thread, contato, link do Meet e status (e "com transcrição" quando há transcrição do Tactiq, lida com get-meeting-transcript) — use para achar o ID antes de remarcar/cancelar. Sem eles, lista a agenda antiga do workspace. Para saber horários LIVRES, use get-meeting-availability.
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
workspaceId | sim | ID do workspace |
boardId | não | ID do quadro: lista as reuniões da agenda do quadro |
calendarId | não | ID da agenda (alternativa a boardId; não envie os dois) |
from | não | Início do período em ISO 8601 (padrão: 90 dias atrás; na agenda do quadro, 7 dias atrás) |
to | não | Fim do período em ISO 8601 (padrão: 180 dias à frente; na agenda do quadro, 60 dias à frente) |
includeCanceled | não | Incluir reuniões canceladas (só na agenda do quadro; padrão false) |
Transcrição do Tactiq na reunião
Passo a passo para conectar o Tactiq e trazer o resumo e a transcrição de uma reunião gravada para a Agenda da XBASE.
Visão geral
Como funcionam as automações da XBASE: os gatilhos que existem, as etapas do editor, os modelos, o teste, como ligar e o histórico de execuções.