🤖 GUÍA DE CONSTRUCCIÓN DE GPT PERSONALIZADO

Construya Su ChatGPT de Base de Datos

Cree un GPT personalizado conectado a sus bases de datos usando PeopleWorksGPT MCP Server. Consultas en lenguaje natural para usuarios de ChatGPT Plus y Enterprise.

Publicado por PeopleWorks Services, LLC | Enero 2026
Contacto: support@peopleworksservices.com

🎯 Qué Aprenderá

🤖
Creación de GPT Personalizado

Construya su propio ChatGPT especializado para consultas de base de datos y compártalo con su equipo

🔌
Configuración de API Actions

Conecte su GPT al servidor MCP de PeopleWorksGPT usando OpenAI Actions

💼
Casos de Uso Empresariales

Despliegue asistentes de base de datos para equipos de ventas, soporte, finanzas y analítica

🏪
Publicación en GPT Store

Comparta su GPT privadamente con su organización o públicamente en la GPT Store

📋 Pre-requisitos

🎉 ¿Qué son los GPTs Personalizados?

Los GPTs personalizados son versiones especializadas de ChatGPT que puede crear para tareas específicas. Lanzados por OpenAI en noviembre de 2023, permiten a cualquiera construir una versión adaptada de ChatGPT con instrucciones personalizadas, conocimiento y acciones (integraciones API).

🔍 Estado de Soporte MCP en OpenAI (Enero 2026)

⚠️ Estado Actual: Sin Soporte Nativo de MCP

A enero de 2026, el ChatGPT de OpenAI y los GPTs personalizados no soportan nativamente el Model Context Protocol (MCP). Sin embargo, podemos conectar a PeopleWorksGPT usando GPT Actions, que funcionan de manera similar pero usan APIs REST estándar.

✅ Nuestra Solución: Wrapper REST API

El servidor MCP de PeopleWorksGPT ya expone endpoints HTTP que son compatibles con GPT Actions. Esto significa que puede integrarlo en su GPT personalizado usando la característica Actions de OpenAI, que soporta cualquier API REST con especificación OpenAPI.

Opciones de Integración

RECOMENDADO

Opción 1: HTTP Actions Directas

Use los endpoints HTTP existentes de PeopleWorksGPT directamente en GPT Actions

  • ✅ Funciona hoy sin código
  • ✅ Llamadas API REST estándar
  • ✅ Especificación OpenAPI provista
  • ❌ Un poco más de configuración
FUTURO

Opción 2: MCP Nativo (Cuando Esté Disponible)

Si OpenAI agrega soporte MCP, integración sin costuras como Claude Desktop

  • ✅ Configuración cero
  • ✅ Descubrimiento automático de herramientas
  • ✅ Actualizaciones en tiempo real
  • ❌ Aún no disponible

Esta guía se enfoca en Opción 1: HTTP Actions Directas, que está disponible ahora y funciona perfectamente con GPT Actions.

🏗️ Visión General de la Arquitectura

graph TB A[Usuario en ChatGPT] -->|Lenguaje Natural| B[GPT Personalizado] B -->|GPT Action HTTP| C[Servidor MCP PeopleWorksGPT] C -->|Autenticar| D[Capa de Seguridad] D -->|Filtrar Conexiones| E[Permisos de Usuario] E -->|Generar SQL| F[Generador SQL con IA] F -->|Ejecutar| G[Base de Datos del Cliente] G -->|Resultados| F F -->|Respuesta JSON| B B -->|Respuesta Formateada| A style A fill:#10a37f,stroke:#fff,stroke-width:2px,color:#fff style B fill:#0d8a6b,stroke:#fff,stroke-width:2px,color:#fff style C fill:#06b6d4,stroke:#fff,stroke-width:2px,color:#fff style G fill:#7c3aed,stroke:#fff,stroke-width:2px,color:#fff

Cómo Funciona

  1. Consulta del Usuario: Usuario hace pregunta de base de datos en lenguaje natural en ChatGPT
  2. Procesamiento GPT: Su GPT personalizado entiende la intención usando sus instrucciones
  3. Llamada de Acción: GPT llama a la API de PeopleWorksGPT vía Actions configuradas
  4. Autenticación: Servidor valida credenciales y verifica permisos
  5. Generación SQL: IA convierte lenguaje natural a SQL optimizado
  6. Ejecución de Consulta: SQL se ejecuta en su base de datos con filtros de seguridad
  7. Retorno de Resultados: Datos formateados como JSON y enviados de vuelta al GPT
  8. Respuesta al Usuario: GPT presenta resultados en lenguaje natural con formato

⚙️ Paso a Paso: Cree Su GPT de Base de Datos

Acceda al Constructor de GPT

