Come collegare 1Password Connect a Cursor via MCP

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → 1Password Connect, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente git clone, niente server locale.

1Password Connect + Cursor

Vault ed elementi di 1Password tramite il tuo server 1Password Connect self-hosted: elenca vault ed elementi, legge gli elementi con i loro valori segreti e i file allegati, crea elementi con password generate, li aggiorna con JSON Patch e legge il registro delle richieste del server. L'eliminazione è disattivata all'installazione.

Prerequisiti

Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:

ONEPASSWORD_CONNECT_URL, ONEPASSWORD_CONNECT_TOKEN

Step 1 — Ottieni le credenziali

La configurazione richiede circa 15 minuti e un server 1Password Connect già in funzione, la REST API self-hosted che 1Password esegue nella tua infrastruttura per Secrets Automation.

1. Su 1Password.com apri Developer, Directory, seleziona Other sotto Infrastructure Secrets Management e Create a Connect server (oppure esegui op connect server create <name> --vaults <vault>). Salva il file 1password-credentials.json e il primo access token in 1Password. Connect raggiunge solo i vault condivisi che gli sono stati assegnati, mai i vault personali o privati.
2. Installa il server: i container connect-api e connect-sync da https://github.com/1Password/connect, con Docker Compose, Kubernetes o il chart Helm. Di default ascolta sulla porta 8080.
3. Usa il primo token o emettine uno solo per l'AI: Developer, Connect servers, scegli il server, New Token (oppure op connect token create <name> --server <server> --vault <vault>). Concedi solo i vault che l'AI deve vedere. I vault di un token non si possono cambiare in seguito; revocalo ed emettine uno nuovo. Si può impostare una scadenza di 30, 90 o 180 giorni.
4. Imposta ONEPASSWORD_CONNECT_URL sull'indirizzo del server così come lo raggiunge AnythingMCP, senza /v1 e senza barra finale (per esempio https://op-connect.example.com o http://10.0.0.5:8080), e incolla il token (un JWT che inizia con eyJ, senza Bearer) in ONEPASSWORD_CONNECT_TOKEN.
5. Installa il connettore ed esegui onepassword_connect_list_vaults: conferma il token ed elenca i vault raggiungibili.

Dove gira il server Connect: su AnythingMCP Cloud il server Connect ha bisogno di un indirizzo HTTPS pubblico. Un AnythingMCP self-hosted raggiunge un server su una rete o un IP privati solo dopo che quell'host è stato consentito con SSRF_ALLOWED_HOSTS, perché la protezione sulle connessioni in uscita blocca di default gli spazi di indirizzi privati.

L'AI vede i valori segreti. Questi strumenti restituiscono secret in chiaro:

• onepassword_connect_get_item: password, chiavi API, seed TOTP, note e altri campi nascosti dell'elemento, in fields[].value.
• onepassword_connect_get_file_content: il contenuto di un file allegato (certificati, file di chiavi, documenti), fino a 4 MB.
• onepassword_connect_create_item e onepassword_connect_update_item: rispondono con l'elemento completo, compresi i valori segreti e un'eventuale password generata.

Questi valori arrivano al modello AI e nella chat. Gli strumenti di elenco (onepassword_connect_list_vaults, onepassword_connect_list_items, onepassword_connect_list_files), onepassword_connect_get_vault e onepassword_connect_get_file restituiscono solo metadati. Concedi al token solo i vault che l'AI deve vedere, e fai disattivare a un amministratore del workspace onepassword_connect_get_item e onepassword_connect_get_file_content se l'AI deve lavorare solo con i nomi. L'AI non ripete un secret in una risposta se non sei tu a chiederlo.

Trovare un secret: onepassword_connect_list_vaults (filtro come name eq "Production"), poi onepassword_connect_list_items con titolo, categoria, tag, URL, versione e date (filtro title eq "Stripe API" o tag eq "prod"), poi onepassword_connect_get_item solo quando serve il valore stesso. File: onepassword_connect_list_files o onepassword_connect_get_file per nomi e dimensioni, onepassword_connect_get_file_content per scaricarne uno.

