Collega MySQL HeatWave a Claude tramite MCP.

MCP · MySQL HeatWave per Claude

Chiedere Claude riguardo al tuo database MySQL HeatWave, in un linguaggio semplice

Collega Claude, Claude Code, Cursor o qualsiasi client MCP a Query Streams una sola volta. Claude legge la struttura del tuo database MySQL HeatWave, scrive la query SQL, la esegue in sola lettura tramite l'agente già presente con i tuoi dati e restituisce le righe corrispondenti. Nessuna password del database raggiunge mai l'IA. Il processo richiede circa dieci minuti ed è incluso nel piano gratuito.

Circa 10 minuti Claude, ChatGPT, Cursor + altri 11 clienti Le credenziali restano con te Sempre in sola lettura

Quello che otterrai alla fine

Un Claude in grado di rispondere alle domande sul tuo sistema di database MySQL HeatWave con query in tempo reale e in sola lettura, spiegare il significato delle colonne e fornire ulteriori chiarimenti quando ne chiedi, senza mai dover accedere al database e senza modificare il firewall: l'agente già presente nella tua rete esegue le query SQL e restituisce solo le righe. Una volta installato l'agente, la connessione di Claude richiede circa 90 secondi se hai familiarità con la schermata delle impostazioni. Ecco un esempio:

Claude ChatGPT Cursore Codice Claude VS Code Windsurf Interfaccia a riga di comando Gemini JetBrains Codice+5 in piùSola lettura

Cosa c'è dentro clienti nel mio database MySQL HeatWave? Mostrami alcune righe e spiegami il significato di ogni colonna.

qs_get_table_schema query_di_esecuzione_qs schema_intelligence

Ho prima esaminato la struttura della tabella, poi ho eseguito una query in sola lettura tramite il tuo agente. Ecco tre righe relative ai clienti:

ID cliente	nome	città
1042	Northwind Traders	Seattle
1057	Alpine Outfitters	Denver
1063	Harbour Foods	Halifax

ID cliente identifica la riga. nome e città are described in your Semantic Intelligence model, so I can filter on them by name.

Quali tre città Quali sono stati i valori che hanno generato il maggior fatturato in questo trimestre e come si confrontano con quelli del trimestre precedente? C'è qualcosa che dovrei approfondire?

qs_get_relationships query_di_esecuzione_qs query_di_esecuzione_qs

Mi sono unito clienti a ordini on the relationship Semantic Intelligence found, then ran one aggregate for each quarter. Both queries were read-only and returned 3 rows each:

città	Questo trimestre	Ultimo trimestre	Modifica
Denver	184,200	133,900	+38%
Seattle	171,650	168,400	+2%
Halifax	96,300	129,700	-26%

Denver Ecco la storia: il fatturato è aumentato del 38% con quasi lo stesso numero di clienti, quindi il valore medio degli ordini è cresciuto. Halifax Le vendite sono diminuite del 26%, e il calo è dovuto a due clienti che ordinavano ogni mese nel trimestre precedente e non hanno effettuato alcun ordine in questo trimestre: vale la pena chiamarli prima della fine del mese. A Seattle la situazione è stabile. Volete i nomi dei due clienti di Halifax?

SELEZIONA soltanto, controllato dall'agente accesso effettuato nella scheda Attività MCP 9 righe restituite da 3 query Stessa connessione in 14 client MCP

Preferiresti non configurare affatto un client di intelligenza artificiale? Nel piano aziendale, Nova is the assistant built into Query Streams itself. It has every tool Claude gets here, plus the ones Claude does not: it drafts and validates the SQL against your Semantic Intelligence model, turns the answer into a chart, and saves the result as a query your team can run from Excel, Google Sheets or the REST API — no key, no connector, nothing to install. Use MCP when your people already live in Claude, Cursor or ChatGPT; use Nova when you want the answers inside the Portal.

MySQL HeatWave memorizza i tuoi dati nel cloud, gestito dal suo provider. Claude, d'altro canto, risiede in un browser o in un terminale e non ne sa nulla. Il metodo tradizionale consiste nell'incollare uno schema nella chat e sperare che funzioni, oppure nel fornire la password di MySQL HeatWave a un server MCP open source. Query Streams funziona diversamente: l'agente già presente nel tuo sistema di database MySQL HeatWave esegue le query SQL scritte da Claude, in sola lettura, e il server MCP, nel frattempo, verifica chi sta effettuando la richiesta, cosa può fare e con quale frequenza. Claude riceve le risposte. Non ottiene mai le credenziali.