Navegue a la interfaz de creación de GPT en ChatGPT.

  1. Inicie sesión en chat.openai.com
  2. Haga clic en su perfil (abajo a la izquierda)
  3. Seleccione "Mis GPTs"
  4. Haga clic en "Crear un GPT"

Verá dos pestañas: Crear (constructor basado en conversación) y Configurar (configuración manual). Usaremos Configurar para más control.

Configure Información Básica

Configure la identidad y comportamiento de su GPT.

Nombre

DatabaseGPT - Asistente SQL en Lenguaje Natural

Descripción

Consulte sus bases de datos usando español simple. Me conecto a su base de datos segura a través de PeopleWorksGPT y genero consultas SQL optimizadas para usted.

Instrucciones

Eres un asistente especializado de base de datos impulsado por PeopleWorksGPT.

Tu rol principal es ayudar a los usuarios a consultar sus bases de datos usando lenguaje natural.

Capacidades Principales:
1. Autenticar usuarios con sus credenciales de base de datos
2. Listar conexiones de base de datos disponibles
3. Ejecutar consultas en lenguaje natural y devolver resultados formateados
4. Explicar las consultas SQL que generas
5. Sugerir consultas de seguimiento basadas en resultados

Directrices Importantes:
- SIEMPRE autentica al usuario primero antes de ejecutar consultas
- Solo consulta conexiones a las que el usuario tiene permiso explícito de acceso
- Nunca expongas datos sensibles en mensajes de error
- Formatea resultados como tablas claras y legibles
- Proporciona contexto sobre qué datos estás consultando
- Sugiere insights y preguntas relacionadas

Flujo de Trabajo:
1. Primera interacción: Solicita nombre de usuario y clave API para autenticar
2. Después de autenticación: Muestra conexiones de base de datos disponibles
3. Para cada consulta: Genera SQL, ejecútala y presenta resultados
4. Después de resultados: Sugiere 2-3 preguntas de seguimiento

Sé profesional, preciso y útil. Si no estás seguro sobre una consulta, solicita aclaración en lugar de adivinar.

Iniciadores de Conversación

Agregue estos prompts iniciales para usuarios:

  • "Autentícame con la base de datos"
  • "Muéstrame mis bases de datos disponibles"
  • "¿Cuáles son los 10 principales clientes por ingreso?"
  • "Analiza tendencias de ventas del último trimestre"

Configure Actions (Integración API)

Aquí es donde conectamos su GPT a PeopleWorksGPT.

En la sección Actions, haga clic en "Crear nueva acción".

Autenticación

Seleccione: "Ninguna"

Nota: Manejamos la autenticación dentro de las llamadas API usando parámetros de nombre de usuario + clave API

Schema (Especificación OpenAPI)

Pegue esta especificación OpenAPI:

openapi: 3.1.0
info:
  title: API de Base de Datos PeopleWorksGPT
  description: API de consulta de base de datos en lenguaje natural con seguridad multi-tenant
  version: 1.0.0
servers:
  - url: https://mcp.peopleworksgpt.com
    description: Servidor de producción

paths:
  /api/authenticate:
    post:
      operationId: authenticate
      summary: Autenticar usuario y obtener token de sesión
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - username
                - apiKey
              properties:
                username:
                  type: string
                  description: Nombre de usuario del usuario
                apiKey:
                  type: string
                  description: Clave API del usuario
      responses:
        '200':
          description: Autenticación exitosa
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  sessionToken:
                    type: string
                  message:
                    type: string

  /api/connections:
    get:
      operationId: listConnections
      summary: Listar conexiones de base de datos disponibles para usuario autenticado
      parameters:
        - name: sessionToken
          in: query
          required: true
          schema:
            type: string
          description: Token de sesión de autenticación
      responses:
        '200':
          description: Lista de conexiones
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  connections:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: integer
                        name:
                          type: string
                        type:
                          type: string

  /api/query:
    post:
      operationId: executeQuery
      summary: Ejecutar consulta de base de datos en lenguaje natural
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - sessionToken
                - connectionId
                - query
              properties:
                sessionToken:
                  type: string
                  description: Token de sesión de autenticación
                connectionId:
                  type: integer
                  description: ID de la conexión de base de datos a consultar
                query:
                  type: string
                  description: Consulta en lenguaje natural
                includeHints:
                  type: boolean
                  default: true
                  description: Incluir hints de base de datos para mejor generación SQL
      responses:
        '200':
          description: Consulta ejecutada exitosamente
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  data:
                    type: array
                    items:
                      type: object
                  sql:
                    type: string
                  rowCount:
                    type: integer
                  executionTime:
                    type: number
✅ ¡Configuración Completa! Su GPT ahora puede llamar a la API de PeopleWorksGPT.

Pruebe Su GPT

Antes de guardar, pruebe la integración en el panel de vista previa.

