Llegamos al último post de esta serie. Tenemos el entorno completo: VS Code, Git, Node.js, Java, SQLcl, la base de datos demovuelos con el dataset instalado y Claude Code autenticado. Ahora vamos a conectar los dos mundos: el asistente de IA con la base de datos Oracle.
El resultado va a ser un entorno donde podemos hacerle preguntas en lenguaje natural a nuestro esquema VUELOS directamente desde VS Code.
¿Qué es el MCP Server y para qué sirve?
MCP (Model Context Protocol) es un protocolo abierto creado por Anthropic que permite a los asistentes de IA conectarse con herramientas externas. Oracle implementó su propio MCP Server dentro de SQLcl, lo que significa que Claude Code puede hablar directamente con nuestra base de datos Oracle.
Sin MCP, Claude Code solo puede leer archivos y sugerir código. Con el MCP de SQLcl, Claude puede:
- Listar las conexiones guardadas en SQLcl
- Conectarse a nuestra ADB con un pedido en lenguaje natural
- Leer el esquema completo: tablas, columnas, tipos de datos
- Ejecutar consultas SQL y devolver los resultados
- Generar y ejecutar scripts PL/SQL sobre nuestra base de datos real
Paso 1 – Guardar la conexión con contraseña en SQLcl
El MCP Server necesita una conexión guardada con contraseña para poder autoconectarse cuando Claude Code lo necesita. Abrimos una terminal Command Prompt en VS Code y ejecutamos:
C:\tools\sqlcl\bin\sql.exe -cloudconfig C:\tools\wallet\Wallet_demovuelos.zip /nolog
El flag /nolog inicia SQLcl sin conectarse todavía. Una vez en el prompt SQL> ejecutamos:
SQL> conn -save vuelos_mcp -savepwd vuelos@demovuelos_high
Ingresamos la contraseña del usuario VUELOS cuando la solicita. Si la conexión es exitosa veremos:
Name: vuelos_mcp Connect String: demovuelos_high User: vuelos Password: ^^^^^^^^^^ Connected.
Nota: El flag -savepwd es obligatorio. Sin él el MCP Server no puede autoconectarse cuando Claude Code lo necesita.
Salimos:
sqlexit
Paso 2 – Localizar el ejecutable de Claude
El comando claude mcp add no está en el PATH de Windows por defecto. La solución es usar Git Bash y apuntar directamente al ejecutable de Claude Code dentro de la extensión de VS Code.
Abrimos una nueva terminal seleccionando Git Bash, hacemos clic en la flecha junto al + en la terminal y seleccionamos Git Bash.
Ejecutamos el siguiente comando para localizar el ejecutable, reemplazando <TuUsuario> con tu nombre de usuario de Windows:
bash> find /c/Users/TuUsuario -name "claude.exe" 2>/dev/null
La ruta va a tener un formato similar a:
/c/Users/Clari/.vscode/extensions/anthropic.claude-code-X.X.XX-win32-x64/resources/native-binary/claude.exe
Tomamos nota de esa ruta completa porque la vamos a usar en el siguiente paso.
Paso 3 – Registrar el MCP Server en Claude Code
Con la ruta del ejecutable en mano, ejecutamos el comando de registro en Git Bash. Reemplazamos la ruta con la que encontramos en el paso anterior y verificamos el número de versión de la extensión:
bash> "/c/Users/Clarisa/.vscode/extensions/anthropic.claude-code-2.1.121-win32-x64/resources/native-binary/claude.exe" mcp add --transport stdio --scope user sqlcl -- "C:\\tools\\sqlcl\\bin\\sql.exe" -mcp
Usamos la ruta completa a sql.exe para evitar el conflicto con JAVA_TOOL_OPTIONS que mencionamos en el Post 4.
Si el comando fue exitoso veremos:
Added stdio MCP server sqlcl with command: C:\tools\sqlcl\bin\sql.exe -mcp to user config File modified: C:\Users\Clari\.claude.json
Paso 4 – Primera consulta en lenguaje natural
Abrimos una nueva sesión en Claude Code haciendo clic en el ícono del asterisco ✳ en la barra lateral y luego en New session.
En el campo de chat escribimos:
conectate a vuelos_mcp y dime cuántas tablas tiene el esquema
Claude Code detecta el MCP Server y pide aprobación antes de ejecutar cada acción. Aprobamos cada diálogo con Yes:
Diálogo – Leer información del esquema:
Claude responde con el listado completo de tablas del esquema VUELOS:
En hora buena, tenemos el entorno funcionando. Claude Code se conectó a nuestra Oracle ADB, leyó el esquema VUELOS y respondió en lenguaje natural. A partir de aquí podemos hacer preguntas sobre los datos, pedir consultas SQL o generar código PL/SQL con contexto real de nuestra base de datos. 🙂
El entorno está completo
En esta serie de posts construimos paso a paso un entorno de desarrollo profesional que integra herramientas modernas con Oracle Database:
- VS Code como editor central con la extensión Claude Code
- Git para versionar scripts SQL y PL/SQL
- Node.js como base para ejecutar Claude Code
- Java JDK como motor de SQLcl permitiendo conectarse a la base de datos Oracle desde la terminal de VS Code
- Oracle Autonomous Database ATP con conexión segura mediante Wallet
- Autenticación de Claude Code
- Dataset VUELOS-RESERVAS de Café Database instalado desde la terminal
- Claude Code + SQLcl MCP Server para consultar el esquema en lenguaje natural
Todo el entorno corre en Windows, funciona con el Free Tier de Oracle Cloud y no requiere licencias adicionales más allá de la suscripción de Claude.
Lo que más me entusiasma de este stack es que cambia la forma en que interactuamos con la base de datos durante el desarrollo. Ya no es solo escribir SQL en un editor, es tener un asistente que conoce nuestro esquema real y nos ayuda a trabajar con él.
Esta serie sienta las bases para lo que viene: construir una aplicación Oracle APEX sobre el dataset VUELOS-RESERVAS usando todas estas herramientas juntas.
Te espero en la próxima serie. 🙂
