Collega Onplana a Claude, Gemini, ChatGPT e Cursor
Pianifica i progetti e segui il lavoro dal tuo assistente IA.
Onplana offre un server MCP pubblico su https://mcp.onplana.com/mcp. 351 strumenti selezionati, ricerca ibrida con BM25 e vettori sui contenuti indicizzati della tua organizzazione, accesso con OAuth 2.1 o PAT, permessi in base al piano e registro di tutto dall'inizio alla fine.
Costruito sullo standard aperto MCP di Anthropic. Funziona con Claude Desktop, Gemini CLI, Gemini Code Assist, ChatGPT, ChatGPT Codex CLI, Cursor, GitHub Copilot e qualsiasi altro client MCP che parli Streamable HTTP.
Installa in Gemini CLI (un comando):
export ONPLANA_PAT=pat_...
gemini extensions install https://github.com/Onplana/onplana-mcp-serverFunziona anche con Gemini Code Assist (VS Code e JetBrains). Per gli altri client, vedi la configurazione più sotto.
Tre agenti portano avanti insieme un progetto
Entra un incarico, esce un sito web pubblicato. ChatGPT, Claude e l'IA di Onplana prendono ciascuno le proprie attività e lavorano su un piano condiviso, mentre tu mantieni il controllo con l'approvazione finale.
Nei Plugins di ChatGPT e nel Directory di Claude
Cerca onplana in Plugins dentro ChatGPT o nel Directory dentro Claude, aggiungilo e accedi una volta. Nessun URL di connettore da incollare, nessuna modalità sviluppatore.
Cos'è MCP
Il Model Context Protocol (MCP) è uno standard aperto, pubblicato da Anthropic alla fine del 2024, per collegare gli LLM a strumenti e fonti di dati esterni. Invece di costruire un'integrazione su misura per ogni client, un'applicazione pubblica una volta un server MCP e qualsiasi client compatibile con MCP (Claude Desktop, Cursor, i connettori personalizzati di ChatGPT, agenti interni con l'SDK di MCP) può chiamarlo. Un client elenca gli strumenti disponibili con tools/list e li chiama con tools/call; il protocollo si occupa di validare gli argomenti, delle risposte di errore e di presentare i risultati.
Per il software di gestione dei progetti, l'effetto pratico è che puoi chiedere a un agente «crea un piano di progetto per il lancio del terzo trimestre» e l'agente fa il lavoro direttamente in Onplana: crea il progetto, aggiunge le attività giuste, assegna i responsabili e pianifica le milestone, invece di consigliarti uno strumento e chiederti di farlo tu.
Cosa offre Onplana
Qui sotto sono evidenziati ventuno degli strumenti più usati in tre gruppi, un campione rappresentativo dei 351 del catalogo completo. I client vedono l'elenco completo con tools/list; gli strumenti a cui chi chiama non ha accesso (per il piano o per il permesso del suo ruolo) vengono filtrati prima che l'LLM li veda, così un agente non chiama mai alla cieca uno strumento bloccato.
I risultati letti si possono aprire: ogni progetto, attività, sprint, milestone e problema che un agente legge, e ogni fonte che cita da search_org_knowledge, porta un link fisso di Onplana che apre quello stesso record nell'app, così passi direttamente dalla risposta del tuo agente all'elemento di cui parla.
Lettura e ricerca
list_projectsFiltra per stato, responsabile ed etichetta.
get_projectTutti i dettagli, con attività, milestone e attività recente.
list_tasksPer progetto, responsabile e stato.
get_taskCon dipendenze e sottoattività.
list_org_membersPer trovare il responsabile per nome o email.
list_risksProdotti dal rilevamento automatico dei rischi.
find_similar_projectsRicerca per somiglianza vettoriale nelle descrizioni dei progetti.
summarize_projectRiepilogo dello stato scritto dall'IA, quando lo chiedi.
search_org_knowledgeRicerca ibrida (vettori e BM25) su progetti, attività, rischi, obiettivi, commenti e pagine. La differenza.
Modifiche a progetti e attività
create_projectLimitato dal piano; rispetta il permesso org.project.create.
update_projectStato, date, nome; viene controllato il proprietario.
create_taskObbligatori: progetto, titolo. Facoltativi: email del responsabile, data di scadenza, priorità.
update_taskSicuro rispetto ai tentativi ripetuti grazie a una chiave di idempotenza.
assign_taskModo comodo per riassegnare tramite email.
move_task_to_sprintSposta un'attività in uno sprint, o di nuovo nel backlog.
add_project_memberAggiunge con il ruolo di progetto richiesto.
create_milestoneCompare come un rombo nel Gantt.
create_commentSu un'attività o su un progetto.
Modifiche in blocco e agenti
bulk_update_tasksModificare molte attività in un'unica transazione.
create_sprint_with_tasksCreare uno sprint e riempirlo con le attività scelte.
analyze_project_risksEsegue il rilevamento dei rischi con l'IA su un progetto e aggiunge i risultati al suo registro dei rischi (dal piano Professional).
Il catalogo completo di 351 strumenti va ben oltre i tre gruppi qui sopra: governance, controllo delle modifiche, timesheet, documenti, pagine, portfolio e altro. Un agente collegato può eseguire 4 tipi di eliminazione, un'attività, un progetto, una tabella dell'area di lavoro o un documento, e ognuna finisce nel cestino, da cui si può ripristinare. Sono attive finché un amministratore dell'organizzazione non ne disattiva qualcuna; qualsiasi altra eliminazione resta fuori dalla portata degli agenti.
Come collegarsi
Il flusso con un clic nella pagina delle integrazioni dell'app genera il token e ti dà uno snippet di configurazione pronto da copiare nel tuo client. Come riferimento, la configurazione a livello di protocollo è qui sotto. Preferisci una guida passo passo? Leggi la guida passo passo per collegare Claude o Cursor nella documentazione.
1. Genera un token di connessione
In Onplana vai su /integrations → AI Agents, scegli il riquadro del fornitore e fai clic su Generate connection. Vedrai il token una sola volta, conservalo; Onplana tiene solo un hash bcrypt. Per revocarlo, torna allo stesso pannello o in Impostazioni → Sviluppatore.
2a. Claude Desktop
Apri Settings → Developer → Edit Config. Aggiungi una voce in mcpServers:
{
"mcpServers": {
"onplana": {
"url": "https://api.onplana.com/api/mcp/v1",
"headers": {
"Authorization": "Bearer pat_paste-your-token-here"
}
}
}
}Riavvia Claude Desktop. Chiedi a Claude «elenca i miei progetti Onplana» per controllare.
2b. Cursor
Aggiungilo a ~/.cursor/mcp.json con la stessa struttura JSON di Claude Desktop. Cursor applica le modifiche al successivo avvio; non serve riavviare l'editor.
2c. Claude Code CLI
Una riga. Claude Code avvia OAuth alla prima chiamata a uno strumento, senza incollare alcun PAT:
claude mcp add onplana --transport http https://mcp.onplana.com/mcp
Controlla con claude mcp list. Il flusso OAuth apre una scheda del browser la prima volta; accedi a Onplana, approva la schermata di consenso e hai finito. Per incollare un PAT invece di usare OAuth, aggiungi --header "Authorization: Bearer pat_…".
2d. Altri client MCP (e una prova rapida)
Funziona qualsiasi client MCP con Streamable HTTP. Prova rapida a livello di protocollo da un terminale:
curl -X POST https://api.onplana.com/api/mcp/v1 \
-H "Authorization: Bearer pat_paste-your-token-here" \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'Dovresti vedere la busta JSON-RPC con l'elenco completo degli strumenti. L' Inspector ufficiale di MCP è utile durante lo sviluppo per controllare le descrizioni degli strumenti e la forma dei risultati.
2e. Gemini Enterprise (accesso anticipato)
Un amministratore di Gemini Enterprise aggiunge Onplana in Google Cloud come server MCP personalizzato (Streamable HTTP, https://mcp.onplana.com/mcp). Il modulo di Google chiede un ID client OAuth e un segreto, che Onplana rilascia per la tua organizzazione su richiesta; non è ancora self-service e non è una scheda del marketplace di Google. Guida alla configurazione e le 20 azioni da attivare per prime.
Usi Gemini CLI o Gemini Code Assist? Quelli li configuri da solo: collega Gemini CLI in pochi minuti.
3. Facoltativo: reagire in pochi secondi, non alla prossima interrogazione
Un agente collegato raccoglie i tuoi commenti con i suoi tempi. Esegui il relay accanto a lui e Onplana lo sveglia appena qualcuno commenta il suo lavoro, lo menziona o gli chiede di eseguire un'attività. Apre la connessione verso l'esterno, così un portatile dietro il router di casa funziona senza URL pubblico, senza port forwarding e senza regole in entrata nel firewall.
ONPLANA_PAT=pat_… npx @onplana/agent-relay --provider claude-code
Davvero facoltativo: senza, il tuo agente vede comunque tutto, solo alla sincronizzazione successiva. Passa a --provider codex per Codex, oppure togli l'opzione per ottenere JSON riga per riga da passare a qualsiasi runner. Configurazione e casi d'uso del relay.
Provalo senza account
Onplana offre anche un server MCP pubblico in sola lettura per la propria documentazione. Aggiungilo con una riga, senza token, e lascia che il tuo agente risponda a «come faccio X in Onplana?» con gli stessi contenuti che leggono le persone.
claude mcp add onplana-docs https://mcp.onplana.com/docs
Offre due strumenti: search_docs e read_docs_page. Sola lettura, limitato per IP, non fornisce dati di alcuna organizzazione. Per agire dentro un'organizzazione Onplana (creare attività, eseguire flussi), usa il server autenticato qui sopra.
Il modello di sicurezza
Quattro livelli che si sovrappongono. Ognuno è il componente che Onplana aveva già, applicato a MCP, senza scorciatoie né eccezioni specifiche per MCP. Se un livello fallisce nella chat dell'app, fallisce allo stesso modo in MCP; se lì funziona, funziona anche in MCP.
Token di accesso personale
L'accesso avviene con un PAT Bearer limitato al solo nuovo ambito MCP_AGENT. I token sono salvati con hash bcrypt sul server, vengono mostrati una volta alla creazione e si possono revocare in /integrations o in Impostazioni → Sviluppatore.
Blocchi per piano e ruolo
Ogni chiamata a uno strumento passa per il dispatcher che Onplana aveva già. A un agente vengono offerti solo gli strumenti consentiti dal suo piano e dal suo ruolo, gli altri sono nascosti in tools/list. Ogni chiamata viene eseguita come te, controllata rispetto ai tuoi permessi e registrata nel registro di controllo, così un agente non arriva mai a niente a cui non potresti arrivare tu.
Registrato dall'inizio alla fine
Ogni chiamata a uno strumento scrive una riga AiOperation: lo strumento, input e output, la persona, la connessione dell'agente e l'esito. Proprietari e amministratori dell'organizzazione le leggono dal piano Enterprise nella pagina Audit Logs, in Agent Activity. Limite di 120 richieste al minuto da ogni indirizzo client; conta sul limite di spesa dell'organizzazione come la chat dell'app.
Contenimento della prompt injection
I campi di testo libero dei risultati che provengono da contenuti degli utenti vengono racchiusi nei tag <onplana_user_content>...</onplana_user_content> prima di arrivare all'LLM. I tag di chiusura dentro il contenuto vengono convertiti in escape, così il titolo ostile di un'attività non può uscire dalla barriera e iniettare istruzioni. Ogni descrizione di strumento dice all'LLM di trattare il contenuto racchiuso come dati, mai come istruzioni.
Prompt di esempio
Ecco come appare nella pratica. Ogni riga affianca il prompt che qualcuno scrive nel proprio client MCP alla sequenza di strumenti che Claude (o un altro agente) eseguirebbe sul server.
Utente: «Perché la fase di design del lancio del terzo trimestre dura tre settimane?»
Agente: Claude chiama search_org_knowledge con la query «motivo fase di design di tre settimane lancio terzo trimestre», riceve frammenti ordinati da descrizioni di attività e pagine e riassume quelli pertinenti con parole semplici, con i link agli elementi di origine.
Utente: «Crea un piano di progetto per il lancio del nostro prodotto nel terzo trimestre, con fasi di design, revisione e consegna, con scadenza a fine settembre.»
Agente: Claude chiama create_project con il nome e le date del piano e poi tre volte create_task per le fasi. Il progetto è pronto con qualsiasi piano, incluso Free.
Utente: «Trova tutte le attività bloccate dalla migrazione del database.»
Agente: Claude chiama search_org_knowledge con scope=tasks e la query «bloccata migrazione database», filtra i risultati per status=BLOCKED e restituisce una tabella riepilogativa con progetto, responsabile e data di scadenza.
Utente: «Abbiamo già fatto un progetto come questo?»
Agente: Claude chiama find_similar_projects con la descrizione del progetto attuale, riceve le 5 corrispondenze più vicine per somiglianza vettoriale e riassume cosa ha fatto di diverso ciascun progetto precedente.
Come si confronta
Onplana non è l'unico strumento di gestione dei progetti con un'interfaccia per agenti. Un confronto breve e onesto, così sai tra cosa stai scegliendo.
Notion (MCP)
Notion ha adottato MCP presto e beneficia di molti contenuti esistenti: basi di conoscenza, documenti, database. Forte se il tuo team lavora soprattutto in Notion. Più debole nei componenti propri della gestione dei progetti: niente Gantt con percorso critico, niente processo formale di governance, niente timesheet con costi, niente importazione di .mpp. Onplana copre meno (gestione dei progetti, non documenti), ma va più a fondo in quel campo.
Linear (API e MCP in arrivo)
Linear ha un'API GraphQL matura e una copertura MCP in crescita. Forte per i flussi con agenti dei team software (issue, cicli, progetti nel senso di Linear). Pubblico diverso: team di ingegneria, non PMO. Onplana offre una pianificazione di livello PMO (Gantt, dipendenze, livellamento delle risorse) che Linear non punta a offrire.
Asana / Monday / ClickUp
Tutti hanno API REST, e ciascuno pubblica già il proprio server MCP ospitato: il server V2 di Asana, quello di ClickUp in tutti i piani e il Platform MCP di monday.com, secondo la loro documentazione per sviluppatori letta il 3 novembre 2026. Lacune comuni rispetto a Onplana: niente funzioni formali di governance per PMO e niente importazione di file di Microsoft Project. Se il tuo collo di bottiglia è più «l'agente trova in fretta il contesto giusto» che «l'agente lancia chiamate CRUD», confronta la ricerca, non il numero di strumenti.
Microsoft Project
La linea unificata di gestione dei progetti di Microsoft (Planner Premium / Project per il Web) oggi non offre un server MCP; l'interfaccia di Microsoft Graph API è generica e poco dettagliata. Onplana importa i file .mpp in modo nativo e offre un server MCP, per i PMO che vogliono lavorare con gli agenti sui piani che hanno già.
Eseguire l'agente
Chi lo tiene in funzione, e cosa impedisce a due agenti di scontrarsi
Un catalogo di strumenti è metà della storia. L'altra metà è dove gira l'agente e cosa succede quando più di uno punta allo stesso backlog.
Il tuo computer
Claude Code, Cursor, ChatGPT, Copilot o il tuo client. Le aree di lavoro del piano Free hanno 2 connessioni di agenti simultanee.
Il relay che ospiti tu
Un pacchetto npm pubblicato che sveglia un runner locale non appena qualcuno commenta o menziona la persona dell'agente, invece di aspettare la successiva interrogazione. Non serve alcun servizio pubblico in ascolto.
Ospitato da Onplana
Manteniamo noi la connessione e distribuiamo il lavoro; l'esecuzione è delegata alla sandbox per agenti gestita di Claude, con una credenziale che fornisci tu e che puoi revocare.
Prenotazioni esclusive, in mano all'esecuzione
Una sola chiamata sceglie la prossima attività libera e la prenota nello stesso momento, perché elencare e poi prenotare lascia uno spazio in cui possono finire due agenti. La prenotazione appartiene all'esecuzione, non alla persona, e questo conta più di quanto sembri: due sessioni di Claude Code nella stessa area di lavoro si autenticano come la stessa persona agente, quindi un blocco per persona lascerebbe che una sessione liberi il lavoro dell'altra. Le prenotazioni scadono da sole, così un agente che si blocca libera la sua attività invece di lasciarla bloccata.
Domande frequenti
Cos'è il server MCP di Onplana?
Un server Model Context Protocol pubblico su api.onplana.com/api/mcp/v1. Offre 351 strumenti selezionati, per elencare, leggere, creare, modificare e cercare progetti, attività, sprint, milestone, commenti, rischi, obiettivi e pagine, a client con agenti compatibili con MCP come Claude Desktop, Cursor e i connettori personalizzati di ChatGPT. L'accesso avviene con un token di accesso personale Bearer con ambito MCP_AGENT.
In cosa si differenzia il server MCP di Onplana da quelli di altri strumenti di gestione dei progetti?
La maggior parte offre solo strumenti list_* e costringe l'LLM a scorrere a forza bruta grandi insiemi di risultati. Onplana offre uno strumento dedicato, search_org_knowledge, che esegue una ricerca ibrida (vettori e BM25) sui contenuti indicizzati dell'organizzazione: progetti, attività, rischi, obiettivi, commenti e pagine. Un agente può rispondere a «qual era il motivo di X?» in base al significato invece di scorrere tutto. Onplana collega inoltre ogni sessione MCP a una riga AiConversation persistente, così il modello conserva la memoria tra una riconnessione e l'altra.
Quali client possono collegarsi?
Qualsiasi client compatibile con il trasporto Streamable HTTP di MCP. Provato con Claude Desktop (connettore personalizzato configurato in Settings → Developer → Edit Config), Cursor (~/.cursor/mcp.json) e l'MCP Inspector ufficiale per il debug. ChatGPT e Claude includono Onplana nelle loro directory dei connettori, così puoi aggiungerlo da entrambi in pochi clic, senza incollare alcun URL di connettore. Gli agenti interni che usano gli SDK di MCP per TypeScript o Python funzionano allo stesso modo.
Come funziona l'autenticazione?
Il server MCP accetta token di accesso personale Bearer con ambito MCP_AGENT. Generane uno in /integrations → AI Agents (un clic; ricevi uno snippet di configurazione pronto da copiare) o in Impostazioni → Sviluppatore. I token sono salvati con hash bcrypt sul server, vengono mostrati una volta e si possono revocare. Il token porta con sé il contesto dell'organizzazione, così le richieste MCP non hanno bisogno di un'intestazione separata per l'organizzazione.
Come si tengono sotto controllo costi e abusi?
Tre livelli indipendenti. Un limite di frequenza (120 richieste al minuto da ogni indirizzo client) impedisce a un agente fuori controllo di saturare l'API. I limiti mensuali del dispatcher su alcuni strumenti impediscono l'abuso di un singolo strumento (solo in Free; nessuno dal piano Professional). Il limite di spesa in dollari dell'organizzazione (configurabile in Impostazioni → IA e utilizzo) controlla la spesa mensile totale; le richieste oltre il limite restituiscono 402, come nella chat dell'app. Una modalità WARN invia un'email agli amministratori al 80%, al 100% e al 103% del limite.
Limiti delle azioni degli agenti IA →Quali piani supportano MCP?
Tutti, incluso Free. Gli strumenti di lettura (elencare, leggere, cercare) funzionano con qualsiasi piano senza limite mensile. Anche gli strumenti che modificano i dati funzionano con qualsiasi piano e applicano le modifiche direttamente; in Free alcune azioni di scrittura hanno un limite mensile (nessuno dal piano Professional), e un modello può sempre chiedere prima un'anteprima con l'opzione dryRun di uno strumento. Gli strumenti limitati dal piano, come analyze_project_risks (rilevamento dei rischi con l'IA, dal piano Professional), sono nascosti nelle risposte di tools/list per i piani che non hanno la funzione, così l'LLM non li vede mai e non chiama alla cieca strumenti bloccati.
Come viene mitigata la prompt injection?
I campi di testo libero dei risultati che provengono da contenuti degli utenti (titoli delle attività, descrizioni, commenti, contenuto delle pagine) vengono racchiusi nei tag <onplana_user_content>...</onplana_user_content> prima di arrivare all'LLM. I tag di chiusura dentro quel contenuto vengono convertiti in escape (senza distinguere maiuscole e minuscole), così il titolo ostile di un'attività non può uscire e iniettare istruzioni. Ogni descrizione di strumento dice espressamente all'LLM di trattare il contenuto racchiuso come dati, mai come istruzioni da seguire. Lo schema segue le raccomandazioni pubblicate da Anthropic per difendersi dalla prompt injection.
Dove vedo cosa hanno fatto gli agenti IA nella mia organizzazione?
Nella pagina Audit Logs, in Agent Activity, per proprietari e amministratori dell'organizzazione, dal piano Enterprise. Ogni chiamata a uno strumento tramite MCP scrive una riga AiOperation con lo strumento, input e output, la persona, la connessione dell'agente e l'esito. Puoi filtrare per nome dello strumento, stato (APPLIED, FAILED, GATED, UNAUTHORIZED, CAP_EXCEEDED, UNDONE) e periodo, e copiare qualsiasi voce. Le righe del registro di controllo che registrano le modifiche di un agente indicano che sono arrivate tramite MCP, così si allineano con l'attività senza IA.
Il trasporto è open source?
Sì. I componenti del trasporto che non dipendono dalla piattaforma (il cablaggio di Streamable HTTP, l'autenticazione Bearer, il contenimento della prompt injection con i tag e l'escape dei tag di chiusura, un'interfaccia di dispatcher intercambiabile) sono pubblicati come pacchetti npm con licenza MIT su github.com/Onplana/onplana-mcp-server. Due pacchetti: onplana-mcp-server (un modello di server per la tua app Express) e onplana-mcp-client (un SDK tipizzato per chiamare l'endpoint pubblico di Onplana da agenti interni). L'implementazione del dispatcher e il catalogo degli strumenti restano nel repository chiuso di Onplana perché contengono la logica di business della piattaforma; il repository aperto ti dà i componenti di sicurezza senza importi un catalogo di strumenti.
Pronto a collegarti?
Il piano Free; senza carta di credito. Collega Claude Desktop o Cursor in meno di due minuti da /integrations → AI Agents. I token di connessione sono limitati, si possono revocare e vengono registrati dall'inizio alla fine.
Già collegato? Dai al tuo agente una competenza per pianificare e gestire i tuoi progetti (in inglese)