Guida · Circa 5 minuti

Come collegare Onplana a Claude Desktop

Cinque passaggi. Genera un token, incolla lo snippet di configurazione, riavvia Claude Desktop e verifica con una chiamata a uno strumento. Circa 5 minuti in tutto.

Dopo potrai chiedere a Claude 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 Claude fa il lavoro direttamente in Onplana.

Apri Onplana → Impostazioni → Agenti Scarica Claude Desktop

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 Claude Desktop (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 di Claude Desktop

    In Claude Desktop, fai clic su Settings → Developer → Edit Config. Si apre claude_desktop_config.json nel tuo editor predefinito. Su macOS si trova in ~/Library/Application Support/Claude/claude_desktop_config.json; su Windows, in %APPDATA%\Claude\claude_desktop_config.json. Se il file è vuoto o non esiste, crealo con `{}`.

  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 copiato al passaggio 1. Salva il file.

  4. 4

    Riavvia Claude Desktop

    Chiudi completamente Claude Desktop (Comando+Q su macOS, chiusura completa su Windows) e riaprilo. Lo strumento di Onplana dovrebbe comparire nel selettore degli strumenti.

  5. 5

    Verifica la connessione

    In una nuova conversazione, chiedi: «elenca i miei progetti Onplana». Claude chiama lo strumento list_projects di Onplana e ti mostra il risultato. Se vedi un errore, controlla il token e verifica che il file di configurazione sia JSON valido.

claude_desktop_config.json

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

Come verificare che funzioni

Apri una nuova conversazione in Claude Desktop 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.»

Claude ti mostra la chiamata allo strumento nella conversazione 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.

C'è OAuth come alternativa al token?

Sì. Onplana è presente nella directory Connectors di Claude: in Claude Desktop (o su claude.ai) apri Settings, cerca Connectors, sfoglia la directory, scegli Onplana e approva l'accesso nel browser, senza incollare nulla. Sotto c'è OAuth 2.1 con PKCE, e Onplana pubblica i metadati di discovery secondo RFC 9728 e RFC 8414 su https://mcp.onplana.com/.well-known/oauth-protected-resource e oauth-authorization-server. Il percorso con il token incollato descritto qui è per quando vuoi il file di configurazione; OAuth è per chi preferisce non gestire token di lunga durata.

A quali strumenti ha accesso Claude?

351 strumenti: lettura (ad es. list_projects, get_project, list_tasks, list_my_tasks, list_overdue, list_risks, search_org_knowledge, summarize_project, analyze_project_risks, generate_status_report), scrittura (ad es. create_project, create_task, update_task, assign_task, create_milestone, create_comment, bulk_update_tasks, create_sprint_with_tasks, submit_timesheet, link_dependency, move_task_to_sprint) e tutte 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.

Claude 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.

Posso usare Claude Code (CLI) al posto di Claude Desktop?

Sì. Claude Code ha il supporto MCP integrato. Installazione in una riga: `claude mcp add onplana --transport http https://mcp.onplana.com/mcp`. Claude Code avvia OAuth alla prima chiamata a uno strumento (nessun token da incollare), apre un browser per accedere a Onplana e completa il consenso; da lì, qualsiasi sessione di `claude` in quel progetto vede il catalogo degli strumenti di Onplana. Per usare un token invece di OAuth, aggiungi `--header "Authorization: Bearer pat_…"` al comando. Verifica con `claude mcp list`. Funziona su macOS, Linux e WSL su Windows.

Dove posso revocare la connessione?

In Onplana, Impostazioni → Agenti → Connessioni mostra ogni connessione, sia i token di accesso personale sia gli accessi dal browser: scegli Revoca sulla riga. Ha effetto immediato; la chiamata successiva di Claude a uno strumento restituisce 401 e Claude ti chiede di ricollegarti.

E se il mio token trapela?

Revocalo subito (vedi sopra) e generane uno nuovo dallo stesso pannello. Il token compromesso smette di funzionare alla chiamata successiva. Dal piano Enterprise, un proprietario o amministratore dell'organizzazione vede ogni chiamata fatta dal token trapelato nella pagina Audit Logs, in Agent Activity, per controllare cosa ha potuto vedere o modificare l'attaccante.

Funziona su Linux?

Claude Desktop per ora esiste solo per macOS e Windows. Su Linux, usa un altro client MCP come l'MCP Inspector ufficiale (npx @modelcontextprotocol/inspector) o Cursor (compatibile con Linux), oppure integra la connessione di Onplana in uno script di agente locale con l'SDK client tipizzato in TypeScript di Onplana.

Correlati