HeatWave è il servizio MySQL gestito da Oracle su OCI e AWS, quindi Claude interagisce con esso esattamente come farebbe con qualsiasi altro server MySQL. L'unica differenza riguarda la rete: un sistema DB su OCI non ha un indirizzo pubblico, quindi l'agente deve essere eseguito in una posizione da cui possa raggiungere l'endpoint privato.

Cosa ti servirà

Un account Query Streams

MCP è disponibile in tutti i piani, incluso quello gratuito. Il piano gratuito consente una chiave o un'app connessa, che è tutto ciò di cui questa guida ha bisogno. Registrati su my.querystreams.com.

MySQL HeatWave connesso tramite l'agente

L'agente viene installato su qualsiasi computer sempre acceso, con la connessione MySQL HeatWave aggiunta in Agenti dati.

Scegli il MySQL HeatWave scheda. La porta 3306 e l'opzione "Usa SSL" sono già precompilate. Devi inserire l'endpoint, il database, il nome utente e la password. Su OCI, l'endpoint e la porta si trovano nella pagina dei dettagli del sistema DB nella console OCI. Tale endpoint è un IP privato, quindi installa l'agente su una macchina all'interno della stessa VCN o su una rete ad essa collegata tramite VPN. Su AWS, copia il nome host dell'endpoint del sistema DB dalla console HeatWave.

MCP attivato per te

I creatori, i proprietari e gli amministratori ce l'hanno fin dall'inizio. Tutti gli altri hanno bisogno di un amministratore per ribaltare il MCP interruttore accanto al loro nome sotto Account → Controllo accessiFino ad allora, la pagina MCP visualizza il messaggio "MCP è disabilitato per il tuo account".

Un client IA

Claude sul web, Claude Desktop o le app mobili di Claude si connettono senza bisogno di password. Funzionano anche Claude Code, Cursor, ChatGPT e una decina di altri strumenti; il Portale offre una configurazione predefinita per ognuno di essi.

Configuralo in quattro passaggi

1. Apri MCP nel portale

   Accedi a my.querystreams.com e aperto Streaming → In diretta → MCPLa pagina presenta quattro schede: Collegare, App connesse, Le mie chiavi e, per gli amministratori, Attività. Controlla il Le mie chiavi side panel while you are here: it lists your MySQL HeatWave connector and whether Semantic Intelligence has run on it. Complete coverage is what lets Claude write correct MySQL HeatWave SQL on the first try.

   Apri MCP

   Visualizzate il messaggio "MCP è disabilitato per il vostro account"? La tua organizzazione ha MCP ma il tuo utente è disattivato. Un amministratore lo attiva con il MCP interruttore accanto al tuo nome sotto Account → Controllo accessiCreatori, proprietari e amministratori sono attivi fin dall'inizio.

2. Scegli come ti connetterai

   Ci sono due vie d'accesso, ed entrambe conducono allo stesso punto:

   App di chat · nessuna chiave

   claude.ai, Claude Desktop, ChatGPT

   In Claude, Query Streams è nel Elenco dei connettori antropici: sfoglia i connettori, fai clic Collegare. Altrove incolli un indirizzo nell'app, https://mcp.querystreams.com/mcpe connettersi da una chat. Si apre una pagina Query Streams, si seleziona l'organizzazione e le autorizzazioni e si fa clic Approva la connessione. Niente da copiare, niente da tenere segreto. La connessione appare sotto App connesse e può essere revocato lì.

   strumenti per sviluppatori · una chiave

   Claude Code, Cursor, VS Code e amici

   SU Le mie chiavi clic Genera chiave. Dagli un Nome chiave come “Claude Code sul mio laptop”, mantieni Leggere e Eseguire spuntato, scegli un Scadenza (Mai, 30 giorni, 90 giorni o 1 anno) e fai clic Genera chiaveCopialo, quindi Continua l'installazione: IL Collegare La scheda mostra il frammento esatto del tuo strumento con la chiave già inserita.

   Entrambi i metodi utilizzano le stesse tre autorizzazioni, che è possibile selezionare nella schermata di consenso o nella chiave:

   Leggere

   Elenca i connettori, sfoglia tabelle e colonne, leggi le query salvate e le regole di avviso. Non restituisce mai dati di riga.

   Eseguire

   Esegui query SQL di sola lettura e query salvate tramite il tuo agente e restituisci le righe. Senza di esso, Claude può descrivere i tuoi dati, ma non può fornire risposte in base ad essi.

   Analizzare

   Profile tables, discover relationships and queue a Semantic Intelligence run. It spends Nova AI credits and data allowance, so the consent screen never pre-ticks it.

   Hai perso le chiavi? Apri Le mie chiavi: l'icona dell'occhio lo mostra di nuovo e Copia la chiave completa Lo copiano. Revocatelo lì se un portatile viene smarrito; ogni client che lo utilizza fallisce alla successiva chiamata, entro circa cinque minuti.

