--- title: "Clavitor + Cursor" description: "Consenta alla modalità Agente di Cursor di accedere in modo sicuro alle credenziali e alle chiavi API — tramite il terminale integrato e il proxy HTTPS. Non è necessario MCP; gli agenti non enumerano mai la cassaforte." lang: it url: https://clavitor.ai/it/integrations/cursor markdown: https://clavitor.ai/it/integrations/cursor.md translation_of: https://clavitor.ai/en/integrations/cursor.md authoritative: false publisher: Clavitor LLC --- > This is the Italian translation of [clavitor + Cursor](https://clavitor.ai/en/integrations/cursor.md). The original English text is authoritative; where the two differ, the English version prevails. # Guida all'integrazione: Clavitor + Cursor La modalità Agente di Cursor esegue comandi shell e chiamate HTTP dall'interno dell'editor. Puntarlo alla CLI Clavitor per le credenziali nominate e al proxy Clavitor per l'autenticazione API trasparente — le chiavi non entrano mai nella memoria dell'editor o nella cronologia delle conversazioni. ### Cosa vede l'agente di Cursor **Campi condivisi** L'agente li legge tramite il terminale integrato per distribuire, autenticare ed effettuare chiamate API. - Chiavi API (Anthropic, OpenAI, GitHub, AWS, Stripe...) - Credenziali host SSH - Stringhe di connessione al database - Semi TOTP — codici 2FA live su richiesta - Password dell'account di servizio ### Cosa l'agente non vede mai **Campi personali** Crittografati lato client con la Sua impronta digitale, volto o chiave hardware. Il server memorizza il testo cifrato. Nessuna chiave, nessun accesso. - Numeri di carta di credito e CVV - Passaporti e documenti d'identità governativi - Codici di recupero e frasi di recupero - Numeri di previdenza sociale - Dettagli del conto bancario ## Nessun MCP. Il proxy e la CLI fanno il lavoro invece. Cursor supporta MCP per le chiamate agli strumenti — ma Clavitor non distribuisce deliberatamente un server MCP. MCP espone l'enumerazione (elenco, ricerca, navigazione) all'agente; la superficie dell'agente è **solo capacità, mai enumerazione**. La CLI recupera ciò per cui l'agente è stato nominato e nient'altro. Il proxy inserisce le credenziali nelle richieste in uscita senza che l'agente le veda affatto. Questa è una scelta architetturale, non un'integrazione mancante. I prossimi due pattern coprono tutto ciò di cui Cursor ha bisogno. ## Configurazione Avviare Cursor da un terminale in modo che erediti il Suo `HTTPS_PROXY` e `PATH`. Su macOS, le lanci GUI da Finder saltano i Suoi file rc della shell — usare `cursor .` da un terminale, o impostare il proxy tramite un LaunchAgent per la persistenza. #### 1. Creare un agente Aprire la Sua cassaforte → **Agenti** → **Crea**. Nominarlo "Cursor" e scegliere a quali voci può accedere. Copiare il token di configurazione. #### 2. Inizializzare la CLI ``` $ echo "$CLAVITOR_TOKEN" | clavitor-cli init ``` Il file delle regole dell'agente Cursor (`.cursorrules` o `.cursor/rules`) può istruire l'agente a usare la CLI quando necessita di un segreto. #### 3. Avviare Cursor con il proxy attivo ``` $ export HTTPS_PROXY=http://localhost:1983 $ cursor . ``` Ora sia i comandi del terminale integrato dell'agente sia qualsiasi chiamata HTTP effettuata dal runtime di Cursor passano attraverso il proxy. Gli header che contengono `clavitor://Entry/field` vengono risolti prima che la richiesta lasci la macchina. ## Pattern 1 — Ricerche nominate tramite il terminale integrato L'agente di Cursor può chiamare qualsiasi comando shell. Quando necessita di un valore specifico, esegue un'uscita shell: ``` # In a script Cursor's agent generated: key=$(clavitor-cli get "Anthropic API" --field key) curl -H "x-api-key: $key" https://api.anthropic.com/v1/messages -d '{...}' ``` La variabile vive per una singola istruzione. L'agente non vede la `key` tra l'assegnazione e l'uso — e la credenziale non appare mai nella cronologia della chat perché Cursor non ripete i valori espansi nella conversazione. Per file di configurazione multi-credenziali, usare `render`: ``` $ clavitor-cli render app.config.json | myapp --config - ``` ## Pattern 2 — Iniezione trasparente tramite il proxy Con `HTTPS_PROXY` impostato, l'agente scrive un riferimento, il proxy lo risolve sul filo. Il segreto non entra mai nella memoria dell'agente o nella conversazione: ``` # Cursor's agent runs this verbatim curl -H "Authorization: Bearer clavitor://OpenAI/key" \ https://api.openai.com/v1/models ``` L'agente vede `clavitor://OpenAI/key` nella propria cronologia dei comandi. La richiesta sul filo parte con il vero valore `sk-...` nell'header Authorization. I log scraper, i dump di crash e la cronologia di `cursor` sono puliti. Questo è il pattern corretto quando: - L'agente sta generando chiamate curl/HTTP ad hoc durante una sessione - Uno strumento invocato dall'agente effettua chiamate HTTPS proprie - Si desidera che i segreti escano completamente dalla finestra del contesto della conversazione ## Cursor CLI (modalità agente da uno script) Cursor 1.x distribuisce una CLI separata per esecuzioni di agenti headless. La stessa regola `HTTPS_PROXY` si applica — impostarla nella shell prima dell'invocazione: ``` $ export HTTPS_PROXY=http://localhost:1983 $ cursor-agent "deploy the latest tag to staging" --workspace ~/dev/myapp ``` Per lavori di lunga durata, la whitelist IP del token dell'agente blocca le letture delle credenziali all'host dove l'agente è in esecuzione. Eseguito altrove, la cassaforte rifiuta. ## Ogni accesso viene registrato Il log di audit registra quale agente ha avuto accesso a quale credenziale, quando e da dove. L'attività dell'agente Cursor è contrassegnata in modo distinto dall'attività umana. ``` # TIME ACTION ENTRY ACTOR 2026-03-08 10:23:14 read anthropic cli:cursor 2026-03-08 10:23:15 read openai proxy:cursor 2026-03-08 11:45:02 read github-deploy cli:cursor 2026-03-08 14:12:33 render - cli:cursor ``` ## Iniziare [Inizia gratis](https://clavitor.ai/it/checkout) [Vedi i piani](https://clavitor.ai/it/pricing)