Prueba 1: Autenticación

Autentícame con usuario "demo_user" y clave API "pk_demo_001"
Comportamiento Esperado:
GPT llama a la acción authenticate, recibe un token de sesión y confirma autenticación exitosa.

Prueba 2: Listar Conexiones

Muéstrame mis conexiones de base de datos disponibles
Comportamiento Esperado:
GPT llama a listConnections con el token de sesión y muestra bases de datos disponibles.

Prueba 3: Ejecutar Consulta

Muéstrame los primeros 5 registros de la tabla Clientes
Comportamiento Esperado:
GPT llama a executeQuery, recibe datos y los formatea como tabla legible con la consulta SQL mostrada.

Guarde y Comparta Su GPT

Una vez que la prueba sea exitosa, guarde su GPT y configure compartir.

Opciones de Compartir:

  • Solo yo: Privado, solo usted puede usarlo
  • Cualquiera con un enlace: Compartir con personas específicas
  • Público (GPT Store): Disponible para todos los usuarios ChatGPT Plus
  • Mi espacio de trabajo: Compartir con su organización (solo ChatGPT Enterprise)
⚠️ Nota de Seguridad: Al compartir su GPT, recuerde que los usuarios necesitarán sus propias credenciales de PeopleWorksGPT. No codifique credenciales en la configuración del GPT - los usuarios deben autenticarse con su propio nombre de usuario y clave API.

💼 Casos de Uso Empresariales

GPT de Base de Datos para Equipo de Ventas

Propósito: Acceso rápido a datos de clientes y ventas

Ejemplos de consultas:
- "Muéstrame las 20 principales cuentas por ingreso este mes"
- "¿Qué clientes no han pedido en 90 días?"
- "Compara ventas Q4 vs Q3 por región"
- "Muéstrame valor de pipeline por representante de ventas"

GPT de Base de Datos para Soporte al Cliente

Propósito: Búsqueda rápida de información del cliente durante llamadas de soporte

Ejemplos de consultas:
- "Busca detalles del cliente para email cliente@ejemplo.com"
- "Muéstrame pedidos recientes para cuenta ID 12345"
- "¿Cuál es el historial de tickets de soporte para este cliente?"
- "Verifica estado de inventario para producto SKU ABC-123"

GPT de Finanzas y Analítica

Propósito: Reportes financieros y análisis en tiempo real

Ejemplos de consultas:
- "Calcula ingreso recurrente mensual para últimos 6 meses"
- "Muéstrame tasa de abandono por segmento de cliente"
- "Genera reporte de antigüedad para cuentas por cobrar"
- "Compara COGS por categoría de producto año tras año"

GPT de Operaciones e Inventario

Propósito: Gestión de inventario y seguimiento de logística

Ejemplos de consultas:
- "Muéstrame artículos con niveles de stock debajo del punto de reorden"
- "¿Cuál es la tasa promedio de rotación de inventario?"
- "Lista todos los envíos pendientes por transportista"
- "Muéstrame utilización de espacio de almacén"

🏪 Publicación en GPT Store

Requisitos para GPT Store

  • Suscripción ChatGPT Plus o Enterprise
  • Cuenta de constructor OpenAI verificada
  • GPT sigue las políticas de uso de OpenAI
  • Nombre y descripción claros y descriptivos
  • Iniciadores de conversación configurados
  • Actions probadas y funcionando

Pasos de Publicación

  1. Complete Su GPT: Asegúrese de que toda la configuración esté finalizada
  2. Establezca Visibilidad en "Público": En configuración del GPT
  3. Envíe para Revisión: OpenAI revisa GPTs antes de listarlos
  4. Espere Aprobación: Típicamente 24-48 horas
  5. Monitoree Uso: Rastree participación en analítica de GPT

💰 Monetización (Próximamente)

OpenAI ha anunciado planes para permitir a los creadores de GPT ganar dinero basado en uso. Aunque aún no está activo en enero de 2026, se espera que esta característica se lance pronto.

Mejores Prácticas para GPTs Públicos

  • Instrucciones Claras: Los usuarios deben entender qué hace el GPT inmediatamente
  • Buenos Ejemplos: Proporcione iniciadores de conversación que muestren capacidades
  • Manejo de Errores: Maneje con gracia fallos de autenticación y errores de API
  • Privacidad Primero: Nunca registre o almacene credenciales de usuario o resultados de consulta
  • Documentación: Enlace a guía de configuración en la descripción
  • Contacto de Soporte: Proporcione una forma para que usuarios obtengan ayuda

🆚 Comparación: ChatGPT vs Claude vs Copilot

