Come connettere MySQL a Claude/Cursor tramite MCP (Configurazione del server MySQL MCP)

Scoprite tutto ciò che Query Streams può fare oltre questa guida Iniziare gratis

Supporti

+più

Dati in tempo reale

Sostituire le esportazioni con SQL on-demand

Excel Lenzuola

Analisi BI e AI

Chiedi a Nova, ottieni SQL + grafici

Incontrare Nova

API REST del database

Una chiave per ogni partner. Nessuna credenziale condivisa.

Creare un'API

+più

Automazione

Sincronizzazione programmata con oltre 6 piattaforme

Esplorare

+più

Da API a SQL

Interrogare le API con SQL, senza codice

Esplorare

+più

Database AI MCP

Claude, Cursor, ChatGPT e Grok interagiscono con i tuoi dati

Connetti l'IA

Query Streams è una piattaforma di integrazione dati sicura e in tempo reale che integra tutti i database e le API SaaS del tuo account in Claude, Cursor, ChatGPT e Grok, tramite un'unica chiave MCP e senza modifiche al firewall. Questa guida illustra nello specifico come configurare il connettore MySQL MCP, in modo che il tuo strumento di intelligenza artificiale possa rispondere a domande in linguaggio naturale su ordini, clienti, cataloghi prodotti e qualsiasi altro dato MySQL (join, aggregazioni, esplorazione dello schema, report ad hoc) senza dover copiare e incollare file CSV esportati da MySQL Workbench, phpMyAdmin, DBeaver o HeidiSQL. Per saperne di più, visita QueryStreams.com e iscriviti gratuitamente per iniziare a porre al tuo strumento di intelligenza artificiale domande reali su MySQL.

Cosa offre Query Streams MCP per MySQL

Altri server "MySQL MCP" presenti nel panorama open source collegano lo strumento di intelligenza artificiale direttamente a una stringa di connessione MySQL. Questo funziona, ma inserisce la password del database nella configurazione del client di intelligenza artificiale, limita l'utilizzo dello strumento a un solo endpoint MySQL e non fornisce alcuna traccia di controllo delle richieste effettivamente effettuate dall'IA. Il server Query Streams MCP per MySQL risolve un problema più ampio: un'unica chiave, tutti i connettori, traccia di controllo completa e lo strumento di intelligenza artificiale non memorizza mai le credenziali MySQL.

Come funziona senza aprire le porte del firewall

L'agente di rete Query Streams si installa una sola volta su una macchina in grado di raggiungere il server MySQL e stabilisce una connessione TLS in uscita verso il cloud utilizzando il protocollo di rete standard di MySQL: nessun dato in entrata viene esposto e lo strumento di intelligenza artificiale non visualizza mai la stringa di connessione a MySQL. Come funziona la connessione solo in uscita →

Il tasto MCP che assegni al cursore o a Claude è vincolato a un ambito specifico (Leggere / analizzare / eseguire), revocabile in qualsiasi momento e con limitazione di frequenza per chiave. Lo strumento di intelligenza artificiale richiama questi strumenti MCP per svolgere il suo lavoro:

Perché Schema Intelligence rende Query Streams MCP diverso

La maggior parte dei server “MCP per MySQL” nel panorama open-source forniscono al tuo strumento di IA lo stesso schema_informativo MySQL consegna uno sconosciuto. Nomi delle colonne. Tipi di dati. Forse una chiave primaria. L'LLM è lasciato a indovinare cosa status_id = 3 significa, cosa usr_eml negozi, o se articoli_dell'ordine in realtà si unisce a orders.id (in entrambi i casi non è mai stata dichiarata alcuna chiave esterna, una pratica comune negli schemi legacy dell'era MyISAM, precedenti all'implementazione delle chiavi esterne in InnoDB, e negli schemi MySQL 5.6, dove gli sviluppatori omettevano le dichiarazioni delle chiavi esterne per "prestazioni"). Ecco perché la prima query SQL che la maggior parte degli LLM scrive su uno schema vuoto è errata, non perché l'LLM sia inefficiente, ma perché non dispone dei dati necessari per essere corretto.

