Skip to content
Instalar en VS Code

Usar el servidor MCP de Oracle CPQ con Claude Code, Cursor y GitHub Copilot

Conecte su agente de IA al servidor MCP de Oracle alojado por CPQ DevKit™ para que pueda leer funciones BML, tablas de datos, la configuración de Commerce y más desde su sitio de Oracle CPQ.

En esta página

El servidor MCP de Oracle de CPQ DevKit™ es un servidor Model Context Protocol alojado en https://app.cpqdevkit.com/mcp/oracle. Ofrece a un agente de IA herramientas para consultar su sitio de Oracle CPQ: funciones de la biblioteca util de BML, tablas de datos, procesos y documentos de Commerce, partes, archivos, usuarios, paquetes de migración y más. Esta guía cubre Claude Code, Cursor y GitHub Copilot en VS Code.

Antes de empezar

  • Un sitio de Oracle CPQ Cloud con acceso a la API REST (BigMachines independiente o Fusion Applications). Las herramientas de la biblioteca BML requieren REST v19.
  • Un usuario de Oracle CPQ que pueda leer, a través de la API REST, los datos que usted quiere que vea el agente. Es recomendable usar un usuario de integración dedicado.
  • Una cuenta gratuita de CPQ DevKit™. Puede crearla desde la extensión de Oracle o en app.cpqdevkit.com.
  • La herramienta de IA que quiera usar: VS Code 1.109 o posterior con GitHub Copilot, Claude Code o Cursor.

La opción más sencilla: VS Code

Si trabaja en VS Code, no necesita configurar nada a mano:

  1. Instale CPQ DevKit™ for Oracle desde el VS Code Marketplace.
  2. Ejecute Sign In desde la paleta de comandos. Al iniciar sesión se crea su clave de API de CPQ DevKit™, que se guarda en el almacenamiento de secretos de VS Code.
  3. Configure su proyecto y agregue su entorno de Oracle CPQ. La extensión pasa al servidor MCP la dirección del sitio y las credenciales del entorno activo.

A continuación, VS Code muestra el servidor MCP CPQ DevKit™ for Oracle para GitHub Copilot. El servidor usa el entorno que esté activo cuando se inicia, así que reinícielo después de cambiar de entorno.

Esta configuración automática es para VS Code. Claude Code y Cursor mantienen sus propias listas de servidores MCP, así que agregue allí el servidor una vez, como se muestra a continuación.

Obtener una clave de API

Las configuraciones manuales que siguen requieren una clave de API de CPQ DevKit™:

  1. Inicie sesión en app.cpqdevkit.com.
  2. Cree una clave de API y cópiela. La clave completa se muestra solo una vez, así que guárdela en un lugar seguro, como su gestor de contraseñas.
  3. No incluya la clave en el control de versiones. Los ejemplos siguientes la leen de una variable de entorno.

Qué necesita el servidor

El servidor lee estos encabezados HTTP:

EncabezadoValor
X-API-KeySu clave de API de CPQ DevKit™
X-Oracle-CPQ-Base-URLLa dirección de su sitio, por ejemplo https://yoursite.bigmachines.com
X-Oracle-CPQ-UsernameNombre de usuario de Oracle CPQ (junto con X-Oracle-CPQ-Password)
X-Oracle-CPQ-PasswordContraseña de Oracle CPQ
X-Oracle-CPQ-Access-TokenOpcional: un token de acceso OAuth de Oracle CPQ, en lugar del nombre de usuario y la contraseña
X-Oracle-CPQ-Rest-Base-PathOpcional: la ruta base de REST, si su sitio no usa la predeterminada
X-Oracle-CPQ-Api-VersionOpcional: versión de la API REST, v19 de forma predeterminada

En cada solicitud, el servidor llama a su sitio de Oracle CPQ con la dirección del sitio y las credenciales que incluye esa misma solicitud. Los ejemplos siguientes usan estas variables de entorno. Defínalas en el perfil de su shell y luego reinicie su editor o terminal:

export CPQDEVKIT_API_KEY="cpqdk_..."
export ORACLE_CPQ_BASE_URL="https://yoursite.bigmachines.com"
export ORACLE_CPQ_USERNAME="integration.user"
export ORACLE_CPQ_PASSWORD="..."

Claude Code

Agregue el servidor con un solo comando. Ejecútelo en la carpeta de su proyecto:

claude mcp add --transport http cpq-devkit-oracle https://app.cpqdevkit.com/mcp/oracle \
  --header "X-API-Key: $CPQDEVKIT_API_KEY" \
  --header "X-Oracle-CPQ-Base-URL: $ORACLE_CPQ_BASE_URL" \
  --header "X-Oracle-CPQ-Username: $ORACLE_CPQ_USERNAME" \
  --header "X-Oracle-CPQ-Password: $ORACLE_CPQ_PASSWORD"

Su shell sustituye los valores, y Claude Code los guarda en su propia configuración, solo para este proyecto. Agregue --scope user para usar el servidor en todos sus proyectos.

Para compartir la configuración con su equipo sin compartir secretos, agregue en su lugar un archivo .mcp.json en la raíz del proyecto. Claude Code lee los valores de las variables de entorno de cada persona:

{
  "mcpServers": {
    "cpq-devkit-oracle": {
      "type": "http",
      "url": "https://app.cpqdevkit.com/mcp/oracle",
      "headers": {
        "X-API-Key": "${CPQDEVKIT_API_KEY}",
        "X-Oracle-CPQ-Base-URL": "${ORACLE_CPQ_BASE_URL}",
        "X-Oracle-CPQ-Username": "${ORACLE_CPQ_USERNAME}",
        "X-Oracle-CPQ-Password": "${ORACLE_CPQ_PASSWORD}"
      }
    }
  }
}

Ejecute claude mcp list para comprobar que el servidor está conectado, o escriba /mcp en una sesión de Claude Code. La primera vez, Claude Code le pide que apruebe los servidores definidos en el archivo .mcp.json de un proyecto.

Cursor

Cree .cursor/mcp.json en su proyecto, o ~/.cursor/mcp.json en su carpeta personal para usar el servidor en todos sus proyectos:

{
  "mcpServers": {
    "cpq-devkit-oracle": {
      "url": "https://app.cpqdevkit.com/mcp/oracle",
      "headers": {
        "X-API-Key": "${env:CPQDEVKIT_API_KEY}",
        "X-Oracle-CPQ-Base-URL": "${env:ORACLE_CPQ_BASE_URL}",
        "X-Oracle-CPQ-Username": "${env:ORACLE_CPQ_USERNAME}",
        "X-Oracle-CPQ-Password": "${env:ORACLE_CPQ_PASSWORD}"
      }
    }
  }
}

Cursor sustituye ${env:…} por los valores de su entorno, así que defina las variables en el perfil de su shell y reinicie Cursor. Luego abra Cursor Settings, busque la sección MCP y compruebe que cpq-devkit-oracle muestra sus herramientas.

GitHub Copilot en VS Code

La mayoría de los usuarios de VS Code no necesitan esta sección: la extensión configura el servidor por usted, como se describe arriba en “La opción más sencilla: VS Code”. Use una configuración manual si no quiere instalar la extensión o si desea conectarse a un sitio distinto del entorno activo de la extensión.

Cree .mcp.json en la raíz de su espacio de trabajo:

{
  "mcpServers": {
    "cpq-devkit-oracle": {
      "type": "http",
      "url": "https://app.cpqdevkit.com/mcp/oracle",
      "headers": {
        "X-API-Key": "${CPQDEVKIT_API_KEY}",
        "X-Oracle-CPQ-Base-URL": "${ORACLE_CPQ_BASE_URL}",
        "X-Oracle-CPQ-Username": "${ORACLE_CPQ_USERNAME}",
        "X-Oracle-CPQ-Password": "${ORACLE_CPQ_PASSWORD}"
      },
      "tools": ["*"]
    }
  }
}

