Come connettere MariaDB a Claude/Cursor tramite MCP (Configurazione del server MariaDB tramite 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 MariaDB MCP, in modo che il tuo strumento di intelligenza artificiale possa rispondere a domande in linguaggio naturale su ordini, clienti, cataloghi di prodotti e qualsiasi altro dato di MariaDB (join, aggregazioni, esplorazione dello schema, report ad hoc) senza dover copiare e incollare file CSV esportati da HeidiSQL, DBeaver o phpMyAdmin. Per saperne di più, visita QueryStreams.com e iscriviti gratuitamente per iniziare a porre al tuo strumento di intelligenza artificiale domande reali su MariaDB.

Cosa offre Query Streams MCP per MariaDB

Altri server "MariaDB MCP" presenti nel panorama open source collegano lo strumento di intelligenza artificiale direttamente a una stringa di connessione MariaDB. Questo funziona, ma inserisce la password del database nella configurazione del client di intelligenza artificiale, limita l'utilizzo dello strumento a un solo endpoint MariaDB e non fornisce alcuna traccia di controllo delle richieste effettivamente effettuate dall'IA. Il server Query Streams MCP per MariaDB 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 di MariaDB.

Come funziona senza aprire le porte del firewall

L'agente di rete di Query Streams è un piccolo programma che si installa una sola volta su una macchina in grado di raggiungere il server MariaDB (qualsiasi laptop, server locale, istanza EC2, macchina virtuale Azure o macchina virtuale cloud nella stessa rete dell'host MariaDB). Apre un collegamento cloud TLS in uscita verso il cloud di Query Streams e rimane in attesa delle chiamate degli strumenti. Quando Claude o Cursor pongono una domanda, il cloud inoltra la richiesta all'agente, che esegue la query SQL su MariaDB tramite la rete locale utilizzando il protocollo standard MariaDB/MySQL, e il risultato viene ritrasmesso attraverso lo stesso canale in uscita. Nessun collegamento in entrata. Nessun elemento esposto. Lo strumento di intelligenza artificiale non vede mai la stringa di connessione a MariaDB.

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 MariaDB” nel panorama open-source consegnano al tuo strumento di IA lo stesso schema_informativo MariaDB 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 riga_articolo_ordine_id 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). 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 ciò che chiamiamo Schema Intelligence (SI) — Metadati curati dall'IA generati eseguendo query di profilazione sul tuo reale dati MariaDB prima ancora che il client AI li richieda. Quando SI è abilitato su un connettore e un database, ogni strumento di schema che l'AI chiama (qs_get_connector_schema, qs_get_table_schema, qs_profile_table, qs_get_relationships) restituisce lo schema di base più sei livelli di conoscenza curata. L'LLM smette di fare supposizioni.

Per rendere questo concreto, ecco cosa riceve il client AI da un singolo qs_get_table_schema chiamata contro un tipico database e-commerce MariaDB (ordini, voci di riga, clienti, prodotti) — prima senza Schema Intelligence, poi con essa.

I sei livelli Schema Intelligence aggiungono

Ogni livello affronta una specifica classe di domande a cui l'LLM altrimenti dovrebbe rispondere con delle supposizioni. SI è facoltativo per (connettore, database) Questo processo si associa e viene eseguito come una singola passata di profilazione sui dati di MariaDB: non modifica lo schema, non scrive nel database e si aggiorna in modo incrementale quando lo schema cambia.

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.

MCP non fa per te? Prova Nova AI.

Se modificare i file di configurazione JSON ti sembra più complicato di quanto ti aspettassi, lascia perdere MCP. Nova AI è integrata nel portale web Query Streams senza necessità di configurazione.. Poni le stesse domande in un linguaggio semplice (ad esempio “Mostrami gli ordini MariaDB che non sono stati spediti da più di 7 giorni”) attraverso lo stesso connettore MariaDB, lo stesso agente e la stessa Schema Intelligence — semplicemente senza alcuna configurazione MCP da parte tua.

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 MariaDB — vedere Scarica l'agente Query Streams.
3. Un connettore MariaDB configurato contro l'agente — vedere quello esistente configurazione del connettore Guide per la stringa di connessione. L'agente conserva la password dell'utente MariaDB (o le credenziali PAM/GSSAPI); 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 lavorare con MariaDB, 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 MariaDB", 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 MariaDB insieme a tutto il resto che hai configurato.

Passaggio 3: Poni una domanda a MariaDB 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 MariaDB 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, mariadb, database, mariadb-mcp, ai

Meta Description: Connetti MariaDB a Claude o Cursor tramite Query Streams MCP. Solo in uscita, sola lettura, configurazione in 5 minuti.