Query Streams MCP restituisce lo stesso schema arricchito con Schema Intelligence (SI) — Metadati curati dall'IA e profilati dal tuo reale Dati MySQL, quindi ogni strumento di schema restituisce lo schema di base più sei livelli di conoscenza curata e LLM smette di fare supposizioni. Perché Schema Intelligence distingue Query Streams MCP dagli altri →

Per rendere questo concreto, ecco cosa riceve il client AI da un singolo qs_get_table_schema chiamata contro un tipico database MySQL per l'e-commerce (clienti, ordini, articoli_dell'ordine, prodotti, pagamenti, categorie) — prima senza Schema Intelligence, poi con essa.

I sei livelli Schema Intelligence aggiungono

Ogni livello affronta una classe di domande a cui il LLM altrimenti risponderebbe per tentativi. La fase di profilazione SI, a cui si può aderire facoltativamente, viene eseguita sui dati MySQL senza modificare lo schema o scrivere nel database e si aggiorna in modo incrementale quando lo schema cambia. Cosa aggiunge Schema Intelligence e come si mantiene aggiornato →

Stesso prompt, SQL diverso

La prova sta nel codice SQL che lo strumento di intelligenza artificiale scrive effettivamente. Stessa sessione del cursore, stesso modello di Claude, stesso prompt — Quali sono stati i 5 prodotti con il fatturato più alto negli ultimi 30 giorni? Senza l'intelligenza dello schema, il LLM deve tirare a indovinare. Con essa, il LLM sa.

Collega AWS RDS, Azure Database o Google Cloud SQL MySQL a Claude

Oggi la maggior parte delle installazioni MySQL in produzione si basa su un servizio cloud gestito, anziché su un server locale. Query Streams MCP funziona allo stesso modo con i servizi MySQL gestiti su tutte le principali piattaforme cloud: l'unica differenza risiede nella posizione di installazione dell'agente di rete e nel metodo di autenticazione scelto. Di seguito sono riportati i tre scenari di implementazione più comuni, con la configurazione consigliata per ciascuno.

MCP non fa per te? Prova Nova AI.

Saltate completamente la configurazione JSON: Nova AI è integrata nel portale web Query Streams. e pone le stesse domande in linguaggio semplice al tuo connettore MySQL: stesso agente, stessa applicazione della sola lettura, stessa Schema Intelligence, nessuna infrastruttura MCP.

Scopri Nova AI

Prerequisiti

Prima di iniziare, assicurati di avere:

1. Un account Query Streams gratuito su my.querystreams.com.
2. L'agente di rete Query Streams installato su una macchina in grado di raggiungere il server MySQL — vedere Scarica l'agente Query Streams.
3. Un connettore MySQL configurato contro l'agente — vedere quello esistente configurazione del connettore Guide per la stringa di connessione. L'agente conserva la password dell'utente MySQL (o le credenziali IAM/Azure AD per MySQL cloud gestito); lo strumento di intelligenza artificiale non le modifica mai.
4. Qualsiasi client AI compatibile con MCP. In questa guida mostreremo Cursor, Claude Desktop, ChatGPT e Grok; se utilizzi Windsurf, Zed, Continue, Cline, VS Code Copilot, Codex o Goose, il blocco di configurazione è sostanzialmente lo stesso.
5. Cinque minuti.

Passaggio 1: Generare una chiave MCP in Query Streams

Accedi a Query Streams e apri il Pagina MCP (oppure accedi prima a my.querystreams.com e clicca MCP nella navigazione a sinistra). Fare clic Genera chiave, dare alla chiave un nome riconoscibile (qualcosa come cursore-laptop o claude-desktop), e seleziona gli ambiti che desideri assegnare a questa chiave:

• Leggere — L'IA può esplorare i connettori e leggere lo schema. Necessario per tutto il resto.
• analizzare — L'IA può profilare le tabelle e scoprire le relazioni (valori campione, distribuzioni, tipi semantici). Opzionale ma fortemente consigliato per i progetti MySQL, dove comprendere la struttura dei dati è fondamentale quando LLM genera join tra schemi legacy.
• eseguire — l'IA è effettivamente in grado di eseguire query SQL. Senza questa funzionalità, l'IA può accedere solo ai metadati dello schema in sola lettura.

