Come collegare Neon a Cursor via MCP

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

Neon + Cursor

Fai gestire alla tua AI Neon, il Postgres serverless: progetti, branch, compute endpoint, database, ruoli, schemi, operazioni e consumi. Dopo la tua conferma crea branch e avvia o sospende i compute. Non restituisce mai password. Con una API key di Neon.

Prerequisiti

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

NEON_API_KEY

Step 1 — Ottieni le credenziali

1. Nella Neon Console apri Account settings → API keys per una chiave personale (agisce come te, in tutte le organizzazioni di cui fai parte), oppure Organization settings → API keys per una chiave che raggiunge solo i progetti di quell'organizzazione. Una chiave limitata a un progetto raggiunge un solo progetto.
2. Crea la chiave e copiala subito: Neon la mostra una sola volta. Incollala in NEON_API_KEY e installa il connettore. La chiave viene inviata solo a console.neon.tech.
3. Verifica la configurazione con neon_list_organizations: elenca le organizzazioni a cui appartiene la chiave, con il loro org_id.

Cosa copre: organizzazioni, progetti, branch, compute endpoint, database, ruoli, schemi dei database, operazioni e consumi, tramite la Neon API v2. L'AI scende da neon_list_projects a neon_get_project, neon_list_branches, neon_list_endpoints, neon_list_databases, neon_list_roles e neon_get_database_schema, che mostra tabelle, colonne, indici e vincoli di un database, anche com'erano in un momento passato. Con una chiave personale, i progetti di un'organizzazione richiedono l'org_id.

Chiede prima di ogni modifica: neon_create_branch, neon_start_endpoint e neon_suspend_endpoint modificano il tuo progetto, quindi l'AI ti dice cosa succederà e aspetta il tuo sì.

• Un compute acceso consuma ore di calcolo, che scalano dalla quota del tuo piano o vengono addebitate nei piani a pagamento. neon_start_endpoint fa partire il contatore; i compute scendono a zero da soli dopo il timeout di sospensione.
• neon_suspend_endpoint chiude subito tutte le connessioni aperte verso quel compute.
• neon_create_branch crea all'istante un branch copy-on-write, se vuoi a partire da un momento passato. I branch oltre la quota del piano possono costare, e un compute aggiunto al branch parte subito. Dai una data di scadenza ai branch temporanei.
• Ogni modifica gira come operazione in background; neon_list_operations e neon_get_operation mostrano quando è finita.

Disattivato all'installazione: neon_delete_branch, che elimina un branch insieme ai suoi compute. Un amministratore lo attiva consapevolmente. Il branch root e quello predefinito non si possono mai eliminare.

Consumi e costi: neon_get_consumption restituisce tempo di calcolo, storage, numero di branch e traffico di rete per progetto, per ora, giorno o mese. Richiede l'org_id, funziona solo nei piani a pagamento (Launch, Scale, Business, Enterprise) e non risveglia nessun compute. Anche i dettagli di progetto e branch mostrano tempo di calcolo, tempo attivo, dati scritti e traffico del periodo in corso.

Niente password, niente SQL: password dei ruoli e connection string non vengono mai restituite, quindi nessuna password del database arriva all'AI. Questo connettore non esegue nemmeno SQL: l'SQL via HTTP di Neon richiede una connection string con la password del ruolo, non la API key. Per interrogare i tuoi dati aggiungi il connettore PostgreSQL con un ruolo Postgres dedicato in sola lettura sul tuo host Neon (porta 5432, SSL obbligatorio). neon_get_database_schema mostra comunque la struttura, senza alcuna password.

Errori comuni: 401: la API key è errata o è stata revocata; creane una nuova. 403: la chiave non può raggiungere quel progetto o quell'organizzazione (una chiave di progetto o di organizzazione usata altrove), oppure il tuo piano non include la funzione, per esempio lo storico dei consumi. 404: ID di progetto, branch o endpoint sbagliato. 423 Locked: sul progetto è in corso un'altra operazione; aspetta che finisca e riprova. 429: troppe richieste; attendi un momento e riprova.

Il connettore non crea né elimina progetti, database o ruoli, non reimposta password e non copre Neon Auth, la Data API, gli snapshot e l'amministrazione delle organizzazioni.

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

Tool disponibili

Esempi di prompt

• "Elenca tutti i nostri progetti Neon con regione, versione di Postgres e dimensione dello storage, e dimmi quali non hanno avuto attività di calcolo questo mese."
• "Mostrami lo schema del database app sul nostro branch di produzione: tabelle, colonne e indici."
• "Crea un branch feature-billing da main che scada tra 7 giorni. Prima dimmi quanto può costare."
• "Quali compute sono attivi in questo momento? Sospendi quello del branch di preview, ma chiedimelo prima."
• "Quanto tempo di calcolo e quanto storage ha usato ogni progetto il mese scorso?"

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