Para una configuración que se aplique a todos los espacios de trabajo, ponga la misma entrada mcpServers en ~/.copilot/mcp-config.json. VS Code lee los valores ${NAME} del entorno en el que se inició VS Code, así que defina primero las variables y después inicie VS Code. Las configuraciones anteriores usaban .vscode/mcp.json con una clave servers; VS Code ahora recomienda .mcp.json para las configuraciones nuevas.

Para comprobar el servidor, abra el selector de herramientas en la vista de Chat y asegúrese de que el servidor y sus herramientas estén seleccionados.

Ejemplos de prompts

Estos prompts usan herramientas de lectura, que funcionan en el plan Free:

  1. "Enumere las tablas de datos de mi sitio de Oracle CPQ."
  2. "Muestre las filas de la tabla de datos PartPricing en las que el número de parte contiene SRV."
  3. "¿Qué listas de precios están configuradas en mi sitio?"

Estos prompts usan herramientas de agente, que requieren un plan Pro:

  1. "Enumere las funciones de la biblioteca util de BML de mi sitio de Oracle CPQ, agrupadas por carpeta."
  2. "Obtenga la función util calculateDiscount y revísela en busca de consultas BMQL dentro de bucles y de llamadas a funciones que no existen."

Sustituya los nombres de función y de tabla por otros de su sitio. Para comprobar antes la conexión, pida al agente que enumere sus tablas de datos: si responde con tablas de su sitio, el servidor está conectado. Con un plan Pro también puede preguntar: "¿A qué sitio de Oracle CPQ está conectado el servidor MCP de CPQ DevKit?" El agente responde con la dirección del sitio y el método de inicio de sesión, nunca con contraseñas ni tokens.

Qué requiere Pro

Las herramientas de lectura, como las de tablas de datos, partes, listas de precios, configuración de Commerce y usuarios, son gratuitas dentro de un límite mensual: 100 llamadas al mes en el plan Free y 10.000 en Pro. Cada herramienta que ejecuta su agente cuenta como una llamada; la conexión y el listado de herramientas no se cuentan.

Estas herramientas requieren un plan Pro:

  • Herramientas de escritura: create_transaction, perform_action, bulk_transaction_actions, generate_document, create_migration_package, export_migration_package, copy_migration_package, version_migration_package, migrate_package, create_snapshot, revert_to_snapshot, rollback_migration, create_full_backup, create_full_snapshot
  • Herramientas masivas: get_all_data_table_data, get_all_endpoint_data, get_openapi_spec, get_performance_logs, get_performance_log
  • Herramientas de agente: describe_environment, list_bml_functions, get_bml_function, list_bml_folders, list_integrations, review_bml. Permiten a su agente explorar y revisar funciones BML y describir el sitio conectado.

En el plan Free, el servidor responde a estas herramientas con un mensaje que indica que se requiere Pro, y no se envía nada a su sitio. Las herramientas de escritura modifican su sitio de Oracle CPQ, así que revise lo que el agente planea hacer antes de aprobar una llamada.

Solución de problemas

  • "Please provide an API key": falta el encabezado X-API-Key. Compruebe que la variable de entorno está definida en el entorno desde el que se inició su editor o terminal.
  • "Missing required Oracle CPQ headers": agregue X-Oracle-CPQ-Base-URL y, además, un nombre de usuario y una contraseña o bien un token de acceso.
  • "The provided API key is invalid or expired": cree una nueva clave en app.cpqdevkit.com y actualice su variable de entorno.
  • "Monthly usage limit reached": ha agotado las llamadas de su plan para este mes.

¿Preguntas o problemas? Escriba a sales@cpqdevkit.com. Consulte la política de privacidad para saber cómo tratamos los datos.