Per un tipico flusso di lavoro "lascia che Claude analizzi i miei dati MySQL", tutti e tre gli ambiti sono appropriati. Per una chiave che stai consegnando a un collega o a un cliente meno affidabile, elimina eseguire e consentire loro solo di navigare. È possibile revocare qualsiasi chiave in qualsiasi momento dalla stessa pagina; il client AI vedrà MCP_KEY_REVOCATA alla sua prossima chiamata e smette di funzionare immediatamente. Non c'è ritardo di propagazione.

Copia la chiave ora: Query Streams la mostra una sola volta, poi memorizza solo un hash. Se la perdi, generane una nuova. La chiave ha questo aspetto: qsmcp_ seguito da 48 caratteri casuali ed è ciò che il tuo client AI invia nel Chiave X-MCP intestazione della richiesta.

Passaggio 2: Aggiungi Query Streams MCP al tuo client AI

La configurazione ha la stessa forma su ogni client compatibile con MCP: una voce del server MCP che punta a https://mcp.querystreams.com con la tua chiave nella Chiave X-MCP Intestazione. Seleziona il tuo cliente qui sotto.

Cursore ~/.cursor/mcp.json

// Modifica ~/.cursor/mcp.json
{
  "mcpServers": {
    "querystreams": {
      "url": "https://mcp.querystreams.com",
      "intestazioni": {
        "X-MCP-Key": "qsmcp_INSERISCI_QUI_LA_CHIAVE"
      }
    }
  }
}

Claude Desktop claude_desktop_config.json

// Impostazioni → Sviluppatore → Modifica configurazione
{
  "mcpServers": {
    "querystreams": {
      "url": "https://mcp.querystreams.com",
      "intestazioni": {
        "X-MCP-Key": "qsmcp_INSERISCI_QUI_LA_CHIAVE"
      }
    }
  }
}

ChatGPT App e connettori

// Impostazioni → App e connettori → Aggiungi MCP
URL del server  https://mcp.querystreams.com
Intestazione di autorizzazione Chiave X-MCP
Valore dell'intestazione qsmcp_INSERISCI_QUI_LA_CHIAVE

// Richiede un piano ChatGPT a pagamento
// (Plus / Pro / Team / Enterprise).

Grok Strumenti MCP remoti

// Grok → Impostazioni → Strumenti
{
  "mcp_servers": [{
    "nome": "querystreams",
    "url": "https://mcp.querystreams.com",
    "auth_header": "X-MCP-Key",
    "valore_di_autenticazione": "qsmcp_..."
  }]
}

Riavvia il tuo client AI. Al successivo avvio, rileverà gli otto strumenti Query Streams MCP elencati sopra e li renderà disponibili nella sua tavolozza degli strumenti. In Cursor e Claude Desktop puoi verificarlo digitando “connettori di elenco” — l'IA dovrebbe chiamare qs_list_connectors e restituisci il connettore MySQL insieme a qualsiasi altra configurazione tu abbia effettuato.

Passaggio 3: Poni una domanda su MySQL all'IA

Non sei tu a scrivere il codice SQL, lo fa l'IA. Poni una domanda, l'IA seleziona lo strumento MCP più adatto, l'agente esegue la query sul tuo database MySQL e la risposta viene restituita in formato testo e tabelle. Ecco tre esempi di query da provare inizialmente:

La prima volta che l'IA richiama uno strumento, il tuo client potrebbe visualizzare una richiesta di conferma per autorizzare la chiamata allo strumento: si tratta del flusso di consenso standard di MCP, non di una funzionalità aggiunta da Query Streams. Approva una volta e l'IA procederà liberamente con il resto della conversazione. Puoi rivedere il consenso in qualsiasi momento nelle impostazioni del tuo client.

Domande frequenti

Inizia

Guide correlate: Scarica l'agente Query Streams | Configurazione del connettore del database | Tutte le guide del server MCP | Nova AI text-to-SQL

Categoria: Server MCP

Tag: mcp, claude, cursore, mysql, database, database open-source, aws-rds, database azure, cloud-sql, aurora-mysql

Meta Description: Connetti MySQL a Claude o Cursor tramite Query Streams MCP. Compatibile con RDS, Azure e Cloud SQL. Solo in uscita, configurazione in 5 minuti.