Servidor MCP

La extensión PostgreSQL puede registrar una definición de servidor del Protocolo de contexto de modelo (MCP) en hosts compatibles con IA. Ese registro permite al host detectar herramientas de PostgreSQL para la administración de conexiones, la exploración de esquemas, la ejecución de consultas y los flujos de trabajo relacionados sin pedirle que configure cada herramienta manualmente.

Use esta página cuando quiera comprender cómo funciona la compatibilidad con MCP en la extensión, qué hosts se admiten hoy en día y qué familias de herramientas están disponibles después del registro.

Prerequisites

Antes de confiar en el servidor MCP, asegúrese de que tiene:

  • La extensión PostgreSQL instalada en Visual Studio Code o Cursor.
  • Las funciones de Copilot/IA activadas en la extensión (pgsql.copilot.enable es true). El identificador de configuración mantiene su pgsql.copilot.* prefijo en ambos editores; la etiqueta aparece como IA en cursor.
  • Al menos un perfil de conexión guardado si desea que las herramientas de MCP se conecten rápidamente a un servidor.
  • Un host compatible que expone una API de registro de MCP.

Comprender cómo funciona el registro de MCP

La extensión registra automáticamente el servidor MCP cuando se cumplen todas las siguientes condiciones:

  1. El host expone una API de registro de MCP compatible.
  2. La extensión puede recuperar una dirección URL de servidor MCP válida y un token de portador de su servicio de lenguaje.
  3. La integración de Copilot está habilitada.

Hoy, la ruta de código admite explícitamente:

  • Visual Studio Code 1.102 y versiones posteriores a través de la API del proveedor de definición de servidor MCP
  • Cursor a través de la API MCP de registerServer Cursor

En Visual Studio Code, la extensión registra el servidor como MCP de PostgreSQL. En Cursor, registra el servidor como pgsql-mcp.

Importante

La extensión no ofrece actualmente un proceso de configuración manual mediante copiar y pegar para clientes independientes que esperan que introduzcas tú mismo la URL y el token de MCP. Si el cliente no admite la detección o el registro de nivel de host, use en su lugar los flujos de trabajo de IA integrados de la extensión.

Preparación de perfiles de conexión para herramientas de MCP

Los flujos de MCP más útiles dependen de la información de conexión guardada.

  1. Abra Conexiones e identidad y cree o actualice los perfiles de conexión que desea que use el host.
  2. Guarde las credenciales en las que el flujo de trabajo las requiera.
  3. Compruebe que puede conectarse a la base de datos de destino desde la extensión antes de confiar en la automatización basada en MCP.

Esto es importante porque las herramientas de MCP orientadas a la conexión resuelven el perfil de destino desde el almacén de conexiones de la extensión en lugar de desde una configuración de base de datos independiente en el host de IA.

Uso de herramientas de MCP en un host compatible

Una vez que el host descubre el servidor MCP de PostgreSQL, puede invocar las herramientas expuestas por la extensión.

Familia de herramientas En qué ayuda Uso típico
Enumerar perfiles de conexión Detección de perfiles guardados Buscar el perfil correcto antes de conectarse
Conexión a la base de datos postgreSQL Abrir una sesión de base de datos desde un perfil guardado Iniciar una tarea en el servidor o la base de datos correctos
Enumeración de bases de datos Enumerar bases de datos en el servidor conectado Cambio de contexto o inspección de bases de datos disponibles
Obtener objetos de base de datos Obtener el contexto del esquema Identificar tablas, vistas, funciones y otros objetos antes de formular preguntas de seguimiento
Ejecución de una consulta Ejecución de SQL orientado a lectura Inspección de datos o validación de supuestos
Modificar base de datos Ejecución de datos o cambios de esquema Aplicación de DDL o DML en flujos de trabajo que requieren acceso de escritura
Abrir script de SQL Creación de un script para su revisión Pasar del resultado del agente a un flujo de editor de consultas revisado por una persona
Plan de consulta Inspección de los datos del plan almacenados en caché Análisis de flujos de trabajo de rendimiento
Visualizar esquema de base de datos Mostrar una vista de esquema Comprenda las relaciones antes de escribir o modificar SQL
Obtener contexto del panel Obtener el contexto de la sesión activa del panel, incluidas las métricas y la configuración disponibles Detección de las métricas disponibles antes de solicitar datos de métricas
Obtener datos métricos del panel Captura de datos de series temporales almacenadas en caché por lotes desde un panel de servidor abierto Análisis de tendencias de rendimiento del servidor sin ejecutar consultas dinámicas

Tip

Para flujos de trabajo más seguros, comience con herramientas de detección como Perfiles de conexión de lista, Conexión a base de datos de PostgreSQL y Obtener objetos de base de datos antes de ejecutar consultas o modificaciones.

Elección entre MCP y las experiencias de IA integradas

Use el servidor MCP cuando el host admita la detección de MCP y quiera que la extensión exponga allí su superficie de herramientas de PostgreSQL.

Use las experiencias de extensión integradas cuando:

  • quieres chatear directamente con el @pgsql chat participant (solo en Visual Studio Code),
  • si quieres una automatización de varios pasos dentro de Agent mode (Visual Studio Code y Cursor), o
  • El host actual no muestra automáticamente el registro MCP de la extensión.

Solucionar problemas de disponibilidad de MCP

El host no muestra un servidor MCP de PostgreSQL

Confirme que está ejecutando un host compatible y que la integración de Copilot/AI está habilitada en la extensión. Si es necesario, vuelva a cargar la ventana después de iniciar sesión o cambiar la configuración de Copilot/AI.

Se omite el registro

La extensión omite el registro cuando no puede recuperar una dirección URL o token de MCP utilizable del servicio de lenguaje. Compruebe los registros de salida de la extensión si el host nunca descubre el servidor tras la recarga.

Una herramienta no se puede conectar a mi base de datos

Compruebe que el perfil de conexión de destino existe y que la extensión puede usarla directamente. Los flujos de MCP dependen del mismo almacén de conexiones y resolución de credenciales que el resto de la extensión.

Necesito un punto de conexión manual para otro cliente MCP.

La extensión no proporciona actualmente un flujo de trabajo de punto de conexión manual orientado al usuario para clientes MCP independientes. Use un host compatible o revierte a las experiencias de IA integradas documentadas en este conjunto de documentos.

Contenido relacionado

  • Last updated on