Connetti Cursor e Codex

Cursor e Codex comunicano entrambi tramite MCP su HTTP. L'endpoint e le credenziali sono gli stessi utilizzati per Claude Code; a cambiare è solo il file di configurazione. Questa pagina mostra la struttura delle configurazioni e i controlli per verificare che la connessione funzioni correttamente.

1. Crea un token

In chat.ismscopilot.com, apri Impostazioni → Connected apps → Create token. Assegna gli ambiti necessari, copia una sola volta il valore pat-isms-… e assicurati che non finisca nei file sottoposti a commit.

Per l'elenco delle funzionalità e le capacità di ogni tool, consulta ISMS Copilot per agenti. Per gli ambiti e il ciclo di vita del token, vedi Token e ambiti.

2. Endpoint

https://account.ismscopilot.com/v1/account/mcp

Trasporto: HTTP MCP. Autenticazione: Authorization: Bearer pat-isms-…

3. Configurazione di Cursor

Cursor legge i server MCP da un file mcp.json: a livello di progetto in .cursor/mcp.json o globale in ~/.cursor/mcp.json. A partire da settembre 2026, una voce di server HTTP con header personalizzati ha il seguente aspetto:

{
  "mcpServers": {
    "ismscopilot": {
      "url": "https://account.ismscopilot.com/v1/account/mcp",
      "headers": {
        "Authorization": "Bearer pat-isms-..."
      }
    }
  }
}

Aggiungi la voce (tramite Impostazioni di Cursor, sezione MCP, oppure creando direttamente il file), poi riavvia Cursor e verifica che ismscopilot appaia nell'elenco dei tool MCP.

4. Configurazione di Codex

Codex legge il file ~/.codex/config.toml. A partire da settembre 2026, una voce di server MCP HTTP ha il seguente aspetto:

[mcp_servers.ismscopilot]
url = "https://account.ismscopilot.com/v1/account/mcp"

[mcp_servers.ismscopilot.http_headers]
"Authorization" = "Bearer pat-isms-..."

Riavvia Codex dopo aver modificato il file. Se la versione di Codex utilizza un nome diverso per la chiave degli header HTTP, segui la documentazione MCP corrente. Le parti costanti sono l'URL e l'header Bearer pat-isms-….

5. Test di verifica

Chiedi all'agente di elencare i tuoi workspace ISMS Copilot. Se i tool non appaiono:

• riavvia il client dopo aver aggiunto il server,
• verifica che il token non sia stato troncato durante l'incollaggio (deve iniziare con pat-isms-),
• conferma che l'URL sia quello dell'host dell'account indicato sopra, non un host API.

Se raggiungi il limite di utilizzo

La connessione utilizza la stessa finestra di sessione UTC di 4 ore dell'app di chat. Se create_conversation o send_message raggiunge il limite, il primo messaggio di errore è la frase che indica di attendere o effettuare l'upgrade (inclusa l'ora del prossimo reset) e il blocco JSON include reset_at. Gli account individuali e i proprietari di organizzazioni ricevono anche upgrade_url. I membri delle organizzazioni ricevono invece il messaggio del team: chiedi al proprietario di fornirti utilizzo aggiuntivo o attendi la prossima finestra di 4 ore. Il loro JSON include quota_scope, org_role e extra_usage_buyable, senza link di upgrade.

Attendi fino a reset_at oppure apri upgrade_url in un browser mentre sei autenticato con lo stesso account ISMS Copilot (account individuali e proprietari di organizzazioni). Quando il JSON include fallback_available: true e il sovraccarico del tuo piano è disponibile (account individuali a pagamento con Protezione dati avanzata disattivata; mai su un pool di team), puoi anche dire all'agente di continuare: con il tuo consenso esplicito, reinvia la richiesta con overflow_consent: true e il turno viene eseguito con lo stesso sovraccarico fino a 2x offerto dall'app web (la risposta include overflow_active: true). I tool di lettura continuano a funzionare dopo il limite di chat.

Vedi Cosa fare se raggiungi il limite di utilizzo.

6. Rotazione

Per la rotazione di routine, genera un nuovo token, sostituisci il vecchio token in mcp.json (Cursor) o config.toml (Codex), riavvia il client ed esegui il test di verifica. Poi revoca il vecchio token in Impostazioni. Se il vecchio token potrebbe essere stato compromesso, revocalo immediatamente prima di configurare il token sostitutivo.