Assistente de IA (MCP)

O CongPlan pode ser conectado a um assistente de IA através da interface MCP (Model Context Protocol). Isso permite fazer perguntas de planejamento em linguagem natural ou ditar registros em vez de navegar por menus. O assistente lê e grava os mesmos dados do aplicativo, então toda ação passa pelas mesmas verificações de permissão, verificações de conflito e registro de auditoria.

Padrão aberto

O MCP é um padrão aberto, então a conexão funciona com qualquer assistente compatível com MCP. O CongPlan expõe um endpoint MCP por congregação e usa OAuth 2.1 para autorização. Se o seu cliente suportar OAuth, basta conectar com a URL do endpoint e entrar pelo CongPlan — sem precisar de token. Um token de acesso pessoal só é necessário para clientes sem suporte a OAuth, ou quando você precisa de uma credencial estática de longa duração.

Antes de Começar

O acesso MCP vem desativado por padrão. Duas etapas são necessárias antes de você poder usá-lo:

1. Um administrador ativa a interface MCP para a congregação (nas configurações de administração).
2. Um administrador concede acesso a você para que possa conectar um assistente — seja via login OAuth ou criando um token pessoal. Se você ainda não tiver acesso, pode solicitá-lo na tela de MCP.

Conectando Seu Assistente

O endpoint MCP do CongPlan é https://my.congplan.app/api/mcp.

Claude.ai / Claude Desktop

1. Abra as configurações da sua conta Claude (rotuladas como Settings ou Customize, dependendo do seu plano) e encontre Connectors > Add custom connector.
2. Cole a URL do endpoint abaixo. O Claude abre um navegador para entrar pelo CongPlan e conclui a conexão OAuth automaticamente — sem precisar de token.

https://my.congplan.app/api/mcp

Claude Code CLI

# OAuth (recomendado): abre um navegador para entrar no CongPlan
claude mcp add --transport http congplan https://my.congplan.app/api/mcp

# Token de acesso pessoal (alternativa para uso não interativo/CI)
claude mcp add --transport http congplan https://my.congplan.app/api/mcp \
  --header "Authorization: Bearer cpm_your_token_here"

ChatGPT (conector personalizado)

1. No ChatGPT, abra Settings e encontre Connectors (a formulação exata do menu pode variar conforme o plano ou a versão do app); escolha adicionar ou criar um novo conector.
2. Cole a URL do endpoint e conclua o login OAuth. Nenhum token é necessário — os conectores do ChatGPT suportam OAuth diretamente.

mcp.json genérico (Cursor, Windsurf, etc.)

Clientes que leem sua lista de servidores MCP de um arquivo mcp.json suportam os dois tipos de conexão — use OAuth se o cliente suportar, ou um token bearer caso contrário:

{
  "mcpServers": {
    "congplan-oauth": {
      "url": "https://my.congplan.app/api/mcp"
    },
    "congplan-token": {
      "url": "https://my.congplan.app/api/mcp",
      "headers": {
        "Authorization": "Bearer cpm_your_token_here"
      }
    }
  }
}

Peça ao Seu Assistente para se Configurar

Muitos assistentes conseguem configurar a conexão sozinhos se você colar uma instrução curta:

Add the CongPlan MCP server at https://my.congplan.app/api/mcp using OAuth.
If OAuth isn't supported, ask me for a personal access token and use it as an
Authorization: Bearer header instead.

Tokens de Acesso Pessoal

Você só precisa de um token se o seu cliente não puder usar OAuth ou precisar de uma credencial de longa duração.

Assim que tiver acesso, crie um token pessoal nas configurações da sua conta:

1. Abra Eu > Integrações.
2. Escolha Criar token.
3. Dê um nome ao token, selecione os escopos que ele pode usar e escolha uma expiração (até 90 dias).
4. Copie o token imediatamente — ele é mostrado apenas uma vez e não pode ser recuperado depois.

