Conecta Oracle con Claude mediante MCP.

MCP · Oráculo para Claude

Preguntar Claude Acerca de su base de datos Oracle, en inglés sencillo

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.

Aproximadamente 10 minutos Claude, ChatGPT, Cursor + 11 clientes más Los datos permanecen en tu red. Solo lectura, siempre

Lo que obtendrás al final

Un Claude que puede responder preguntas sobre su base de datos Oracle con consultas en tiempo real de solo lectura, explicar el significado de las columnas y responder cuando usted solicite más información, sin necesidad de acceder a la base de datos ni modificar el firewall: el agente, que ya se encuentra dentro de su red, ejecuta la consulta SQL y devuelve únicamente las filas. Una vez configurado el agente, conectar Claude tarda aproximadamente 90 segundos si se siente cómodo con una pantalla de configuración. Así:

Claude ChatGPT Cursor Código Claude VS Code Windsurf Gemini CLI JetBrains Códice+5 másSolo lectura

¿Qué hay en CLIENTES ¿En mi base de datos Oracle? Muéstrame algunas filas y dime qué significa cada columna.

qs_get_table_schema qs_run_query inteligencia de esquema

Primero examiné la estructura de la tabla y luego ejecuté una consulta de solo lectura a través de su agente. Aquí están tres de las filas de CLIENTES:

customer_id	nombre_cliente	ciudad
1042	Comerciantes de Northwind	Seattle
1057	Equipamiento alpino	Denver
1063	Alimentos del puerto	Halifax

customer_id identifica la fila. nombre_cliente y ciudad están descritos en tu modelo de Inteligencia Semántica, así que puedo filtrarlos por nombre.

¿Cuáles tres? ciudad Los valores generaron la mayor parte de los ingresos este trimestre, ¿y cómo se compara eso con el trimestre pasado? ¿Hay algo que deba investigar?

qs_obtener_relaciones qs_run_query qs_run_query

Me uní CLIENTES a pedidos Se basó en la relación que encontró Semantic Intelligence y luego ejecutó una agregación para cada trimestre. Ambas consultas fueron de solo lectura y devolvieron 3 filas cada una:

ciudad	Este trimestre	último trimestre	Cambiar
Denver	184,200	133,900	+38%
Seattle	171,650	168,400	+2%
Halifax	96,300	129,700	-26%

Denver En resumen: los ingresos aumentaron un 38% con prácticamente el mismo número de clientes, por lo que el valor medio de los pedidos también subió. Halifax Cayó un 26%, y la caída se debe a dos clientes que realizaban pedidos todos los meses el trimestre pasado y ninguno este trimestre; conviene llamar antes de que termine el mes. Seattle se mantiene estable. ¿Quiere los nombres de las dos cuentas de Halifax?

SELECCIONAR solamente, verificado por el Agente registrado en la pestaña Actividad de MCP Se obtuvieron 9 filas en 3 consultas. Misma conexión en 14 clientes MCP.

¿Prefieres no conectar ningún cliente de IA? En el plan de negocios, 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 almacena tus datos en un servidor que tú o tu equipo administran. Claude, en cambio, se ejecuta en un navegador o terminal y no tiene conocimiento de ello. El método habitual consiste en pegar un esquema en el chat y esperar que funcione, o bien proporcionar tu contraseña de Oracle a un servidor MCP de código abierto. Query Streams funciona de manera diferente: el agente que ya está integrado en tu base de datos Oracle ejecuta las consultas SQL que escribe Claude, en modo de solo lectura, y el servidor MCP, entretanto, verifica quién realiza la consulta, qué acciones puede realizar y con qué frecuencia. Claude obtiene respuestas, pero nunca credenciales.

Lo que necesitarás

Una cuenta de Query Streams

MCP está disponible en todos los planes, incluido el gratuito. El plan gratuito permite una clave o una aplicación conectada, que es todo lo que necesita esta guía. Regístrese en mi.querystreams.com.

Oracle se conectó a través del Agente

El agente se instaló donde se encuentra su base de datos Oracle, con la conexión agregada en Data Agents. ¿Aún no ha terminado? Conecta Oracle primero; tarda unos diez minutos.