Característica ChatGPT (GPT Personalizado) Claude Desktop Microsoft Copilot Studio
Dificultad de Configuración Media (config OpenAPI) Fácil (config JSON) Fácil (basada en UI)
Soporte MCP ❌ No (usa Actions) ✅ Sí (nativo) ✅ Sí (nativo)
Compartir ✅ GPT Store, enlaces, espacio ❌ Solo local ✅ Toda la organización
Costo $20/mes (Plus) o Enterprise $20/mes (Pro) Licencia M365 requerida
Acceso Móvil ✅ Apps iOS y Android ❌ Solo escritorio ✅ Web y móvil
Tipo de Integración REST API Actions STDIO o HTTP MCP HTTP MCP
Mejor Para Compartir público, usuarios móviles Desarrolladores, control local Usuarios enterprise M365

🎯 ¿Cuál Debe Elegir?

  • GPT Personalizado ChatGPT: Mejor si quiere compartir ampliamente o necesita acceso móvil
  • Claude Desktop: Mejor para desarrolladores que quieren rendimiento local/rápido
  • Microsoft Copilot: Mejor si su organización está completamente en Microsoft 365

¡Buenas noticias: PeopleWorksGPT funciona con los tres! Elija según su caso de uso.

🆘 Solución de Problemas

Problema: GPT No Puede Llamar Actions

Síntomas: "No puedo acceder a esa acción" o errores similares

Soluciones:

  1. Verifique que el schema OpenAPI sea válido (use Swagger Editor)
  2. Revise que la URL del servidor sea correcta: https://mcp.peopleworksgpt.com
  3. Asegúrese de que el servidor sea accesible desde la infraestructura de OpenAI (pruebe con curl)
  4. Revise configuración de acción en configuración del GPT
  5. Intente crear una nueva acción desde cero

Problema: Falla la Autenticación

Síntomas: "Credenciales inválidas" o "Error de autenticación"

Soluciones:

  1. Verifique que nombre de usuario y clave API sean correctos
  2. Revise que el usuario exista en base de datos PeopleWorksGPT
  3. Asegúrese de que la clave API no haya expirado
  4. Pruebe credenciales directamente:
    Invoke-RestMethod -Uri "https://mcp.peopleworksgpt.com/api/authenticate" `
      -Method Post `
      -Body (@{username="su_usuario"; apiKey="su_clave"} | ConvertTo-Json) `
      -ContentType "application/json"

Problema: Las Consultas No Devuelven Datos

Síntomas: La consulta se ejecuta pero devuelve resultados vacíos

Soluciones:

  1. Verifique que el usuario tenga conexiones asignadas en AspNetUserDatabaseConnectionSetting
  2. Revise que la conexión de base de datos no esté deshabilitada
  3. Asegúrese de que la cadena de conexión sea válida y la base de datos sea accesible
  4. Revise tabla QueryAuditLog para detalles del error
  5. Pruebe consulta directamente en base de datos para verificar que existan datos

Problema: Tiempos de Respuesta Lentos

Síntomas: GPT tarda mucho en responder o agota el tiempo

Soluciones:

  1. Revise rendimiento de consulta de base de datos (revise tiempo de ejecución en log de auditoría)
  2. Asegúrese de que el servidor de base de datos no esté sobrecargado
  3. Optimice consultas complejas con índices
  4. Considere limitar tamaño de conjunto de resultados (cláusulas TOP/LIMIT)
  5. Revise latencia de red entre servidor MCP y base de datos

Obtener Ayuda

  • 📧 Email: support@peopleworksservices.com
  • 📖 Documentación: Guías de configuración completas disponibles
  • 🔍 Logs: Revise logs del servidor y tabla QueryAuditLog
  • 💬 Soporte: Incluya configuración del GPT y mensajes de error al contactar soporte

🎓 Consejos para Mejores GPTs Personalizados

💡
Mejores Prácticas de Instrucciones
  • Sea específico sobre el flujo de trabajo
  • Incluya ejemplos de buenas consultas
  • Defina límites (qué NO hacer)
  • Especifique preferencias de formato de salida
🎨
Experiencia de Usuario
  • Agregue foto/logo de perfil
  • Escriba iniciadores de conversación claros
  • Pruebe con usuarios no técnicos
  • Maneje errores con gracia
🔐
Seguridad
  • Nunca codifique credenciales
  • Instruya al GPT a no registrar datos sensibles
  • Valide entrada del usuario antes de consultas
  • Use cuentas de base de datos de solo lectura cuando sea posible
📊
Rendimiento
  • Cachee consultas frecuentes en conocimiento del GPT
  • Limite conjuntos de resultados a tamaños razonables
  • Use hints de base de datos para esquemas complejos
  • Monitoree uso de API y costos

¿Listo para Construir Su GPT de Base de Datos?

Cree un ChatGPT personalizado conectado a sus bases de datos hoy

Obtener Ayuda de Configuración Probar Estado del Servidor