3. Mettiti in contatto con Claude

   Scegli la ricetta per il Claude che usi. L'indirizzo del server è lo stesso ovunque: https://mcp.querystreams.com/mcp.

   Claude sul web, Claude Desktop e mobile nessuna chiave

   1. Apri Impostazioni → Connettori e clicca Sfoglia i connettori. Query Streams è elencato nel Elenco dei connettori antropici: Trovare Flussi di query e clicca Collegare(Oppure apri direttamente l'elenco della directory e fai clic Collegare Là.)
   2. Se la tua organizzazione nasconde i connettori di directory, fai clic Aggiungi connettore personalizzato invece. Dagli un nome Flussi di query, impasto https://mcp.querystreams.com/mcp, lascia vuoti i campi OAuth, fai clic Aggiungi, quindi in qualsiasi chat fai clic + → Sfoglia i connettori → Flussi di query → Collegare.
   3. Si apre una scheda Query Streams. Accedi se richiesto, scegli l'organizzazione, rivedi Leggere e Eseguire, facoltativamente Limita a connettori specificie clicca Approva la connessione.
   4. Tornando a Claude, vedi “Connesso a Query Streams”. La prima volta che Claude usa uno strumento ti chiede; scegli Permetti sempre.

   Se lo aggiungi manualmente in Claude Desktop, usa Impostazioni → Connettori → Aggiungi, non la chat in corso Aggiungi marketplace opzione che richiede un repository Git. I connettori si sincronizzano con il tuo account Claude, quindi le app per dispositivi mobili e desktop lo rilevano automaticamente. I nomi dei menu sono di Anthropic e possono essere modificati.

   Codice Claude chiave

   Un solo comando, con il tuo tasto da Le mie chiavi:

   terminale

   claude mcp add --transport http querystreams https://mcp.querystreams.com/mcp \ --header "X-MCP-Key: qsmcp_INSERISCI_QUI_LA_TUA_CHIAVE"

   Ciò scrive il progetto attuale .mcp.json. Aggiungere --scope utente per avere Query Streams in ogni progetto. Esegui /mcp All'interno di Claude Code per vedere la connessione.

   Cursore chiave

   Apri Impostazioni cursore → MCP → Aggiungi nuovo server MCP, oppure modifica .cursor/mcp.json alla base del tuo spazio di lavoro:

   .cursor/mcp.json

   { "mcpServers": { "querystreams": { "url": "https://mcp.querystreams.com/mcp", "headers": { "X-MCP-Key": "qsmcp_INSERISCI_QUI_LA_TUA_CHIAVE" } } } }

   Riavvia Cursor o esegui MCP: Riavvia i server; UN querystreams Il badge appare nella barra di stato dell'MCP.

   Usando qualcos'altro? IL Collegare scheda ha ricette pronte da incollare per ChatGPT, VS Code, Visual Studio, OpenAI Codex CLI, Gemini CLI, Windsurf, Zed, Cline, Continue.dev e JetBrains AI, oltre a Incolla e unisci strumento che lascia cadere querystreams voce in un file di configurazione che hai già. Qualsiasi client che comunica tramite MCP su HTTP funziona: server https://mcp.querystreams.com/mcpintestazione Chiave X-MCP (UN Autorizzazione: al portatore (Anche l'intestazione con la stessa chiave funziona).

