Traga seu próprio agente de IA (MCP)
Conecte seu próprio agente de IA — Claude, ChatGPT, Cursor e outros clientes compatíveis com MCP — diretamente à sua conta do CalendarBridge. Seu agente pode ler e gerenciar seus calendários, eventos, agendadores e sincronizações em seu nome, com as permissões que você controla.
Traga seu próprio agente usa o MCP (o Model Context Protocol) — um padrão aberto que permite que assistentes de IA se conectem a ferramentas externas. O CalendarBridge executa um servidor MCP hospedado, então qualquer cliente com suporte a MCP pode se conectar à sua conta e agir em seus calendários por você.
Isso é diferente do Assistente de Agendamento de IA do CalendarBridge, que faz agendamentos por e-mail. Com o Traga seu próprio agente, você traz a IA (aquela que você já usa e paga) e a aponta para o CalendarBridge.
Gerencie seus calendários com o servidor MCP do CalendarBridge
O servidor MCP do CalendarBridge transforma seu assistente de IA em um gerenciador de calendários. Depois de conectar um agente, você pode gerenciar seus calendários em linguagem natural — verificar sua agenda, criar e reagendar eventos, montar links de reserva e configurar sincronizações de calendário — no Google Calendar, no Microsoft 365 / Outlook e no iCloud, tudo por meio de um único endpoint do Model Context Protocol (MCP).
Em vez de clicar por um painel, você diz ao seu agente o que deseja e ele usa as ferramentas MCP do CalendarBridge para fazê-lo — gerenciamento de calendário com IA que funciona com o assistente que você já usa.
O que seu agente pode fazer
Uma vez conectado, seu agente pode:
- Calendários e eventos — listar seus calendários, ler eventos de qualquer intervalo de datas e criar, editar ou excluir eventos.
- Agendadores — listar, criar, editar e excluir seus agendadores.
- Sincronizações — listar, criar, editar e excluir sincronizações de calendário de mão única ou de mão dupla.
- Contas conectadas — listar suas contas de calendário conectadas e obter links para conectar, reautenticar ou remover uma conta.
- Assistente de IA — listar as configurações do seu Assistente de Agendamento de IA, revisar conversas recentes e enviar uma nova mensagem ou resposta por meio do seu assistente.
Cada ação que seu agente realiza é limitada às permissões que você concede ao conectar (consulte Escolher permissões).
Disponibilidade e planos
Conectar um agente está disponível em todos os planos, incluindo o Basic — não há token para comprar nem nada para copiar. Realizar ações por meio do seu agente (ler ou alterar calendários, criar sincronizações e assim por diante) requer uma assinatura ativa do CalendarBridge. Se sua assinatura expirar, seu agente permanece conectado, mas cada ação retorna uma mensagem pedindo que você a reative.
Etapa 1: abra a aba Traga seu próprio agente (MCP)
Faça login em https://app.calendarbridge.com/login/, abra Assistente de IA na barra lateral e selecione a aba Traga seu próprio agente (MCP).
Etapa 2: copie sua URL do servidor
A aba mostra sua URL do servidor do CalendarBridge. Ela se parece com:
https://manageapi.calendarbridge.com/mcpEssa única URL é tudo de que seu cliente precisa. Não há chave de API ou token para copiar — seu cliente faz seu login com um login seguro no navegador quando se conecta (consulte Escolher permissões).
Etapa 3: adicione o CalendarBridge ao seu cliente
Cada cliente adiciona um servidor MCP remoto de forma um pouco diferente. A aba inclui instruções passo a passo para o cliente que você escolher; os mais comuns estão abaixo. Use a URL do servidor da Etapa 2 sempre que uma URL for solicitada.
| Cliente | Como adicioná-lo |
|---|---|
| Claude.ai (web) | Configurações → Conectores → o + → Adicionar conector personalizado. Digite um nome e cole a URL do servidor, depois clique em Adicionar. |
| Claude Desktop | Configurações → Conectores → Adicionar conector personalizado. Digite um nome e cole a URL do servidor. |
| Claude Code | Execute claude mcp add calendarbridge --transport http <URL do servidor>, depois digite /mcp e autentique. |
| ChatGPT | Ative o Modo Desenvolvedor, depois vá em Configurações → Conectores, crie um novo conector e cole a URL do servidor. |
| Cursor | Configurações → Cursor Settings → Tools & MCP, adicione um novo servidor MCP com a URL do servidor, depois clique em Connect. |
| Codex CLI | Execute codex mcp add calendarbridge --url <URL do servidor>, depois digite /mcp e selecione calendarbridge. |
| Grok | Inicie um chat e clique no + → Add connector → Custom. Cole a URL do servidor e autorize. |
| Gemini CLI | Execute gemini mcp add --transport http calendarbridge <URL do servidor>, depois faça login quando o Gemini CLI detectar o servidor OAuth (ou execute gemini mcp auth calendarbridge). |
| Antigravity IDE | No painel do agente: ⋯ → MCP Servers → Manage MCP Servers → View raw config. Adicione uma entrada em mcpServers com "serverUrl" definido como a URL do servidor (o Antigravity usa serverUrl, não url), salve e atualize. |
| OpenClaw | Execute openclaw mcp add calendarbridge --url <URL do servidor> --transport streamable-http, depois openclaw mcp login calendarbridge e aprove o acesso no navegador. |
| Hermes | Execute hermes mcp add calendarbridge (ou adicione o servidor em mcp_servers em ~/.hermes/config.yaml com auth: oauth), depois hermes mcp login calendarbridge e aprove. |
| Qualquer outro cliente | Adicione um servidor MCP personalizado ou remoto (às vezes chamado de conector, integração ou servidor de ferramentas): cole a URL do servidor, escolha o transporte HTTP / streamable HTTP se solicitado e selecione OAuth / Fazer login para autenticação — não há chave de API, ID de cliente ou segredo para inserir. |
Seja como for que você o adicione, o fluxo é o mesmo — cole a URL do servidor, faça login no CalendarBridge no navegador e escolha o que permitir.
Etapa 4: faça login e escolha as permissões
Na primeira vez que seu cliente se conecta, ele abre uma página de login do CalendarBridge no seu navegador. Depois de fazer login, você verá uma tela de consentimento listando as permissões que o agente está solicitando. Marque apenas as que deseja conceder e clique em Permitir.
| Permissão | O que ela permite |
|---|---|
| Ler seus eventos de calendário | Listar seus calendários e ler eventos. |
| Criar e modificar eventos de calendário | Criar, editar e excluir eventos. |
| Ler / modificar seus agendadores | Listar, criar, editar e excluir agendadores. |
| Ler / modificar suas sincronizações de calendário | Listar, criar, editar e excluir sincronizações. |
| Ler suas contas conectadas | Listar contas e obter links de conectar / reautenticar / remover. |
| Ler seus assistentes | Listar configurações de assistente e conversas. |
| Enviar por meio dos seus assistentes | Enviar novas mensagens e respostas por meio do seu assistente de agendamento de IA. |
As permissões são aplicadas em cada requisição: um agente só pode usar as ferramentas que você permitiu. Você pode conectar mais de um agente e conceder a cada um um conjunto diferente de permissões.
Etapa 5: experimente
Uma vez conectado, peça ao seu agente coisas como:
- “O que está na minha agenda esta semana?”
- “Agende uma reunião de 1 hora chamada Revisão de design amanhã às 14h e convide alex@example.com.”
- “Mova minha reunião das 15h de hoje para as 16h.”
- “Crie um agendador de 30 minutos disponível nas tardes dos dias úteis e me dê o link.”
- “Configure uma sincronização de mão única do meu calendário de trabalho para o meu calendário pessoal, mostrando os eventos como ocupado.”
- “Liste minhas contas conectadas e me diga se alguma precisa de reautenticação.”
Trabalhando com seu Assistente de Agendamento de IA
Se você configurou o Assistente de Agendamento de IA do CalendarBridge, seu agente conectado pode operá-lo por você — seja iniciando um novo e-mail de agendamento ou respondendo dentro de uma conversa existente.
- Iniciar uma nova solicitação — por exemplo, “Peça ao meu assistente para encontrar um horário de 30 minutos com alex@example.com na próxima semana.” Seu agente envia o e-mail por meio do seu assistente, que assume a partir daí.
- Responder a uma conversa — por exemplo, “Responda à minha conversa mais recente do assistente e proponha quinta-feira às 10h.” Seu agente puxa a thread, infere os destinatários e o assunto e envia sua resposta.
O assistente funciona de forma assíncrona, assim como por e-mail: enviar uma mensagem a repassa, e a resposta do assistente chega um pouco depois. Peça ao seu agente para verificar suas conversas novamente para ver a resposta.
Isso requer um assistente configurado para uma das suas contas de e-mail conectadas e a permissão Enviar por meio dos seus assistentes. Se você conectou seu agente antes de essa permissão existir, reconecte-o e conceda a permissão na tela de consentimento.
Gerenciar agentes conectados
A seção Agentes conectados da aba lista todos os agentes que se conectaram, as permissões que receberam e quando foram usados pela última vez. Para desconectar um agente, clique em Revogar — ele perde o acesso imediatamente. Reconectar a partir do cliente solicitará login e permissões novamente.
Segurança e privacidade
- As conexões usam o fluxo de login padrão OAuth 2.1 com PKCE — não há chave de longa duração para copiar, vazar ou colar em um arquivo de configuração.
- Cada conexão é escopada às permissões que você concede e revogável a qualquer momento na lista de Agentes conectados.
- Seu agente age como você, apenas dentro dessas permissões. Ele não pode ver outras contas do CalendarBridge.
Solução de problemas
- “A assinatura não está ativa” — conectar é gratuito, mas realizar ações requer uma assinatura ativa. Reative em app.calendarbridge.com e tente novamente. Consulte Minha conta está paga, mas não está ativa.
- O agente não consegue encontrar um evento para editar — peça a ele para listar os eventos primeiro e depois agir sobre um deles a partir dessa lista.
- Uma conta de calendário precisa de reautenticação — seu agente pode retornar um link, ou consulte Reautorizar o acesso ao calendário.
- O cliente não se conecta — certifique-se de ter colado a URL do servidor completa exatamente como mostrada na aba, incluindo
https://.