MCP activado para ti

Los creadores, propietarios y administradores lo tienen desde el principio. Todos los demás necesitan un administrador para cambiar el MCP cambiar junto a su nombre debajo Cuenta → Control de accesoHasta entonces, la página de MCP indica que "MCP está deshabilitado para su cuenta".

Un cliente de 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.

Configúralo en cuatro pasos.

1. Abra MCP en el portal

   Iniciar sesión en mi.querystreams.com y abierto Transmisiones → En vivo → MCPLa página tiene cuatro pestañas: Conexiones, Context, Herramientas y, para los administradores, Actividad. Check the Semantic Intelligence panel on Conexiones 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.

   MCP abierto

   ¿Ves el mensaje "MCP está desactivado para tu cuenta"? Su organización tiene MCP pero su usuario está desactivado. Un administrador lo activa con el MCP cambia al lado de tu nombre debajo Cuenta → Control de accesoLos creadores, propietarios y administradores están presentes desde el principio.

2. Elige cómo te conectarás

   Hay dos maneras de entrar, y ambas terminan en el mismo lugar:

   Aplicaciones de chat · sin clave

   claude.ai, Claude Desktop, ChatGPT

   In claude.ai and Claude Desktop, open the Query Streams listing in Anthropic’s Connectors Directory, click Conectar 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 Aprobar conexión. Nothing to copy. The connection appears on the Conexiones tab and can be revoked there.

   Herramientas para desarrolladores · una clave

   Claude Code, Cursor, VS Code y amigos

   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 Nombre de la clave, Leer y Run queries ticked, an Vencimiento (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.

   Ambos métodos utilizan los mismos tres permisos, que usted elige en la pantalla de consentimiento o en la clave:

   Leer

   Lista los conectores, explora tablas y columnas, lee tus consultas guardadas y reglas de alerta. Nunca devuelve datos de filas.

   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.

   Analizar

   Perfila tablas, descubre relaciones y programa una ejecución de Inteligencia Semántica. Consume créditos de Nova AI y datos asignados, por lo que la pantalla de consentimiento nunca lo marca previamente.

   ¿Perdiste la llave? It is listed on the Conexiones tab: Reveal full key shows it again and Copiar clave completa Copia el permiso. Revoca el permiso allí si se pierde un portátil; todos los clientes que lo utilicen fallarán en su siguiente llamada, en unos cinco minutos.

3. Conectar con Claude

   Selecciona la receta del Claude que vayas a usar. La dirección del servidor es la misma en todas partes: https://mcp.querystreams.com/mcp.

   Claude en la web, Claude para escritorio y móvil Sin llave

   1. Abre el Query Streams listing in Anthropic’s Connectors Directory and click Conectar. In Desktop it then sits under + → Conectores.
   2. Fallback, if your organization hides directory connectors: Settings → Connectors → Add custom connector, name Flujos de consulta, URL https://mcp.querystreams.com/mcp, OAuth fields empty, Añadir; then in a chat + → Flujos de consulta → Conectar.
   3. Se abre una pestaña de Flujos de consulta. Inicie sesión si se le solicita, seleccione la organización y revise. Leer y Run queries, opcionalmente Limitar a conectores específicosy haga clic Aprobar conexión.
   4. De vuelta en Claude verá "Conectado a flujos de consulta". La primera vez que Claude usa una herramienta, pregunta; elija Permitir siempre.

   Si lo agregas manualmente en Claude Desktop, usa Configuración → Conectores → Agregar, no el chat interno Agregar mercado Opción que requiere un repositorio Git. Los conectores se sincronizan con tu cuenta de Claude, por lo que las aplicaciones móviles y de escritorio los detectan automáticamente. Los nombres de los menús son de Anthropic y pueden cambiarse.

   Código Claude llave

   One command, with your key from the Connections tab:

   Terminal

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

   Eso escribe el proyecto actual. .mcp.json. Agregar --ámbito usuario Tener Query Streams en cada proyecto. Ejecutar /mcp Dentro de Claude Code para verlo conectado.

   Cursor llave

   Abrir Configuración del cursor → MCP → Agregar nuevo servidor MCPo editar .cursor/mcp.json en la raíz de tu espacio de trabajo:

   .cursor/mcp.json

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

   Reiniciar Cursor o ejecutar MCP: Reiniciar servidores; a flujos de consultas El distintivo aparece en la barra de estado del MCP.

   ¿Usar otra cosa? The Portal’s Connect an AI client guide tiene recetas listas para pegar para ChatGPT, VS Code, Visual Studio, OpenAI Codex CLI, Gemini CLI, Windsurf, Zed, Cline, Continue.dev y JetBrains AI, además de una Pegar y combinar herramienta que deja caer el flujos de consultas Entrada en un archivo de configuración que ya tienes. Cualquier cliente que utilice MCP a través de HTTP funciona: servidor https://mcp.querystreams.com/mcp, encabezado Clave X-MCP (un Autorización: Portador El encabezado con la misma clave también funciona).

4. Haz tu primera pregunta

   Empieza con algo cuya respuesta ya conozcas, para que puedas ver cómo Claude elige la herramienta adecuada. Tres que funcionan bien con tu base de datos Oracle:

   “¿Qué datos tengo en mi base de datos Oracle?”

   Claude enumera las tablas que puede ver, te indica cuáles tienen inteligencia semántica y te pregunta qué quieres consultar.

   “Muéstrame diez filas de CLIENTES y explícame cada columna.”

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

   “¿Cuántas filas tiene CLIENTES por ciudad? ¿Qué ciudad tiene la mayor cantidad?”

   Claude escribe la cláusula GROUP BY en el dialecto de Oracle, la ejecuta y responde con una frase que incluye una pequeña tabla. Continúa la conversación en el mismo chat; así se mantiene el contexto.

   Para confirmar el cableado, pregunte “¿Qué conectores de Query Streams tengo?”Claude llama qs_list_connectors, the Portal guide’s Check the connection step says Conectado, and the key or app on the Conexiones tab shows its Último uso time within a few seconds.

Lo que Claude puede hacer una vez conectado

Your AI client sees the Query Streams tools; it picks the right one for your question. The Portal’s Herramientas pestaña 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 pestaña: text cell limit, schema view, result size, analysis defaults and held results.

Por qué la inteligencia semántica es importante aquí

Cada respuesta que recibe Claude está etiquetada con la procedencia de la estructura, y Claude ajusta el grado de confianza que deposita en lo que ve.

Si una base de datos importa, ejecute la Inteligencia Semántica en ella una vez. Nova → Inteligencia. El Conexiones La pestaña muestra un panel de cobertura por conector. Cómo funciona la inteligencia semántica.

Lo que permiten los planes

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. Consulte la página de precios. para las asignaciones.

Mantenerlo seguro

Buenos pasos a seguir

• Guarda las consultas que consideres canónicas En el Generador de consultas, Claude recurre primero a las consultas guardadas, por lo que "clientes activos" significa lo que tu equipo diga que significa.
• Utiliza un proyecto Claude con Query Streams adjunto y coloque sus reglas de la casa en sus instrucciones: qué base de datos Oracle usar por defecto, qué consultas guardadas son las definiciones oficiales.
• Grant Analyze cuando se buscan respuestas más profundas. Analizar una columna antes de filtrarla marca la diferencia entre adivinar un código de estado y usar el correcto. Consume créditos de Nova AI, así que permanecerá desactivado hasta que lo indiques.
• Solicita un gráfico. claude.ai dibuja gráficos a partir de las filas que recibe Claude.

Cuando algo no funciona

Preguntas que hace la gente

Guías relacionadas

• Conecta Microsoft SQL Server con Claude mediante MCP.
• Conecta PostgreSQL con Claude usando MCP.
• Conecta MySQL con Claude usando MCP.
• Conecta Microsoft Access con Claude mediante MCP.
• Conectar Query Streams a Claude mediante MCP: configuración, permisos y solución de problemas
• Cómo conectar Oracle con Google Sheets
• Todas las guías MCP