Agentes de IA & MCP

O seu agente de programação ou assistente de IA pode trabalhar a sua caixa de entrada do Campbooks da mesma forma que você — fazendo o triage de emails, revendo documentos, confirmando lembretes, a redigir respostas para a sua aprovação, e muito mais. Faz isso através do MCP (Model Context Protocol), exposto em /api/mcp em qualquer instância do Campbooks.

O que permite

Ligue um agente compatível com MCP — Claude Code, Cursor, Windsurf, OpenAI Codex CLI ou qualquer outro cliente — e ele ganha acesso à sua caixa de entrada em linguagem natural:

• Triage e skim — leia o baralho de skim, aplique decisões de arquivar/manter cluster a cluster, e identifique threads onde falta uma resposta sua.
• Documentos — reveja faturas e recibos pendentes, aprove ou rejeite, atualize campos extraídos e arquive documentos em pastas.
• Tarefas e lembretes — confirme ou dispense tarefas e lembretes extraídos pela IA; crie tarefas a partir de emails.
• Eventos de calendário — liste eventos futuros, crie eventos a partir do contexto de emails, responda a convites (RSVP).
• Contactos — procure contactos, marque como favoritos os que importam, bloqueie remetentes indesejados.
• Redigir com confirmação — escreva uma resposta ou um novo email, mostre primeiro ao utilizador e envie apenas após um "sim" explícito.

Duas coisas mantêm isto seguro: os scopes da chave MCP limitam o que o agente pode fazer (conceda emails:send apenas se quiser que ele componha email), e as skills que distribuímos instruem o agente a mostrar-lhe cada rascunho e a nomear cada remetente antes de um envio, eliminação ou bloqueio. Se ligar um agente diferente, dê-lhe a mesma regra.

Como está construído

O servidor MCP em POST /api/mcp é uma camada fina de protocolo sobre a mesma REST API pública que alimenta o CLI e integrações de terceiros. Isso significa:

• Mesmos controlos de permissões — a chave MCP carrega os mesmos OAuth scopes de qualquer cliente de API. Um agente com emails:read pode ler email; não pode enviar a menos que também conceda emails:send. As permissões de caixa de correio do utilizador ainda se aplicam: uma conta que não pode usar para enviar na aplicação, o agente também não pode.
• Mesma regra 404-não-403 — recursos que pertencem a outra workspace devolvem 404, não 403, para que o agente nunca saiba se algo existe fora dos seus dados.
• Design de contexto mínimo — o servidor expõe dois tools que cada cliente autenticado obtém gratuitamente, independentemente do scope: get_overview (um snapshot barato do que precisa de atenção: contagem de não lidos, documentos pendentes, lembretes em atraso, eventos de hoje) e guide (guias narrativos para fluxos de trabalho comuns). Um agente deve chamar get_overview primeiro e ler um guia antes de avançar, mantendo o uso de tokens baixo.

Os tools aparecem em tools/list apenas para os scopes que uma chave tem. Uma chave apenas de triage vê cerca de 15 tools; uma chave completa vê todos os 72.

O que precisa

• Uma conta Campbooks — Campbooks Cloud ou uma instância auto-alojada.
• Uma chave MCP criada em Definições → Acesso à API. Ao contrário dos tokens OAuth de curta duração (expiram em 2 horas), uma chave MCP não expira — foi concebida para configurações estáticas de agentes.

Só isso. Não é necessário registo separado nem serviços adicionais a correr.

Próximos passos

• Plugin para Claude Code — instalação via marketplace, as duas skills (/campbooks:setup, /campbooks:triage) e um guia de uma sessão típica.
• Outros agentes — configurações de copiar e colar para Cursor, Windsurf, OpenAI Codex CLI e Gemini CLI.
• Referência MCP — catálogo completo de tools, formas de autorização, scopes, limites de taxa e garantias de segurança.