Come collegare Claude, Cursor e altre app di IA con MCP

Updated 2026-10-15

Ogni workspace ha un server MCP. App di IA come Claude, Claude Code, Cursor, Codex e Gemini CLI si collegano con una chiave personale, poi leggono e aggiornano il tuo lavoro come te, con i tuoi permessi. Perché è utile lo spiega MCP in Worknano. Questa pagina è la configurazione.

Attivalo (admin)

1. Apri Organizzazione e clicca Settings. In MCP Server attiva Enable MCP Server. Resta spento finché un admin non lo attiva.
2. Apri Config, clicca Integrations e poi MCP Server. Ogni app (Claude, Cursor, Codex, Gemini) è un modello di connessione. Se spegni un modello, smettono di funzionare tutte le chiavi create da quel modello.
3. Scegli quali modelli di dati ogni modello di connessione può leggere, creare o aggiornare. L'eliminazione è disattivata di default.
4. In Permissions, MCP Permissions decide cosa possono fare le connessioni esterne in tutto il workspace. Vedi Permessi.
5. Di default possono collegarsi Founder e Head. Per far collegare altri ruoli, dai loro il permesso di creazione su MCP Connection in Permissions.

Collega la tua app

1. Apri My e clicca Integrations. Trova Worknano in other AI apps.
2. Clicca Connect accanto alla tua app. La riga mostra la Server URL e la tua chiave.
3. Copia la Server URL. È l'indirizzo del tuo workspace con /mcp alla fine, per esempio https://yourcompany.worknano.com/mcp.
4. Mostra e copia la chiave. Inizia con wnpat_. Solo tu puoi mostrarla, e ogni visualizzazione viene registrata.
5. Segui la guida nella riga della tua app. Ogni app chiede le stesse due cose: la Server URL e un header Authorization con valore Bearer seguito dalla tua chiave.

Claude Code, con un solo comando:

claude mcp add --transport http --scope user worknano https://yourcompany.worknano.com/mcp --header "Authorization: Bearer YOUR_KEY"

Cursor, in ~/.cursor/mcp.json:

{ "mcpServers": { "worknano": { "url": "https://yourcompany.worknano.com/mcp", "headers": { "Authorization": "Bearer YOUR_KEY" } } } }

Gemini CLI usa httpUrl invece di url. Codex richiede Streamable HTTP e lo stesso header. Nell'app Claude aggiungi un connettore personalizzato, scegli No sign in e aggiungi l'header. Un connettore aggiunto da un owner per tutto un team Claude invia la stessa chiave per tutti, con i permessi di quella chiave.

Cosa può fare l'app

• Leggere il workspace: modelli, campi, record, conteggi e raggruppamenti.
• Creare e aggiornare record nei modelli consentiti dalla tua connessione.
• Elencare, leggere e salvare file (HTML, testo e board).
• Proporre modifiche di config come bozze. Non cambia nulla finché un admin non approva la bozza in Worknano.

Ogni chiamata ha tre limiti: le impostazioni MCP del modello, i permessi della tua connessione e il tuo ruolo. Secrets, utenti, ruoli e integrazioni non sono mai esposti.

Chiavi, scadenza e scollegamento

1. Una chiave dura 90 giorni. Alla scadenza la riga mostra Not connected. Clicca Connect per una nuova chiave e incollala nella tua app.
2. Clicca Disconnect per eliminare la tua chiave. L'app perde subito l'accesso.

Worknano può anche usare altri server MCP nei suoi assistenti. È l'MCP Client, un interruttore separato accanto a Enable MCP Server. Chiamare Worknano dal tuo codice è spiegato nella documentazione per sviluppatori. Torna alla mappa dei docs.