Guida · Circa 5 minuti

Come collegare Onplana a Cursor

Cinque passaggi. Genera un token, incolla lo snippet mcpServers, ricarica Cursor e verifica con una chiamata a uno strumento. Circa 5 minuti.

Dopo potrai chiedere all'Agent di Cursor cose come «crea un piano di progetto per il lancio del Q3 con milestone settimanali» o «riassumi i rischi di questa settimana in tutti i progetti attivi», e Cursor fa il lavoro direttamente in Onplana senza uscire dall'editor.

Apri Onplana → Impostazioni → Agenti Documentazione MCP di Cursor

I cinque passaggi

  1. 1

    Genera un token di connessione di Onplana

    Accedi a Onplana su app.onplana.com. Vai su Impostazioni → Agenti → Connetti agente, scegli il riquadro Cursor (o Custom MCP client), poi Token di accesso personale e infine Genera token e mostra lo snippet di connessione. Copia il token di accesso personale (inizia con pat_). Il token ha solo l'ambito MCP_AGENT: può chiamare strumenti MCP, ma non creare altri token, cambiare la fatturazione né toccare nulla al di fuori della superficie MCP.

  2. 2

    Apri la configurazione MCP di Cursor

    In Cursor, apri Settings (Comando+Maiusc+J su macOS, Ctrl+Maiusc+J su Windows o Linux), vai su Tools & MCP e scegli New MCP Server. Cursor legge anche direttamente una configurazione JSON: per il progetto in .cursor/mcp.json nella radice del repository, o globale in ~/.cursor/mcp.json. Modificare il JSON dà lo stesso risultato dell'interfaccia.

  3. 3

    Incolla la configurazione del server MCP di Onplana

    Aggiungi una voce "onplana" sotto la chiave "mcpServers". La configurazione completa: {"mcpServers": {"onplana": {"url": "https://mcp.onplana.com/mcp", "headers": {"Authorization": "Bearer pat_paste-your-token-here"}}}}. Sostituisci pat_paste-your-token-here con il token del passaggio 1. Salva il file.

  4. 4

    Ricarica Cursor

    Ricarica la finestra di Cursor (Comando+Maiusc+P o Ctrl+Maiusc+P, poi "Reload Window"), oppure disattiva e riattiva il server onplana in Settings, poi Tools & MCP. Gli strumenti di Onplana compaiono nell'elenco degli strumenti dell'Agent con un punto di stato verde appena l'handshake funziona.

  5. 5

    Verifica la connessione

    Nella chat dell'Agent di Cursor, chiedi: «elenca i miei progetti Onplana». Cursor chiama lo strumento list_projects di Onplana e mostra il risultato. Se vedi un errore, controlla il token e verifica che il file di configurazione sia JSON valido.

.cursor/mcp.json (progetto) o ~/.cursor/mcp.json (globale)

{
  "mcpServers": {
    "onplana": {
      "url": "https://mcp.onplana.com/mcp",
      "headers": {
        "Authorization": "Bearer pat_paste-your-token-here"
      }
    }
  }
}

Come verificare che funzioni

Apri la chat dell'Agent di Cursor e prova una di queste:

  • «Elenca i miei progetti Onplana.»
  • «Cosa è in ritardo nel mio account Onplana?»
  • «Crea un'attività Onplana nel progetto X chiamata ‘Migrare Postgres su Aurora’.»
  • «Genera un report di stato del progetto Y.»

Cursor mostra la chiamata allo strumento prima di eseguirla, così puoi controllare quali dati vengono letti o scritti. Le modifiche vengono applicate in tutti i piani; in Free alcune azioni di scrittura hanno un limite mensile (nessuno dal piano Professional in su), e l'agente può chiedere un'anteprima che non conferma nulla tramite la sua opzione dryRun.

Domande frequenti

Quale piano di Onplana include MCP?

MCP è disponibile in tutti i piani, incluso quello gratuito. Il numero di connessioni simultanee di agenti cresce con il piano (Free 2, Professional 3, Business 5, Enterprise 10, Enterprise+ illimitate), e il tuo saldo di token IA (un'assegnazione mensile nei piani a pagamento, un bonus una tantum in Free, più il credito che acquisti) è ciò che limita l'uso reale dell'IA. Puoi cambiare piano quando vuoi su app.onplana.com/billing.

Il supporto MCP di Cursor è stabile?

Sì, MCP è una funzione già rilasciata in Cursor e non una funzione sperimentale. La connessione di Onplana è associata al provider CURSOR e riceve tutti gli strumenti di lettura, creazione e aggiornamento. Detto questo, le impostazioni di Cursor possono spostarsi tra una versione e l'altra; se succede, controlla la posizione attuale su docs.cursor.com e mantieni la stessa voce del server onplana.

Configurazione del progetto o globale?

Entrambe vanno bene. .cursor/mcp.json nella radice di un repository limita la connessione a quel progetto (utile quando repository diversi corrispondono a organizzazioni Onplana diverse con token separati). ~/.cursor/mcp.json applica la connessione a tutte le finestre di Cursor. Se entrambe definiscono un server "onplana", vince quella del progetto.

A quali strumenti ha accesso Cursor?

Allo stesso catalogo di 351 strumenti che vede qualsiasi client MCP: lettura (list_projects, get_project, list_tasks, list_my_tasks, list_overdue, list_risks, search_org_knowledge, summarize_project, generate_status_report), scrittura (create_project, create_task, update_task, assign_task, create_milestone, create_comment, bulk_update_tasks, create_sprint_with_tasks, link_dependency) e le aree di governance, controllo delle modifiche, conformità, documenti e flussi di lavoro. Il piano abilita alcuni strumenti; il catalogo completo è su onplana.com/mcp.

Cursor può eliminare progetti o attività tramite MCP?

Sì, in modo recuperabile, a meno che un amministratore non l'abbia disattivato. Gli strumenti di eliminazione tramite MCP sono: eliminare un'attività, un progetto, un elenco o un documento. Ognuno è un interruttore per area di lavoro che resta attivo finché un amministratore non salva una scelta, e chi chiama ha comunque bisogno del permesso che gli servirebbe in ogni caso. Tutti eliminano in modo reversibile nel cestino, e un'attività o un progetto eliminato viene conservato con tutto il suo sottoalbero e ripristinato con gli identificativi originali, quindi dipendenze e gerarchia restano intatte. Sprint, milestone, epic e obiettivi non hanno alcuno strumento di eliminazione tramite MCP.

C'è OAuth invece di incollare un token?

Onplana pubblica i metadati di discovery di OAuth 2.1 (RFC 9728 e RFC 8414) su mcp.onplana.com/.well-known/. Che Cursor li usi automaticamente dipende dal supporto all'autenticazione MCP della tua versione di Cursor; il percorso con il token nell'intestazione descritto qui funziona in tutte le versioni compatibili con i server MCP remoti.

Dove revoco la connessione?

In Onplana, in Impostazioni, poi Agenti, poi Connessioni, e Revoca sulla riga del token. Ha effetto immediato; la chiamata successiva di Cursor a uno strumento restituisce 401. Dal piano Enterprise, un proprietario o amministratore dell'organizzazione vede ogni chiamata fatta dal token nella pagina Audit Logs, in Agent Activity.

Correlati