Use um token no assistente compatível com MCP de sua escolha para conectá-lo à sua congregação.

Escopos

Os escopos controlam exatamente o que um token pode fazer. Eles são divididos em leitura e escrita por área, por exemplo:

• Leitura — perfil da congregação, publicadores, grupos de serviço de campo, reuniões, designações (incluindo os encargos técnicos), reuniões para o serviço de campo, tarefas, testemunho público, discursos públicos externos e (dados sensíveis) ausências.
• Escrita — tarefas, reuniões para o serviço de campo, designações, reuniões, testemunho público e suas próprias solicitações de repasse ou inscrições.

Conceda apenas os escopos de que você realmente precisa. Um token pode ser revogado a qualquer momento.

Solicitações Baseadas em Nome

Quando você pede ao assistente para agir sobre publicadores nomeados, por exemplo «registre uma ausência para Linda e Tim», ele precisa primeiro resolver esses nomes para os IDs internos de publicador do CongPlan. Conceda o escopo Publicadores (leitura) junto com o escopo de escrita correspondente, como Ausências (escrita), para que o assistente consiga localizar as pessoas que deve atualizar.

Se o escopo de leitura de publicadores estiver ausente, o assistente não pode encontrar a pessoa certa com segurança. Ele deve pedir para você adicionar esse escopo ou fornecer os IDs exatos. Se um nome estiver ausente ou corresponder a mais de um publicador, ele deve pedir esclarecimento em vez de adivinhar.

Exemplos de Solicitações

O que você diz depende do assistente, mas solicitações típicas são assim:

• «Quem está designado na reunião do meio de semana da próxima semana?»
• «Quais partes ainda estão sem designação para a reunião de fim de semana de 14 de julho?»
• «Quais reuniões estão programadas para a próxima semana?»
• «Coloque o irmão Miller como orador do discurso público de 14 de julho.»
• «Crie uma tarefa: verificar os microfones para a reunião de fim de semana de sábado.»
• «Mostre todas as reuniões para o serviço de campo desta semana com dirigente e ponto de encontro.»
• «Quem está com o microfone ou o serviço de áudio/vídeo neste fim de semana?»
• «Quais dos nossos oradores têm um discurso público externo agendado para o mês que vem?»
• «Crie a reunião de fim de semana de 16 de agosto.»

O assistente propõe a ação; ela é salva pelos mesmos caminhos que um registro manual, incluindo verificações de elegibilidade e de conflito. Quando você pede para ele criar uma nova reunião, o CongPlan aplica automaticamente o modelo de programa correspondente — o mesmo que seria usado ao criá-la manualmente —, de modo que a reunião não começa vazia. Se nenhum modelo corresponder (ou você pedir explicitamente uma reunião vazia), ela é criada sem programa.

Anonimizado por Padrão

A interface MCP entrega ao seu assistente os IDs internos de publicador, não os nomes. O planejamento, as estatísticas e as verificações de elegibilidade funcionam todos com base nesses IDs. Quando o assistente analisa quem foi designado recentemente para equilibrar a carga, ele avalia esse histórico de forma anonimizada, sem saber quem são as pessoas.

Os nomes só são resolvidos bem no final, para a resposta mostrada a você, e apenas para as poucas pessoas que essa resposta realmente menciona. Essa busca é uma etapa separada que exige o escopo Publicadores (leitura), e ela retorna apenas os nomes de exibição para os IDs consultados, sem lista e sem mais detalhes. Sem esse escopo, o assistente continua trabalhando com os IDs — só não consegue atribuir nomes a eles.

Permissões e Segurança

• O assistente só pode fazer o que sua função e seus escopos de OAuth ou token permitem — aplicam-se as mesmas regras de isolamento por congregação e de permissão do aplicativo.
• Toda ação é registrada no log de auditoria.
• Tokens são pessoais. Trate um token como uma senha e revogue-o se não for mais necessário.

Relacionados

• Permissões
• Tarefas