Come connettere un database Oracle a Claude/Cursor tramite MCP (Configurazione del server Oracle 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 Oracle MCP, in modo che il tuo strumento di intelligenza artificiale possa rispondere a domande in linguaggio naturale su dipendenti, reparti, ordini, dati finanziari e qualsiasi altro dato del database Oracle (join, aggregazioni, sintassi specifica del dialetto PL/SQL, esplorazione dello schema, report ad hoc), senza dover copiare e incollare file CSV esportati da SQL Developer, Toad o SQL*Plus. Che tu stia utilizzando Oracle 19c on-premise, Oracle Autonomous Database in OCI, Oracle XE su una workstation di sviluppo o un cluster RAC su Exadata, il server Oracle MCP li connette tutti al tuo client di intelligenza artificiale tramite un'unica chiave. Per saperne di più, visita QueryStreams.com e iscriviti gratuitamente per iniziare a porre al tuo strumento di intelligenza artificiale domande reali su Oracle.

Cosa offre Query Streams MCP per Oracle Database

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

Come funziona senza aprire le porte del firewall

L'agente di rete si installa una sola volta su qualsiasi host in grado di raggiungere il database Oracle tramite Oracle Net Services (TNS) e stabilisce un singolo collegamento TLS in uscita verso il cloud: nessun collegamento in entrata viene esposto e lo strumento di intelligenza artificiale non visualizza mai la stringa di connessione o il wallet di Oracle TNS. 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 Oracle” nel panorama open-source consegnano al tuo strumento di IA lo stesso TUTTE LE COLONNE DELLA SCHEDA La vista Oracle consegna a uno sconosciuto. Nomi delle colonne. Tipi di dati. Forse una chiave primaria. L'LLM è lasciato a indovinare cosa STATUS_CD = 'A' significa, cosa EMP_NM_TXT effettivamente negozi, o quale dei due ID_LAVORO la colonna è quella giusta su cui eseguire il join (e se le troncature dei nomi delle colonne a 30 caratteri precedenti alla versione 12c ne abbiano modificato il significato). Ecco perché la prima query SQL che la maggior parte degli LLM scrive su uno schema Oracle di base è errata, non perché l'LLM sia inadeguato, ma perché non dispone dei dati necessari per essere corretto, e il dizionario dati di Oracle è denso.

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 Oracle prima ancora che il client AI li richieda. Quando SI è abilitato su un connettore e un database, ogni strumento di schema chiamato dall'AI (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 uno schema tipico in stile Oracle HR (dipendenti, dipartimenti, Lavoro, luoghi, storia lavorativa) — 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, viene eseguita in sola lettura sui dati Oracle senza modificarne lo schema. 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 — "Mostrami i 5 dipendenti più pagati assunti nell'ultimo anno, indicando la retribuzione totale e il reparto di appartenenza." Senza Schema Intelligence, LLM effettua delle ipotesi con una sintassi tipica di PostgreSQL che Oracle rifiuta. Con essa, LLM conosce il dialetto.

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 Oracle: 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 database Oracle — vedere Scarica l'agente Query Streams.
3. Un connettore Oracle configurato contro l'agente — vedere quello esistente configurazione del connettore Guide per la stringa di connessione TNS. L'agente detiene la password dell'utente Oracle (o le credenziali del wallet, Kerberos o del servizio di directory); 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 Oracle, 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 Oracle", 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 Oracle insieme a tutto il resto che hai configurato.

Passaggio 3: Poni all'IA una domanda oracolare

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 Oracle 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, oracle, database oracle, database, enterprise, database autonomo

Meta Description: Connetti il database Oracle a Claude o Cursor tramite Query Streams MCP. Autonomo, RAC, Exadata, 19c. Solo in uscita, solo in lettura, configurazione in 5 minuti.