Collega Oracle a Claude con MCP

MCP · Oracolo di Claude

Chiedere Claude riguardo al tuo database Oracle, in un linguaggio semplice

Connect claude.ai, Claude Desktop, ChatGPT, Cursor or any MCP client to Query Streams once. Your AI client asks; the Agent that already sits with your Oracle database, its partner inside your network, does the heavy lifting: it runs the SQL read-only, and on paid plans it also sizes, profiles and holds results so follow-ups need no second query. No database password ever reaches the AI. About ten minutes, and the Free plan covers it.

Circa 10 minuti Claude, ChatGPT, Cursor + altri 11 clienti I dati rimangono sulla tua rete Sempre in sola lettura

Quello che otterrai alla fine

Un Claude in grado di rispondere alle domande sul tuo database Oracle 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 Oracle? Mostrami alcune righe e spiegami il significato di ciascuna 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 della tabella CLIENTI:

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

ID cliente identifica la riga. nome_cliente e città sono descritti nel tuo modello di Intelligenza Semantica, quindi posso filtrarli per nome.

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 Sulla relazione individuata dall'Intelligenza Semantica, è stata quindi eseguita un'aggregazione per ogni trimestre. Entrambe le query erano di sola lettura e restituivano 3 righe ciascuna:

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 uses the same Agent toolset your AI client gets here, plus what an outside client 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.

Oracle memorizza i tuoi dati su un server gestito da te o dal tuo team. 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 propria password Oracle a un server MCP open source. Query Streams funziona diversamente: l'agente già presente nel tuo database Oracle 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.

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.

Oracle connesso tramite l'agente

L'agente è installato nella stessa directory del database Oracle, con la connessione aggiunta in Data Agents. Non hai ancora finito? Connetti prima OracleCi vogliono circa dieci minuti.

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

Chat apps such as claude.ai, Claude Desktop and ChatGPT connect with no key. Claude Code, Cursor, VS Code and about ten other tools use a key; the Portal’s Connect an AI client guide sets up each one.

Configuralo in quattro passaggi

1. Apri MCP nel portale

   Accedi a my.querystreams.com e aperto Streaming → In diretta → MCPLa pagina presenta quattro schede: Connessioni, Context, Utensili e, per gli amministratori, Attività. Check the Semantic Intelligence panel on Connessioni while you are here: it lists your Oracle connector and whether Semantic Intelligence has run on it. Complete coverage is what lets Claude write correct Oracle 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.ai and Claude Desktop, open the Query Streams listing in Anthropic’s Connectors Directory, click Collegare and approve. Adding it by URL, https://mcp.querystreams.com/mcp, is the fallback. In ChatGPT you add Query Streams from the app (developer mode for now) and sign in with Query Streams. Either way a Query Streams page opens: pick the organization and the permissions and click Approva la connessione. Nothing to copy. The connection appears on the Connessioni tab and can be revoked there.

   strumenti per sviluppatori · una chiave

   Claude Code, Cursor, VS Code e amici

   On the MCP page click Connect an AI client. The guide asks How will your AI client connect?: choose Use a key in a config file, pick your tool, then Generate a key for it: a Nome chiave, Leggere e Run queries ticked, an Scadenza (Never, 30 days, 90 days or 1 year). Set it up shows the snippet with the key filled in, and Check the connection waits for the first call.

   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.

   Run queries

   Run read-only SQL and saved queries through your Agent and return the rows. Without it your AI client can describe your data but not answer from it.

   Analizzare

   Crea tabelle di profili, scopri le relazioni e metti in coda un'esecuzione di Intelligenza Semantica. Questo processo consuma crediti Nova AI e traffico dati, quindi la schermata di consenso non richiede mai una spunta preliminare.

   Hai perso le chiavi? It is listed on the Connessioni tab: Reveal full key shows it again and 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 il Query Streams listing in Anthropic’s Connectors Directory and click Collegare. In Desktop it then sits under + → Connettori.
   2. Fallback, if your organization hides directory connectors: Settings → Connectors → Add custom connector, name Flussi di query, URL https://mcp.querystreams.com/mcp, OAuth fields empty, Aggiungi; then in a chat + → Flussi di query → Collegare.
   3. Si apre una scheda Query Streams. Accedi se richiesto, scegli l'organizzazione, rivedi Leggere e Run queries, 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

   One command, with your key from the Connections tab:

   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? The Portal’s Connect an AI client guide 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 database Oracle:

   "Quali dati sono presenti nel mio database Oracle?"

   Claude elenca le tabelle che può visualizzare, indica quali dispongono di Intelligenza Semantica e chiede cosa si desidera visualizzare.

   "Mostrami dieci righe dalla tabella CLIENTI e spiega ciascuna colonna."

   Claude reads the table structure first (Read), then runs one SELECT through your Agent (Run queries) and describes what cust_name and city mean.

   "Quante righe ha CLIENTE per città? Quale città ne ha di più?"

   Claude scrive la clausola GROUP BY nel dialetto di Oracle, la esegue e risponde con una frase allegando una piccola tabella. Continua la conversazione nella stessa chat; il contesto viene mantenuto.

   Per confermare il cablaggio, chiedere “Quali connettori Query Streams ho a disposizione?”Claude chiama qs_list_connectors, the Portal guide’s Check the connection step says Collegato, and the key or app on the Connessioni tab shows its Ultimo utilizzo time within a few seconds.

Cosa può fare Claude una volta connesso

Your AI client sees the Query Streams tools; it picks the right one for your question. The Portal’s Utensili scheda lists all 38 tools and modes with what your plan includes. On every plan, Free included:

The Analytic toolset. On paid plans the Agent does the groundwork where your Oracle database lives, so your AI client spends its attention on the thinking. Free works as it always has.

The defaults live on the Context scheda: text cell limit, schema view, result size, analysis defaults and held results.

Perché l'intelligenza semantica è importante in questo contesto

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.

Se un database è importante, esegui l'Intelligenza Semantica su di esso una volta da Nova → Intelligenza. IL Connessioni La scheda mostra un pannello di copertura per ciascun connettore. Come funziona l'intelligenza semantica.

Cosa consentono i piani

MCP is on every plan, including Free, with no separate fee. What each plan sets is how many keys or connected apps you can hold and how many calls a minute your AI client may make:

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 runs for up to 60 seconds unless your AI client asks for more, up to five minutes. Your plan also sets how many rows one query returns and, with the Analytic toolset, how long and how large a held result may be; the full MCP guide lists every plan. The rows your AI client receives count against your Data Realm allowance, the same pool your Excel and Sheets queries use, and MCP is measured the same way as your spreadsheet queries. 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 Oracle 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
• Come collegare Oracle a Fogli Google
• Tutte le guide MCP