A camada de recuperação da IA
além das fronteiras de cada sistema
O que a IA viu em qualquer decisão chega pela camada de conectores. Microsoft Graph, SharePoint, o servidor MCP, o sidecar de cronogramas, o e-mail de entrada, os webhooks de saída, o gerenciador de integrações OAuth. Isolado por organização, e toda chamada de ferramenta da IA fica registrada com a entrada, o resultado e a pessoa por trás.
A camada de recuperação por trás das decisões da IA
O modelo de decisão de três zonas do Onplana (veja o artigo completo (em inglês)) aplica na zona de ação e propõe na zona de sugestão. Em cada decisão, a IA raciocina sobre um contexto, e a maior parte desse contexto não está no banco de dados do próprio Onplana. Os conectores são o caminho por onde ele chega.
Toda chamada de ferramenta da IA, a partir do assistente do aplicativo ou de um agente conectado, fica registrada com a ferramenta, a entrada, o resultado, a pessoa e o horário. Proprietários e administradores da organização leem esses registros a partir do plano Enterprise na página Audit Logs, em Agent Activity. O prompt completo e o contexto que o modelo recuperou não são guardados, então o registro mostra o que a IA fez, não tudo o que ela leu.
Todo conector segue a mesma postura: OAuth onde o sistema de origem exige (Microsoft Graph, SharePoint, nuvens de arquivos de terceiros), PAT para clientes programáticos (MCP, API REST, webhooks), isolamento por organização desde a criação, de modo que um token da organização A não lê nem grava na B, e toda chamada de ferramenta da IA por ele registrada.
Sete conectores disponíveis hoje
Direção, autenticação, plano e o que cada um faz. A lista de integrações cresce com a demanda dos clientes; fornecedores com grande sobreposição vêm primeiro.
Servidor MCP
O catálogo de ferramentas do Onplana exposto pelo Model Context Protocol. Claude Desktop, Cursor, Goose, Continue e qualquer outro cliente compatível com MCP pode se conectar e usar 346 ferramentas tipadas (ler projetos, criar tarefas, lançar horas, consultar riscos, rodar revisões de governança). As mesmas restrições e o mesmo registro do chat do aplicativo.
Autenticação: OAuth 2.1 com Dynamic Client Registration (RFC 7591) ou Personal Access Token
Microsoft Graph (M365)
OAuth por usuário para o Microsoft Graph com e-mail (Mail.ReadWrite), calendário (Calendars.ReadWrite), publicações em canais do Teams (ChannelMessage.Send), arquivos (Files.ReadWrite) e pessoas (User.Read). Os recursos de IA usam isso para resumir uma conversa, agendar uma reunião com as partes interessadas, publicar atualizações de status em canais do Teams e anexar documentos do SharePoint a tarefas.
Autenticação: OAuth por usuário, tokens renovados via lib/oauthTokens.ts, invalid_grant marca revokedAt
Sites do SharePoint + bibliotecas de documentos
Navegue pelos sites do SharePoint a que a pessoa tem acesso e anexe documentos do SharePoint a tarefas ou projetos sem copiá-los para o Onplana. Modo vinculado (o arquivo fica no SharePoint e o Onplana guarda o link). A integração também mostra os metadados do documento no espaço de trabalho do projeto.
Autenticação: Herda o escopo OAuth do usuário no Microsoft Graph
Webhook de e-mail de entrada (caixa do projeto)
Cada projeto recebe um endereço de e-mail de entrada. Encaminhe um e-mail para ele e ele vira uma tarefa nova, com o assunto como título e o corpo como descrição. Uma resposta ao e-mail de uma tarefa chega como comentário nessa tarefa, e uma palavra de status na primeira linha pode mudar a tarefa. Os anexos não são guardados. Os pedidos das partes interessadas não ficam parados nas caixas esperando triagem manual.
Autenticação: Webhook público em /api/inbound-email, ligado ao projeto pelo endereço de entrada
Sidecar de cronogramas (importação de .mpp / .xml / .xer)
Envie um arquivo do Microsoft Project (.mpp, .mpx, .xml MSPDI, .xer do Primavera) e o sidecar baseado no MPXJ o transforma na árvore de tarefas do Onplana: tarefas, dependências (FS/SS/FF/SF + defasagem), ExtendedAttributes como campos personalizados, linha de base + custo planejado (do MSPDI). Depois, a detecção de riscos com IA roda sobre o cronograma importado.
Autenticação: Envio no aplicativo (multer, limite de 50 MB) ou a versão pública gratuita em /tools/schedule-health-check
Webhooks de saída
Eventos de projetos, tarefas, comentários, membros e migrações (project.created, task.status_changed, comment.created, migration.completed e outros). Cargas assinadas com HMAC-SHA256, novas tentativas com espera crescente, histórico de entregas por endpoint. Ligue o Onplana ao Zapier, ao n8n, ao seu próprio pipeline de ETL ou ao seu runbook de resposta a incidentes.
Autenticação: Segredo por webhook, cabeçalho da carga assinada (X-Webhook-Signature)
Gerenciador de integrações OAuth
A interface de administração da organização para conectar serviços de terceiros (Google Drive, Microsoft 365 com OneDrive e SharePoint, Box e Dropbox). O ciclo de vida dos tokens passa por lib/oauthTokens.ts: renovar quando vencem, revogar ao desconectar, marcar como mortos em invalid_grant. Desconectar é suave (a linha é mantida e os tokens são apagados), não uma exclusão definitiva.
Autenticação: Permissão da organização (org.integration.manage, ADMIN ou acima por padrão)
Microsoft Planner: mantenha o Planner e acrescente o portfólio
Business+As equipes continuam trabalhando no Planner. Vincule os planos delas a um portfólio do Onplana em um só passo, e cada plano vira um projeto mantido em dia por uma assinatura do Microsoft Graph: uma mudança no Planner faz o Onplana ler o plano de novo e recalcular o progresso e as datas do projeto.
- Um status para cada plano, a partir das datas e do percentual concluído do próprio Planner. Um plano sem datas aparece como não avaliado.
- Dependências entre tarefas de planos diferentes, escolhidas no portfólio e desenhadas na sua linha do tempo.
- Marcos atrasados, dependências em risco e problemas e riscos em aberto de todos os planos, cada linha com link para o item.
- Em Integrações aparecem os planos vinculados com a última sincronização, “Sincronizar agora” e “Desvincular”. O Planner é dono dos campos das tarefas; o Onplana não grava de volta.
Autenticação: a conexão Microsoft de quem vincula, com as permissões Tasks e Groups; cada notificação de mudança é conferida com um segredo guardado por assinatura.
Mantenha o Planner. Acrescente o portfólio.Autenticação + segurança
Três peças que valem do mesmo jeito em todos os conectores.
Credenciais no Key Vault
Os segredos de cliente do Onplana para terceiros (Microsoft, Google, hCaptcha, Stripe etc.) ficam no Azure Key Vault e a equipe de operações os renova à parte. Os tokens OAuth de cada usuário ficam criptografados em linhas OauthConnection.
Tokens isolados por organização
Todo PAT e todo token OAuth pertence a uma só organização desde a criação. As chamadas dos conectores não atravessam as fronteiras de uma organização porque o organizationId está preso à linha do token e nunca é lido de um cabeçalho da requisição.
Um registro em cada chamada da IA
Toda chamada de ferramenta da IA por um conector grava o seu registro: a ferramenta, a entrada, o resultado, a pessoa e o horário. Os webhooks de saída acrescentam uma linha WebhookDelivery com o corpo completo da requisição e da resposta + o tempo. O e-mail de entrada passa pelo histórico normal de tarefas e comentários.
O que os conectores não fazem
A lista honesta desta camada.
Enviar e-mail em seu nome
O e-mail do Outlook é só rascunho: uma IA escreve o rascunho na sua própria caixa e você revisa e envia. Uma publicação em canal do Teams não tem rascunho, então a ferramenta não publica sem uma confirmação explícita, e o agente do aplicativo não pode publicar. Os webhooks de saída disparam nos eventos que você assinou.
Atravessar as fronteiras de uma organização
Um PAT ou token OAuth criado na organização A não alcança os dados da B. Quem participa de várias organizações conecta cada uma separadamente. Isso é imposto no servidor, na linha do token, não no cabeçalho da requisição.
Driblar as restrições do plano
O acesso aos conectores segue o plano da organização: o servidor MCP, o e-mail de entrada e o e-mail, o calendário e o Teams pelo Microsoft Graph estão em todos os planos, inclusive o gratuito, os links de arquivos do SharePoint e do OneDrive a partir do plano Professional e os webhooks de saída a partir do plano Business. A restrição fica no servidor; um cliente MCP pode se autenticar, mas as chamadas que passam do plano retornam 402 com o caminho para o upgrade.
Executar sozinho trabalho de várias etapas entre sistemas
Os conectores expõem recursos; o chat do aplicativo e os agentes externos os usam uma chamada por vez. Fluxos de agentes em várias etapas, que planejam e executam ao longo de muitas chamadas, ficam na camada de agentes.
Perguntas frequentes
Como as credenciais dos conectores são guardadas?
Em duas camadas. Os segredos do próprio Onplana (chaves de API da Anthropic, endpoints do Azure OpenAI, segredos de cliente OAuth de terceiros, credenciais SMTP, hCaptcha, Stripe etc.) ficam no Azure Key Vault e a equipe de operações os renova à parte. Os tokens OAuth de cada usuário (os tokens de acesso e de renovação do Microsoft Graph) ficam em linhas OauthConnection marcadas com a organização, criptografados e renovados automaticamente quando vencem. Desconectar é uma revogação suave: a linha é mantida e os tokens são apagados.
Um conector pode atravessar as fronteiras entre locatários?
Não. Toda chamada de conector fica presa a uma só organização. As chamadas a partir do aplicativo passam pelo mesmo middleware withOrganization da API REST, então toda consulta leva o organizationId. Um PAT ou token OAuth pertence a uma organização desde a criação, então as chamadas de um agente conectado tiram a organização do token, nunca de um cabeçalho da requisição. Quem participa de várias organizações conecta cada uma separadamente.
O que há no registro de uma chamada de conector?
Toda chamada de ferramenta da IA por um conector fica registrada com a ferramenta, a entrada, o resultado, a pessoa e o horário, e é lida na página Audit Logs, em Agent Activity. Os webhooks de saída também gravam em WebhookDelivery, com o corpo completo da requisição e da resposta e o tempo. O e-mail de entrada grava pelo histórico normal de tarefas e comentários. Um revisor lê a trilha sem integração extra.
Qual a diferença entre o servidor MCP e a API REST?
Os mesmos recursos, outro protocolo. O servidor MCP fala Streamable HTTP (o padrão de transporte do MCP) e responde à chamada MCP tools/list com um catálogo de ferramentas tipadas, então os clientes de agentes compatíveis com MCP descobrem sozinhos as ações do Onplana. A API REST fala HTTP+JSON e está documentada em /api/openapi.json. Use MCP numa sessão do Claude Desktop ou do Cursor; use REST num script de backend. Os dois chamam os mesmos manipuladores, com as mesmas restrições e o mesmo registro.
Posso pedir um conector novo que venha com o Onplana?
Hoje a lista de conectores é a de cima. O gerenciador de integrações + a renovação OAuth são reaproveitáveis; o gargalo é a configuração OAuth de cada provedor + as definições de ferramentas. A equipe do Onplana recebe pedidos de integração em hi@onplana.com; fornecedores com grande sobreposição de clientes (por exemplo Atlassian, ServiceNow, Salesforce) têm prioridade.
Por que o sidecar de cronogramas está entre os conectores?
Porque ele vai PARA FORA do modelo de dados do Onplana para ler um formato de arquivo externo. O sidecar MPXJ em Java (um aplicativo de contêiner separado) lê .mpp / .xml / .xer, devolve a estrutura lida por HTTP e o pipeline de importação do Onplana a grava na árvore do projeto. É um conector para o mundo dos arquivos do Microsoft Project, assim como a integração com o SharePoint é um conector para o mundo das nuvens de documentos.
Continue pela área de IA
Os conectores são uma de três camadas. As outras duas tratam dos recursos de IA do produto e do trabalho de agentes em várias etapas.
Você está aqui: Conectores
A camada de recuperação da IA além das fronteiras de cada sistema.
Colaboração
Pessoas + agentes de IA em uma só equipe: atribua trabalho à IA, colabore nos comentários das tarefas, aprove os rascunhos.
Saiba maisIA nativa
A zona de ação: a IA aplica diretamente. Rascunho de plano, linguagem natural, rascunho de status, perguntas ao portfólio, recomendações.
Saiba maisAgentes
O modelo da zona de sugestão, propor e aprovar: alertas de risco, remanejamento de recursos, cronogramas sugeridos.
Saiba maisVeja os conectores na sua organização
Cadastre-se grátis, conecte o Microsoft Graph ou envie um arquivo .mpp em dois minutos e veja os recursos de IA começarem a puxar contexto das suas ferramentas.