Lo strato di recupero dell'IA
oltre i confini di ogni sistema
Ciò che l'IA ha visto in qualsiasi decisione arriva attraverso lo strato dei connettori. Microsoft Graph, SharePoint, il server MCP, il sidecar delle pianificazioni, la posta in arrivo, i webhook in uscita, il gestore delle integrazioni OAuth. Isolato per organizzazione, e ogni chiamata dell'IA a uno strumento viene registrata con il suo input, il suo risultato e la persona che c'è dietro.
Lo strato di recupero dietro le decisioni dell'IA
Il modello decisionale a tre zone di Onplana (vedi l'articolo completo (in inglese)) applica nella zona di azione e propone nella zona di suggerimento. In ogni decisione, l'IA ragiona su un contesto, e la maggior parte di quel contesto non si trova nel database di Onplana. I connettori sono la via da cui arriva.
Ogni chiamata dell'IA a uno strumento, dall'assistente dell'app o da un agente collegato, viene registrata con lo strumento, il suo input, il suo risultato, la persona e l'ora. I proprietari e gli amministratori dell'organizzazione leggono questi registri dal piano Enterprise nella pagina Audit Logs, in Agent Activity. Non vengono salvati il prompt completo né il contesto recuperato dal modello, quindi il registro mostra cosa ha fatto l'IA, non tutto ciò che ha letto.
Tutti i connettori seguono la stessa impostazione: OAuth dove il sistema di origine lo richiede (Microsoft Graph, SharePoint, cloud di file di terze parti), PAT per i client programmatici (MCP, API REST, webhook), isolamento per organizzazione fin dalla creazione, così un token dell'organizzazione A non può leggere né scrivere nella B, e ogni chiamata dell'IA a uno strumento attraverso di essi viene registrata.
Sette connettori disponibili oggi
Direzione, autenticazione, piano e cosa fa ciascuno. L'elenco delle integrazioni cresce in base alla domanda dei clienti; i fornitori con molte sovrapposizioni vengono prima.
Server MCP
Il catalogo di strumenti di Onplana esposto con il Model Context Protocol. Claude Desktop, Cursor, Goose, Continue e qualsiasi altro client compatibile con MCP può collegarsi e usare 351 strumenti tipizzati (leggere progetti, creare attività, registrare ore, consultare rischi, eseguire revisioni di governance). Gli stessi vincoli e lo stesso registro della chat dell'app.
Autenticazione: OAuth 2.1 con Dynamic Client Registration (RFC 7591) o Personal Access Token
Microsoft Graph (M365)
OAuth per utente a Microsoft Graph per posta (Mail.ReadWrite), calendario (Calendars.ReadWrite), pubblicazioni nei canali di Teams (ChannelMessage.Send), file (Files.ReadWrite) e persone (User.Read). Le funzioni IA lo usano per riassumere una conversazione, pianificare una riunione con gli stakeholder, pubblicare aggiornamenti di stato nei canali di Teams e allegare documenti di SharePoint alle attività.
Autenticazione: OAuth per utente, i token si rinnovano con lib/oauthTokens.ts, invalid_grant imposta revokedAt
Siti di SharePoint + raccolte documenti
Esplora i siti di SharePoint a cui la persona ha accesso e allega documenti di SharePoint ad attività o progetti senza copiarli in Onplana. Modalità collegata (il file resta in SharePoint e Onplana conserva il link). L'integrazione mostra inoltre i metadati del documento nell'area di lavoro del progetto.
Autenticazione: Eredita l'ambito OAuth dell'utente in Microsoft Graph
Webhook della posta in arrivo (casella del progetto)
Ogni progetto ha un indirizzo email in arrivo. Inoltragli un'email e diventa una nuova attività, con l'oggetto come titolo e il corpo come descrizione. Una risposta all'email di un'attività arriva come commento su quell'attività, e una parola di stato nella prima riga può spostare l'attività. Gli allegati non vengono salvati. Le richieste degli stakeholder non restano nelle caselle di posta in attesa che qualcuno le smisti a mano.
Autenticazione: Webhook pubblico su /api/inbound-email, associato al progetto tramite l'indirizzo in arrivo
Sidecar delle pianificazioni (importazione .mpp / .xml / .xer)
Carica un file di Microsoft Project (.mpp, .mpx, .xml MSPDI, .xer di Primavera) e il sidecar basato su MPXJ lo trasforma nell'albero delle attività di Onplana: attività, dipendenze (FS/SS/FF/SF + ritardo), ExtendedAttributes come campi personalizzati, baseline + costo pianificato (da MSPDI). Poi il rilevamento dei rischi con l'IA viene eseguito sulla pianificazione importata.
Autenticazione: Caricamento nell'app (multer, limite di 50 MB) o la versione pubblica gratuita su /tools/schedule-health-check
Webhook in uscita
Eventi di progetti, attività, commenti, membri e migrazioni (project.created, task.status_changed, comment.created, migration.completed e altri). Payload firmati con HMAC-SHA256, nuovi tentativi con attesa progressiva e cronologia delle consegne per endpoint. Collega Onplana a Zapier, n8n, alla tua pipeline ETL o al tuo runbook di risposta agli incidenti.
Autenticazione: Segreto per webhook, intestazione del payload firmato (X-Webhook-Signature)
Gestore delle integrazioni OAuth
L'interfaccia di amministrazione dell'organizzazione per collegare servizi di terze parti (Google Drive, Microsoft 365 con OneDrive e SharePoint, Box e Dropbox). Il ciclo di vita dei token passa da lib/oauthTokens.ts: rinnovare quando scadono, revocare alla disconnessione, segnare come non validi in caso di invalid_grant. La disconnessione è leggera (la riga resta e i suoi token vengono svuotati), non un'eliminazione definitiva.
Autenticazione: Permesso dell'organizzazione (org.integration.manage, ADMIN o superiore per impostazione predefinita)
Microsoft Planner: tieni Planner e aggiungi il portfolio
Business+I team continuano a lavorare in Planner. Collega i loro piani a un portfolio di Onplana in un solo passaggio, e ogni piano diventa un progetto che una sottoscrizione di Microsoft Graph mantiene aggiornato: una modifica in Planner fa sì che Onplana rilegga il piano e ricalcoli avanzamento e date del progetto.
- Uno stato per ogni piano, a partire dalle date e dalla percentuale completata di Planner. Un piano senza date risulta come non valutato.
- Dipendenze tra attività di piani diversi, scelte dal portfolio e disegnate sulla sua sequenza temporale.
- Milestone in ritardo, dipendenze a rischio e problemi e rischi aperti di tutti i piani, ogni riga collegata al suo elemento.
- In Integrazioni compaiono i piani collegati con l'ultima sincronizzazione, «Sincronizza ora» e «Scollega». Planner è il proprietario dei campi delle attività; Onplana non riscrive su Planner.
Autenticazione: la connessione Microsoft di chi collega, con i permessi Tasks e Groups; ogni notifica di modifica viene verificata con un segreto conservato per sottoscrizione.
Tieni Planner. Aggiungi il portfolio.Autenticazione + sicurezza
Tre elementi che restano uguali in tutti i connettori.
Credenziali in Key Vault
I segreti client di Onplana per le terze parti (Microsoft, Google, hCaptcha, Stripe, ecc.) sono in Azure Key Vault e il team operativo li ruota separatamente. I token OAuth di ogni utente vengono conservati cifrati nelle righe OauthConnection.
Token isolati per organizzazione
Ogni PAT e ogni token OAuth appartiene a una sola organizzazione fin dalla creazione. Le chiamate dei connettori non possono superare i confini di un'organizzazione perché l'organizationId è legato alla riga del token e non viene mai letto da un'intestazione della richiesta.
Un registro per ogni chiamata dell'IA
Ogni chiamata dell'IA a uno strumento attraverso un connettore scrive il suo registro: lo strumento, il suo input, il suo risultato, la persona e l'ora. I webhook in uscita aggiungono una riga WebhookDelivery con il corpo completo della richiesta e della risposta + i tempi. La posta in arrivo passa dalla normale cronologia di attività e commenti.
Cosa non fanno i connettori
L'elenco onesto di questo strato.
Inviare email a tuo nome
La posta di Outlook è solo in bozza: un'IA scrive la bozza nella tua casella e tu la rivedi e la invii. Una pubblicazione in un canale di Teams non ha una bozza, quindi lo strumento non pubblica senza una conferma esplicita, e l'agente dell'app non può pubblicare. I webhook in uscita scattano con gli eventi a cui ti sei iscritto.
Superare i confini di un'organizzazione
Un PAT o un token OAuth creato nell'organizzazione A non arriva ai dati della B. Chi fa parte di più organizzazioni collega ciascuna separatamente. Il vincolo è applicato sul server, sulla riga del token, non sull'intestazione della richiesta.
Aggirare i vincoli del piano
L'accesso ai connettori segue il piano dell'organizzazione: il server MCP, la posta in arrivo e la posta, il calendario e Teams di Microsoft Graph sono disponibili in tutti i piani, incluso quello gratuito, i link ai file di SharePoint e OneDrive dal piano Professional e i webhook in uscita dal piano Business. Il vincolo è sul server; un client MCP può autenticarsi, ma le chiamate che superano il piano restituiscono 402 con il percorso per passare a un piano superiore.
Eseguire lavoro autonomo in più passaggi tra sistemi
I connettori espongono funzioni; la chat dell'app e gli agenti esterni le usano una chiamata alla volta. I flussi di agenti in più passaggi che pianificano ed eseguono lungo molte chiamate appartengono allo strato degli agenti.
Domande frequenti
Come vengono conservate le credenziali dei connettori?
Su due livelli. I segreti propri di Onplana (chiavi API di Anthropic, endpoint di Azure OpenAI, segreti client OAuth di terze parti, credenziali SMTP, hCaptcha, Stripe, ecc.) sono in Azure Key Vault e il team operativo li ruota separatamente. I token OAuth di ogni utente (i suoi token di accesso e di aggiornamento di Microsoft Graph) sono nelle righe OauthConnection contrassegnate con l'organizzazione, cifrati e rinnovati automaticamente quando scadono. La disconnessione è una revoca leggera: la riga resta e i suoi token vengono svuotati.
Un connettore può superare i confini tra tenant?
No. Ogni chiamata di un connettore è legata a una sola organizzazione. Le chiamate dall'app passano dallo stesso middleware withOrganization dell'API REST, quindi ogni query porta l'organizationId. Un PAT o un token OAuth appartiene a un'organizzazione fin dalla creazione, quindi le chiamate di un agente collegato prendono l'organizzazione dal token, mai da un'intestazione della richiesta. Chi fa parte di più organizzazioni collega ciascuna separatamente.
Cosa contiene il registro di una chiamata di un connettore?
Ogni chiamata dell'IA a uno strumento attraverso un connettore viene registrata con lo strumento, il suo input, il suo risultato, la persona e l'ora, e si legge nella pagina Audit Logs, in Agent Activity. I webhook in uscita scrivono inoltre in WebhookDelivery, con il corpo completo della richiesta e della risposta e i tempi. La posta in arrivo scrive attraverso la normale cronologia di attività e commenti. Un revisore legge il registro senza connessioni aggiuntive.
In cosa si differenzia il server MCP dall'API REST?
Le stesse funzioni, un altro protocollo. Il server MCP parla Streamable HTTP (lo standard di trasporto di MCP) e risponde alla chiamata MCP tools/list con un catalogo di strumenti tipizzati, così i client di agenti compatibili con MCP scoprono da soli le azioni di Onplana. L'API REST parla HTTP+JSON ed è documentata in /api/openapi.json. Usa MCP da una sessione di Claude Desktop o Cursor; usa REST da uno script di backend. Entrambi chiamano gli stessi handler, con gli stessi vincoli e lo stesso registro.
Posso chiedere un nuovo connettore da includere in Onplana?
Oggi l'elenco dei connettori è quello qui sopra. Il gestore delle integrazioni + il rinnovo OAuth sono riutilizzabili; il collo di bottiglia è la configurazione OAuth di ogni fornitore + le definizioni degli strumenti. Il team di Onplana riceve le richieste di integrazione a hi@onplana.com; i fornitori con molte sovrapposizioni di clienti (ad es. Atlassian, ServiceNow, Salesforce) hanno la precedenza.
Perché il sidecar delle pianificazioni è tra i connettori?
Perché esce FUORI dal modello dei dati di Onplana per leggere un formato di file esterno. Il sidecar MPXJ in Java (un'app container separata) legge .mpp / .xml / .xer, restituisce la struttura letta via HTTP e la pipeline di importazione di Onplana la scrive nell'albero del progetto. È un connettore verso il mondo dei file di Microsoft Project, così come l'integrazione con SharePoint è un connettore verso il mondo dei cloud di documenti.
Continua nell'area IA
I connettori sono uno di tre strati. Gli altri due riguardano le funzioni IA del prodotto e il lavoro degli agenti in più passaggi.
Sei qui: Connettori
Lo strato di recupero dell'IA oltre i confini di ogni sistema.
Collaborazione
Persone + agenti IA nello stesso team: assegna lavoro all'IA, collabora nei commenti delle attività, approva le bozze.
Leggi di piùIA nativa
La zona di azione: l'IA applica direttamente. Bozza del piano, linguaggio naturale, bozza dello stato, domande al portfolio, raccomandazioni.
Leggi di piùAgenti
Il modello della zona di suggerimento, proporre e approvare: avvisi di rischio, modifiche alle risorse, calendari suggeriti.
Leggi di piùGuarda i connettori nella tua organizzazione
Registrati gratis, collega Microsoft Graph o carica un file .mpp in due minuti e guarda le funzioni IA iniziare a portare contesto dai tuoi strumenti.