Cosa scrive: onepassword_connect_create_item con categoria, titolo e campi; un campo con generate: true e un recipe riceve da 1Password un valore casuale. onepassword_connect_update_item modifica parte di un elemento con JSON Patch (RFC 6902: add, remove, replace) su /title, /favorite, /tags, /urls, /fields (per aggiungere un campo), /fields/<field id> o /fields/<field id>/value; il percorso / sostituisce l'intero elemento. L'AI legge prima gli id dei campi con onepassword_connect_get_item. 1Password conserva la versione precedente nella cronologia dell'elemento.

Controlli sul server: onepassword_connect_list_activity elenca le richieste gestite dal server, dalla più recente: READ, CREATE, UPDATE o DELETE con SUCCESS o DENY, per token ed elemento. onepassword_connect_get_health mostra se il server, il suo servizio di sync e la connessione all'account funzionano, e distingue così un problema del server da uno del token.

Disattivati all'installazione: onepassword_connect_delete_item. Non si può annullare, e le applicazioni che leggono il secret tramite Connect smettono subito di trovarlo, quindi un amministratore del workspace lo attiva quando il team ne ha bisogno.

Formati dei dati: gli id di vault ed elementi sono 26 lettere minuscole e cifre. Un campo ha id, label, type (STRING, CONCEALED, EMAIL, URL, TOTP, DATE, MONTH_YEAR, MENU), purpose (USERNAME, PASSWORD, NOTES), value e section; i campi password hanno anche entropy. Le date sono ISO 8601.

Paginazione: gli elenchi restituiscono l'intera raccolta in una risposta. Solo onepassword_connect_list_activity pagina, con limit (default 50) e offset, e riporta il totale nell'header content-range (1-50/1134).

Errori comuni: 401 significa token errato o revocato, oppure emesso per un altro server Connect. 403 vault ... is not in scope significa che al token non è stato concesso quel vault o che non può scriverci. 404 significa che vault, elemento o file non esistono; 404 a ogni chiamata significa che ONEPASSWORD_CONNECT_URL non è l'indirizzo della Connect API. 400 in una scrittura indica il campo o la categoria non validi. 413 significa che un file è troppo grande da restituire. Gli errori di connessione di solito significano che AnythingMCP non raggiunge ONEPASSWORD_CONNECT_URL; onepassword_connect_get_health e i log del server dicono di più.

Il connettore non raggiunge vault personali o privati né vault non concessi al token, non elimina elementi con gli strumenti attivi all'installazione, non crea server o token Connect e non legge gli eventi di accesso e di audit dell'account (per quelli c'è il connettore 1Password Events).

Step 2 — Installa l'adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Step 3 — Aggiungi il connettore in Cursor

L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostra YOUR_SERVER_ID.

Cursor legge i server MCP da ~/.cursor/mcp.json. Aggiungi questa voce:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una chiave API MCP in AnythingMCP da MCP Servers → il tuo server → API keys e incollala al posto di YOUR_MCP_API_KEY.
2. Salva il file e riavvia Cursor.
3. Apri Cursor → Settings → MCP e verifica che anythingmcp sia elencato e connesso.
4. Inizia a chattare: l'agente ora può usare i tool di 1Password Connect.

Tool disponibili

Esempi di prompt

• "Quali vault può raggiungere l'AI, e quanti elementi ci sono in ciascuno?"
• "Trova l'elemento Stripe API nel vault Production e dimmi quando è stato modificato l'ultima volta, senza mostrare la chiave."
• "Crea nel vault DevOps un elemento Login per il database di staging, con nome utente app e una password generata."
• "Aggiungi il tag rotated all'elemento Mail relay nel vault Infrastructure."
• "Quali token hanno letto elementi tramite Connect oggi, e ci sono state richieste rifiutate?"

FAQ

Cursor supporta server MCP personalizzati nel piano gratuito? Sì, MCP è disponibile nei piani Hobby, Pro e Business.

Prossimi passi

• Landing del connettore
• Collegare a Claude
• Collegare a ChatGPT
• Collegare a Gemini
• Collegare a Meta Muse
• Collegare a Microsoft Copilot