Guida · Circa 5 minuti

Come collegare Onplana a Windsurf

Cinque passaggi. Genera un token, incolla lo snippet mcpServers (Windsurf usa serverUrl), aggiorna Cascade e verifica con una chiamata a uno strumento. Circa 5 minuti.

Dopo potrai chiedere a Cascade 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 Windsurf fa il lavoro direttamente in Onplana senza uscire dall'editor.

Apri Onplana → Impostazioni → Agenti Documentazione MCP di Windsurf

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 Windsurf (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 Windsurf Cascade

    In Windsurf, apri il pannello Plugins (MCP) e scegli "View raw config". Si apre mcp_config.json. Su macOS e Linux si trova in ~/.codeium/windsurf/mcp_config.json; su Windows, nella cartella .codeium\windsurf del tuo profilo utente. Se il file è vuoto, inizialo con {}.

  3. 3

    Incolla la configurazione del server MCP di Onplana

    Aggiungi una voce "onplana" sotto la chiave "mcpServers". La configurazione completa: {"mcpServers": {"onplana": {"serverUrl": "https://mcp.onplana.com/mcp", "headers": {"Authorization": "Bearer pat_paste-your-token-here"}}}}. Windsurf usa la chiave "serverUrl" per i server HTTP remoti (non "url"). Sostituisci pat_paste-your-token-here con il token del passaggio 1 e salva.

  4. 4

    Aggiorna Cascade

    Nel pannello Plugins (MCP), fai clic su "Refresh" (la freccia circolare) perché Cascade rilegga la configurazione ed esegua l'handshake MCP. Il server onplana dovrebbe mostrare uno stato verde e un numero di strumenti disponibili. Cascade tiene attivi al massimo 100 strumenti MCP e Onplana ne espone 351, quindi se mancano strumenti di Onplana, disattiva altri server o strumenti che non ti servono.

  5. 5

    Verifica la connessione

    In Cascade, chiedi: «elenca i miei progetti Onplana». Windsurf chiama lo strumento list_projects di Onplana e mostra il risultato. Se vedi un errore, controlla il token, verifica che la chiave sia "serverUrl" (non "url") e che il JSON sia valido.

~/.codeium/windsurf/mcp_config.json

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

Come verificare che funzioni

Apri Cascade 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.»

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

Perché Windsurf usa "serverUrl" invece di "url"?

È lo schema di configurazione di Windsurf per i server MCP remoti via HTTP. Claude Desktop e Cursor usano "url"; Windsurf Cascade usa "serverUrl". Il resto della voce (il nome del server onplana e l'intestazione Authorization) è identico. Usare "url" per errore è il motivo più comune per cui una connessione di Windsurf non compare senza dare errori.

Il supporto MCP di Windsurf è stabile?

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

A quali strumenti ha accesso Windsurf?

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.

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

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 Windsurf 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