Agregar un servidor MCP personalizado

Conectar un servidor MCP personalizado

Conecta tu servidor de Model Context Protocol (MCP) a ChatGPT como complemento. ChatGPT admite tanto las herramientas de lectura como las de escritura de tu servidor.

Conéctate solo a servidores MCP de confianza. Un servidor que no sea de confianza podría acceder a la información que compartes al usar una app, robarla o engañar a ChatGPT para que use herramientas de formas imprevistas, incluso para modificar o eliminar datos. Antes de conectar un servidor, consulta la información sobre inyecciones de prompts y otros riesgos.

Cómo usarlo

• Acceso: usa ChatGPT en la web. Al agregar y usar servidores MCP personalizados, se aplican los permisos del Espacio de trabajo y las restricciones de seguridad, incluido el Modo restringido.

• Agregar un servidor MCP como complemento:

  1. Ve a Complementos de ChatGPT.
  2. Selecciona el botón con el signo más y luego Agregar servidor MCP personalizado.
  3. Ingresa un nombre y, si quieres, una descripción. En Conexión, ingresa la URL del servidor o selecciona Túnel para usar un túnel MCP seguro.
  4. Configura la autenticación del servidor.
  5. Lee la advertencia sobre los riesgos y selecciona Entiendo y quiero continuar.
  6. Selecciona Crear como complemento.
  • Protocolos MCP compatibles: SSE y HTTP con streaming.
  • Las opciones de autenticación incluyen OAuth, Sin autenticación y OAuth o sin autenticación.
    • Si proporcionas credenciales estáticas para OAuth, ChatGPT las usará. De lo contrario, ChatGPT puede usar documentos de metadatos de ID de cliente (CIMD) si el servidor de autorización indica que los admite y quien crea la app elige CIMD. CIMD admite el intercambio de tokens para clientes públicos (none) y el intercambio de tokens mediante una aserción firmada del cliente (private_key_jwt). ChatGPT también puede usar DCR si está configurado.
    • La autenticación mixta admite tanto el uso de OAuth como el acceso sin autenticación. Las API de inicialización y de listado de herramientas funcionan sin autenticación. Cada herramienta usa OAuth o funciona sin autenticación según los esquemas de seguridad definidos en sus metadatos.
  • Encontrarás el complemento entre tus complementos personales o en el Espacio de trabajo donde lo creaste. Instálalo antes de usarlo en una conversación.

• Administrar herramientas: en la configuración de apps, cada app tiene una página de detalles. Desde ahí puedes activar o desactivar herramientas y actualizar las apps para obtener del servidor MCP las nuevas herramientas, descripciones e instrucciones.

• Usar apps en conversaciones: escribe @ en el campo del prompt y selecciona el complemento que instalaste. Puedes usar complementos MCP personalizados junto con otras apps, según los permisos del Espacio de trabajo y las restricciones de seguridad. Es posible que tengas que probar distintas formas de redactar el prompt para que ChatGPT llame a las herramientas correctas. Por ejemplo:

  • Indica exactamente qué debe usar: Usa la herramienta “update_record” de la app “Acme CRM” para …. Cuando sea necesario, incluye la etiqueta del servidor y el nombre de la herramienta.
  • Descarta otras opciones para evitar ambigüedades: “No uses la navegación integrada ni otras herramientas. Usa solo la app Acme CRM”.
  • Distingue entre herramientas similares: “Da preferencia a Calendar.create_event para las reuniones. No uses Reminders.create_task para programarlas”.
  • Especifica el formato de entrada y el orden de las llamadas: “Primero llama a Repo.read_file con { path: "…" }. Luego llama a Repo.write_file con el contenido modificado. No llames a otras herramientas”.
  • Si varias apps tienen funciones similares, indica tus preferencias desde el principio (por ejemplo, “Usa CompanyDB como fuente de datos de referencia. Consulta otras fuentes solo si CompanyDB no devuelve resultados”).
  • Los servidores MCP personalizados no requieren las herramientas search/fetch. Todas las herramientas que expone tu app, incluidas las que realizan acciones de escritura, están disponibles según la configuración de confirmación.
  • Consulta Uso de herramientas y Redacción de prompts para obtener más orientación.
  • Mejora las descripciones de las herramientas para facilitar su selección: en tu servidor MCP, elige nombres y descripciones que indiquen qué hace cada herramienta. Incluye indicaciones como “Usa esta herramienta cuando…”, señala los casos no permitidos y los casos límite, y agrega descripciones de los parámetros y sus valores enumerados. Esto ayuda al modelo a elegir la herramienta adecuada entre varias similares y a evitar las herramientas integradas cuando no corresponda.
  • Agrega instrucciones al servidor para orientar el uso conjunto de las herramientas: usa el campo instructions de MCP para dar indicaciones que se apliquen a todo el servidor, como el orden obligatorio de las llamadas, los límites de solicitudes compartidos o las relaciones entre herramientas. Asegúrate de que los primeros 512 caracteres se entiendan por sí solos.

  Ejemplos:

  Programa una reunión de 30 minutos para mañana a las 3 p. m. (hora del Pacífico)
  con alice@example.com y bob@example.com usando “Calendar.create_event”.
  No uses ninguna otra herramienta para programar la reunión.

  Crea un pull request con “GitHub.open_pull_request” desde la rama “feat-retry”
  hacia “main”, con el título “Add retry logic” y el cuerpo “…”.
  No hagas push directamente a main.

• Revisar y confirmar llamadas a herramientas:

  • Revisa los datos JSON de las llamadas a herramientas para verificar que sean correctos y diagnosticar problemas. Despliega los detalles de cada llamada para ver el contenido JSON completo de la entrada y la salida de la herramienta.
  • De forma predeterminada, las acciones de escritura requieren confirmación. Revisa con cuidado los datos que se enviarán a la herramienta para asegurarte de que la acción de escritura haga lo que esperas. ¡Una acción de escritura incorrecta puede destruir, alterar o compartir datos por accidente!
  • Detección de herramientas de solo lectura: ChatGPT respeta la anotación readOnlyHint de la herramienta (consulta las anotaciones de herramientas MCP). Si una herramienta no tiene esta anotación, ChatGPT trata sus llamadas como acciones de escritura.
  • Puedes elegir que ChatGPT recuerde tu decisión de aprobar o rechazar las llamadas a una herramienta durante el resto de la conversación. Permite que ChatGPT recuerde tu aprobación solo si conoces la app y confías en que pueda realizar otras acciones de escritura sin tu aprobación. En cada conversación nueva, ChatGPT volverá a pedirte confirmación. Si recargas la misma conversación, también volverá a pedirte confirmación en los turnos siguientes.