4. Poni la tua prima domanda

   Iniziate con qualcosa di cui conoscete già la risposta, così potrete vedere Claude scegliere lo strumento giusto. Tre strumenti che funzionano bene con il vostro sistema di database MySQL HeatWave:

   "Quali dati sono presenti nel mio sistema di database MySQL HeatWave?"

   Claude lists the tables it can see, tells you which have Semantic Intelligence, and asks what you want to look at.

   "Mostrami dieci righe di dati dei clienti e spiegami ciascuna colonna."

   Claude legge prima la struttura della tabella (Read), poi esegue una SELECT tramite il tuo agente (Execute) e descrive il significato di nome e città.

   "Quante file di clienti ci sono per città? Quale città ne ha di più?"

   Claude scrive la clausola GROUP BY nel dialetto di MySQL HeatWave, la esegue e risponde con una frase allegando una piccola tabella. Continuate la conversazione nella stessa chat; il contesto rimane invariato.

   Per confermare il cablaggio, chiedere “Quali connettori Query Streams ho a disposizione?”Claude chiama qs_list_connectorse su Le mie chiavi la chiave Ultimo utilizzo L'ora si aggiorna in pochi secondi. Un'app connessa viene visualizzata sotto App connesse con l'indicazione dell'ora di connessione e dell'ultimo utilizzo.

Cosa può fare Claude una volta connesso

Claude vede diciannove piccoli strumenti. Non devi mai nominarli tu; Claude sceglie quello giusto per la tua domanda. In parole semplici:

Why Semantic Intelligence matters here

Ogni risposta che Claude riceve è etichettata con l'indicazione della provenienza della struttura, e Claude regola di conseguenza il livello di fiducia che ripone in ciò che osserva.

If a database matters, run Semantic Intelligence on it once from Nova → Intelligenza. IL Le mie chiavi La scheda mostra un pannello di copertura per ciascun connettore. How Semantic Intelligence works.

Cosa consentono i piani

MCP è incluso in tutti i piani, compreso quello gratuito, senza costi aggiuntivi. Ogni piano definisce il numero di tasti o app connesse che è possibile utilizzare e il numero di chiamate al minuto che Claude può effettuare:

A connected app counts as a key. On top of the per-minute figure, any one key may run at most 10 queries a minute. A query returns up to 1,000 rows and runs for up to 60 seconds unless Claude asks for more, to a ceiling of 50,000 rows and five minutes. The rows Claude receives count against your Data Realm allowance, the same pool your Excel and Sheets queries use, and MCP is measured before compression, so a wide result costs more here than the same rows in a spreadsheet. Semantic Intelligence runs started from Claude spend Nova AI credits, exactly as they do from the Portal. Consulta la pagina dei prezzi per le indennità.

Tenerlo al sicuro

Buone mosse successive

• Salva le query che consideri canoniche In Query Builder, Claude utilizza prima le query salvate, quindi "clienti attivi" ha il significato che il tuo team gli attribuisce.
• Utilizzare un progetto Claude con Query Streams collegato e inserisci le tue regole interne nelle relative istruzioni: quale database MySQL HeatWave utilizzare per impostazione predefinita, quali query salvate sono le definizioni ufficiali.
• Grant Analyze è il servizio che offre per chi desidera risposte più approfondite. La profilazione di una colonna prima di applicare un filtro fa la differenza tra indovinare un codice di stato e utilizzare quello corretto. Questa operazione consuma crediti Nova AI, quindi rimarrà disattivata finché non la si disattiva.
• Richiedi un grafico. claude.ai genera grafici a partire dalle righe che Claude riceve in risposta.

Quando qualcosa non funziona

Domande che le persone si pongono

Guide correlate

• Connetti Microsoft SQL Server a Claude con MCP
• Connetti PostgreSQL a Claude con MCP
• Connetti MySQL a Claude con MCP
• Collega Microsoft Access a Claude con MCP
• Connettere Query Streams a Claude tramite MCP: configurazione, autorizzazioni e risoluzione dei problemi
• Tutte le guide MCP