Come collegare Cloudflare a Cursor via MCP

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

Cloudflare + Cursor

Fai gestire le tue zone Cloudflare alla tua AI: controlla e modifica i record DNS, svuota la cache, leggi le impostazioni della zona e le regole di redirect, transform e cache, consulta le statistiche del traffico ed elenca Workers e bucket R2. Con un API token limitato a ciò che deve toccare.

Prerequisiti

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

CLOUDFLARE_API_TOKEN

Step 1 — Ottieni le credenziali

1. Nella dashboard di Cloudflare apri My Profile → API Tokens (https://dash.cloudflare.com/profile/api-tokens), clicca su Create Token e poi, in fondo, su Create Custom Token. Puoi anche partire dal modello Read all resources e aggiungere i due permessi di scrittura qui sotto.
2. Dai un nome al token (per esempio "AnythingMCP") e aggiungi questi permessi:
   • Zone → Zone → Read, DNS → Edit (Read per un setup di sola lettura), Cache Purge → Purge
   • Zone → Zone Settings, Page Rules, Analytics e Workers Routes → Read
   • Per le regole: Zone → Single Redirect, Transform Rules, Cache Rules, Origin Rules, Config Rules e Zone WAF → Read (ogni tipo di regola richiede un permesso a sé)
   • Account → Account Settings, Workers Scripts, Workers R2 Storage e Account Analytics → Read
3. In Zone Resources scegli Include → All zones from an account, oppure Specific zone per limitare l'AI ad alcuni dei tuoi domini. In Account Resources includi il tuo account. Se vuoi, limita Client IP Address Filtering e imposta un TTL.
4. Clicca su Continue to summary → Create Token, copia il token (Cloudflare lo mostra una sola volta) e inseriscilo in CLOUDFLARE_API_TOKEN senza la parola Bearer, poi installa il connettore. Non usare la Global API Key.
5. Comincia con cloudflare_list_zones: mostra quali zone (domini) vede il token, con stato e piano.

Token dell'account: funziona anche un token creato in Manage Account → Account API Tokens, tranne che per le Page Rules: con questo token cloudflare_list_page_rules non riesce a leggerle.

Solo lettura: assegna al DNS solo Read, ometti Cache Purge e disattiva cloudflare_create_dns_record, cloudflare_update_dns_record e cloudflare_purge_cache. Impostazioni della zona, regole, statistiche, Workers e R2 sono comunque in sola lettura in questo connettore.

Disattivati all'installazione: cloudflare_delete_dns_record e cloudflare_purge_everything. Un record eliminato blocca nel giro di pochi secondi ciò che ne dipendeva (un sito, la consegna della posta, una verifica del dominio), quindi esporta prima la zona con cloudflare_export_dns_records. Svuotare tutta la cache manda la richiesta successiva di ogni visitatore al tuo server di origine, cosa che può sovraccaricare un sito molto visitato; di solito basta cloudflare_purge_cache con URL precisi.

Modifiche DNS: le modifiche sono attive in pochi secondi, quindi un record sbagliato può mettere offline subito un sito o la sua email. L'AI legge prima il record e ti mostra il valore vecchio e quello nuovo prima di cambiare qualcosa. Un CNAME non può condividere il nome con nessun altro record, e Cloudflare rifiuta un record identico.

Svuotamento della cache: cloudflare_purge_cache rimuove fino a 100 URL, cache tag, hostname o prefissi per chiamata, su ogni piano. Il piano Free consente 5 richieste di purge al minuto per tag, host o prefisso.

Statistiche: cloudflare_get_zone_traffic restituisce per ogni giorno richieste, traffico dati, traffico in cache, minacce, visualizzazioni di pagina e visitatori unici, suddivisi per codice di stato e paese. Per tutto il resto (percorsi più richiesti, eventi del firewall, invocazioni dei Worker) l'AI usa cloudflare_graphql_analytics. Quanto indietro puoi guardare dipende dal piano; il piano Free copre le ultime settimane.

Workers e R2: cloudflare_get_worker_settings mostra i binding di un Worker, ma mai i valori segreti. R2 deve essere attivato sull'account (Storage & databases → R2, basta il livello gratuito) prima che cloudflare_list_r2_buckets risponda; altrimenti fallisce con 403 "NotEntitled".

Limiti: Cloudflare consente 1.200 richieste API ogni 5 minuti per token, uso della dashboard compreso. Oltre questa soglia Cloudflare risponde 429 e blocca ogni chiamata per 5 minuti: attendi e riprova. Le query di statistiche hanno un limite proprio di circa 300 ogni 5 minuti.

Errori comuni: 400 con codice 6003 di solito significa che è stata inserita la Global API Key invece di un API token. 401 significa che il token è sbagliato, scaduto, disattivato o limitato ad altri indirizzi IP client: controllalo in My Profile → API Tokens. 403 (codici 10000 o 9109) significa che al token manca un permesso per quella chiamata o quella zona: modifica il token e aggiungilo, per esempio Zone Read o DNS Read. 404 indica una zona, un record o un ruleset sconosciuti; da cloudflare_get_phase_rules significa solo che la zona non ha regole di quel tipo. "An identical record already exists" o "A CNAME record with that host already exists" indicano il record che fa da ostacolo.

Il connettore non modifica ruleset, Page Rules o impostazioni della zona e non gestisce certificati SSL/TLS, deploy o eliminazione di Workers, oggetti KV, D1 o R2, Zero Trust, registrar o fatturazione.

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

Tool disponibili

Esempi di prompt

• "Mostrami tutti i record DNS di acme.com e dimmi quali non passano dal proxy di Cloudflare."
• "Quali regole di redirect sono impostate su acme.com, e dove finisce /blog?"
• "Quanto traffico ha avuto acme.com ogni giorno la settimana scorsa, e da quali paesi sono arrivate più richieste?"
• "Fai puntare il record A di shop.acme.com a 198.51.100.24, lascia attivo il proxy e mostrami il valore vecchio prima di cambiarlo."

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