Inicio rápido: Uso de SQL MCP Server con Fundición de IA de Azure

Este inicio rápido muestra cómo conectar un servidor SQL MCP implementado a Fundición de IA de Azure mediante una herramienta MCP personalizada. Puede probar todo usando el Chat Playground con un modelo de chat, como GPT-5-mini, sin necesidad de codificación.

Prerrequisitos

Servidor MCP de SQL implementado

Necesita una instancia de SQL MCP Server implementada en Azure Container Apps con entrada pública habilitada. Si aún no tiene una implementación, complete primero el Deploy SQL MCP Server en Azure Container Apps inicio rápido.

Necesita la dirección URL del punto de conexión de MCP desde esa implementación (por ejemplo, ).

proyecto de Fundición de IA de Azure

Necesita acceso a Fundición de IA de Azure con un proyecto existente y acceso a un modelo de chat (por ejemplo, GPT-5-mini).

Paso 1: Acceso Fundición de IA de Azure

1. Navegue a .
2. En el encabezado, seleccione la nueva experiencia Foundry (conmutador de vista previa).
3. Seleccione el proyecto Foundry.
4. En el panel de navegación izquierdo, seleccione Parque infantil.

Paso 2: Crear o abrir un agente

1. Seleccione un agente existente o cree uno nuevo.
2. En la configuración del agente, busque la sección Herramientas en el panel izquierdo.

Paso 3: Agregar una herramienta de protocolo de contexto de modelo

1. En la sección Herramientas , seleccione Agregar (el botón puede mostrar una lista desplegable o un icono).
2. Seleccione Agregar una nueva herramienta en la lista desplegable.
3. El cuadro de diálogo Seleccionar una herramienta se abre con tres pestañas: Configurado, Catálogo y Personalizado.
4. Seleccione la pestaña Personalizado en la parte superior.
5. Seleccione Protocolo de contexto de modelo (MCP) en las opciones disponibles.
6. Seleccione Crear para continuar.

Paso 4: Configurar la conexión de MCP

Aparece el cuadro de diálogo Agregar protocolo de contexto del modelo. Rellene la información siguiente:

Nombre (requerido)

Escriba un nombre descriptivo: .

Punto de conexión remoto del servidor MCP (obligatorio)

Escriba la dirección URL del servidor MCP: https://<your-container-app-url>/mcp (desde la implementación de Azure Container Apps).

Autenticación (necesaria)

Seleccione Sin autenticar en la lista desplegable.

Seleccione Conectar para agregar la herramienta.

Paso 5: Configuración de instrucciones del agente

En la sección Instrucciones de la parte superior de la configuración del agente, agregue o reemplace el texto por:

You are a helpful product catalog assistant. When answering questions about products, use the products-mcp tool to query the database. 

The Products entity contains:
- Id: Product identifier
- Name: Product name
- Inventory: Units in stock
- Price: Retail price in USD
- Cost: Store cost in USD

Always use the schema discovery tool first to understand the schema, then use the query tool to retrieve data.

Paso 6: Probar el agente

Pruebe estas indicaciones en el chat:

Ejemplo 1: Detección de esquemas

What tables or entities are available in the database?

El agente debe llamar a una herramienta de detección de esquemas (como ) para ver la estructura de entidades Products.

Ejemplo 2: Consulta simple

List all products

El agente debe llamar a una herramienta de consulta (como ) para recuperar los datos del producto.

Ejemplo 3: Consulta de precios

Show me products under $20

El agente debe consultar los productos donde el precio 20.

Ejemplo 4: Comprobación de inventario

Which products are low in stock (less than 30 units)?

El agente debe filtrar el inventario 30.

Ejemplo 5: Consulta compleja

What's the most expensive product, and how many do we have in stock?

El agente debe:

• Consulta de productos ordenados por Precio descendente
• Devolver el resultado superior con recuento de inventario

Paso 7: Ver llamadas a herramientas

En el área de juegos de chat, puede ver las llamadas a herramientas y sus argumentos o respuestas:

• Herramienta denominada: la herramienta de detección o consulta de esquemas usada
• Argumentos: los parámetros pasados (filtros, campos, etc.)
• Respuesta: los datos devueltos de la base de datos SQL

Solución de problemas

La herramienta no aparece en Fundición de IA de Azure

• Compruebe que la dirección URL de MCP es correcta y accesible.
• Compruebe que la aplicación de contenedor se está ejecutando con el acceso público habilitado (consulte la guía de supervisión).
• Pruebe el punto de conexión mediante curl o un cliente REST para comprobar la accesibilidad.

Las llamadas a herramientas requieren aprobación

• En la configuración de la herramienta MCP, asegúrese de que Requerir aprobación esté establecida en .

Agente que no usa la herramienta

• Compruebe que el mensaje del sistema incluye instrucciones claras sobre cuándo usar la herramienta.
• Intente formular preguntas más específicas relacionadas con los datos de productos.

Para ver los problemas de implementación, consulte la sección troubleshooting en la guía de implementación de Azure Container Apps.

Contenido relacionado

• Información general sobre SQL MCP Server
• Herramientas de manipulación de datos en SQL MCP Server
• Adición de descripciones semánticas a SQL MCP Server