Ir al contenido principal
Español— Elegir un idioma
Menú

Autenticación y seguridad

Lección 8 de 14 Actualizado el 3 de noviembre de 2026 Desarrollador
En esta página
  1. Quién necesita autenticarse
  2. Qué exige la especificación
  3. Cómo se registra ChatGPT como cliente
  4. El flujo orientado al usuario
  5. Declarar qué herramientas requieren una cuenta
  6. Verificar cada token
  7. Identificar a ChatGPT como cliente
  8. Principios de seguridad de OpenAI
  9. Pruebas de autenticación
  10. Puntos clave

Lección reescrita el 3 de noviembre de 2026 basándose en la documentación de plugins de Autenticación y Seguridad y privacidad de OpenAI. La versión anterior describía la autenticación mediante clave de API y una configuración auth en un manifiesto inexistente; ChatGPT no puede presentar una clave de API personalizada y, en su lugar, sigue el flujo de autorización definido en la especificación MCP (OAuth 2.1). Fuentes: Authentication · Security & Privacy.

Quién necesita autenticarse

Muchos servidores MCP pueden funcionar en modo de solo lectura de forma anónima. Sin embargo, cualquier servidor que exponga datos específicos de un usuario o realice operaciones de escritura debe autenticar al usuario. El contrato de autorización sigue la especificación MCP, que es idéntica en ChatGPT y Codex: un flujo OAuth 2.1 que involucra a tres actores.

  • El servidor de recursos: Tu servidor MCP, que expone herramientas y verifica el token de acceso en cada solicitud.
  • El servidor de autorización: Tu proveedor de identidad, que emite tokens y publica sus metadatos de descubrimiento.
  • El cliente: El host de OpenAI (ChatGPT o Codex), que actúa en nombre del usuario.

OpenAI recomienda encarecidamente confiar en un proveedor de identidad establecido en lugar de crear un sistema de autenticación desde cero; su documentación señala específicamente a Auth0 y Stytch.

Qué exige la especificación

Metadatos de recurso protegido. Tu servidor MCP debe publicar un documento, por ejemplo en https://your-mcp.example.com/.well-known/oauth-protected-resource, que contenga su identificador canónico (resource), sus servidores de autorización (authorization_servers) y, opcionalmente, los ámbitos compatibles (scopes_supported). Cuando llegue una solicitud sin una autenticación válida, el servidor debe responder con 401 Unauthorized y una cabecera que apunte a este documento:

HTTP/1.1 401 Unauthorized
WWW-Authenticate: Bearer resource_metadata="https://your-mcp.example.com/.well-known/oauth-protected-resource", scope="files:read"

Metadatos del servidor de autorización, ubicados en /.well-known/oauth-authorization-server o /.well-known/openid-configuration, deben incluir el emisor (issuer), los extremos de autorización y de token, y code_challenge_methods_supported conteniendo S256. Sin esto, el servidor MCP no es compatible, ya que PKCE es obligatorio.

El parámetro resource de extremo a extremo. ChatGPT añade resource=… a las solicitudes de autorización y de token. Tu servidor de autorización debe copiar este valor en el token (a menudo como la reclamación aud), y tu servidor MCP debe rechazar cualquier token que no se haya emitido específicamente para él.

Cómo se registra ChatGPT como cliente

Coexisten tres métodos. El método preferido es CIMD (Client ID Metadata Documents): ChatGPT utiliza la URL de un documento de metadatos alojado en HTTPS como client_id, que tu servidor de autorización lee. Habilita esto publicando client_id_metadata_document_supported: true. ChatGPT admite dos métodos de autenticación en el extremo de token: none (cliente público protegido por PKCE) y private_key_jwt (aserción firmada verificable con la clave pública publicada por ChatGPT). El registro dinámico de clientes (DCR) sigue siendo posible si publicas un registration_endpoint: ChatGPT se registra una vez por conexión y reutiliza ese cliente. Un cliente OAuth predefinido es la tercera opción.

En cuanto a las redirecciones, copia la URI exacta que se muestra en la página de gestión del servidor MCP en ChatGPT a la lista de permitidos de tu servidor de autorización. Esta URI depende del soporte para la identificación del emisor (RFC 9207, el parámetro iss devuelto en cada respuesta de autorización).

El flujo orientado al usuario

  1. ChatGPT lee los metadatos de recurso protegido de tu servidor.
  2. Se identifica como un cliente OAuth (mediante CIMD, DCR o un cliente predefinido).
  3. En la primera llamada a una herramienta protegida, inicia el flujo de código de autorización + PKCE: el usuario inicia sesión y consiente los ámbitos solicitados.
  4. ChatGPT canjea el código por un token y lo adjunta a las solicitudes MCP posteriores (Authorization: Bearer …).
  5. Tu servidor verifica el token en cada solicitud antes de ejecutar la herramienta.

Declarar qué herramientas requieren una cuenta

ChatGPT solo muestra su interfaz de vinculación de cuentas si tu servidor indica que OAuth está disponible o es necesario. Esto requiere ambas partes: metadatos y un error en tiempo de ejecución.

Primero, los metadatos: cada herramienta declara su política en _meta.securitySchemes. noauth significa que se puede llamar anónimamente, mientras que oauth2 requiere un token con los ámbitos indicados. Declarar ambos indica que la herramienta puede empezar sin una cuenta, pero la vinculación desbloquea más funcionalidad. Declara esto por herramienta, incluso si todo el servidor sigue la misma política.

server.registerTool(
  "create_doc",
  {
    title: "Crear documento",
    description: "Crea un nuevo documento en la cuenta del usuario.",
    inputSchema: { title: z.string().min(1) },
    _meta: { securitySchemes: [{ type: "oauth2", scopes: ["docs.write"] }] },
  },
  async ({ title }, extra) => {
    const token = await verifyToken(extra); // firma, iss, aud, exp, ámbitos
    if (!token) {
      return {
        isError: true,
        content: [{ type: "text", text: "Es necesario iniciar sesión para crear un documento." }],
        _meta: {
          "mcp/www_authenticate": [
            'Bearer resource_metadata="https://your-mcp.example.com/.well-known/oauth-protected-resource", error="insufficient_scope", error_description="Vincula tu cuenta para continuar"',
          ],
        },
      };
    }
    // … crear documento para token.sub
  }
);

Segundo, el error en tiempo de ejecución: cuando falta el token o no es válido, la herramienta debe devolver un resultado de error que contenga _meta["mcp/www_authenticate"] con los parámetros error y error_description. Este contenido es lo que realmente activa la interfaz de inicio de sesión. verifyToken es tu función de verificación; los SDK de MCP para Python y TypeScript proporcionan ayudantes para escribirla.

Verificar cada token

Una vez completado el flujo, ChatGPT adjunta el token tal cual a cada solicitud. Trátalo como no fiable y realiza tú mismo todas las verificaciones estándar de servidor de recursos: validación de la firma utilizando las claves publicadas por tu servidor de autorización (JWKS) y la reclamación iss; validez temporal (exp, nbf); audiencia (aud o resource) y ámbitos requeridos; seguido de tus propias reglas de negocio. En caso de fallo: devuelve 401 y una cabecera WWW-Authenticate, lo que reiniciará el flujo OAuth.

Identificar a ChatGPT como cliente

Para verificar que una solicitud proviene genuinamente de ChatGPT, existen dos métodos. ChatGPT presenta un certificado de cliente gestionado por OpenAI durante la conexión TLS (mTLS). Verifica que encadene con la autoridad intermedia publicada por OpenAI, que sea válido para la autenticación de cliente y que tenga el dnsName mtls.prod.connectors.openai.com. No fijes la huella digital del certificado hoja, ya que OpenAI puede rotarla. También puedes filtrar basándote en los rangos de direcciones IP publicados. mTLS autentica a ChatGPT; OAuth sigue autenticando al usuario.

ChatGPT no admite permisos de máquina a máquina (client credentials, cuentas de servicio, aserciones JWT bearer), claves de API personalizadas ni certificados mTLS proporcionados por el cliente.

Principios de seguridad de OpenAI

  • Mínimo privilegio: Solicita solo los ámbitos, el almacenamiento y el acceso a la red necesarios.
  • Consentimiento explícito: Los usuarios deben entender cuándo están vinculando una cuenta o concediendo acceso de escritura; utiliza confirmaciones del host para acciones destructivas.
  • Defensa en profundidad: Asume que las inyecciones de prompts y las entradas maliciosas llegarán a tu servidor. Valida todas las entradas en el lado del servidor, incluso las proporcionadas por el modelo, y mantén registros de auditoría.

En cuanto a los datos: incluye solo lo que la solicitud necesite en structuredContent, publica una política de retención, respeta las solicitudes de eliminación y enmascara los datos personales en los registros. En cuanto a la interfaz: el componente se ejecuta en un iframe aislado bajo una política de seguridad de contenido estricta, sin acceso a window.alert, window.prompt, window.confirm ni navigator.clipboard. En cuanto a las operaciones: realiza una revisión de seguridad antes del lanzamiento, alerta sobre fallos de autenticación repetidos y mantén las dependencias actualizadas.

Pruebas de autenticación

Comienza con un inquilino de desarrollo que emita tokens de corta duración, restringe el acceso a probadores de confianza antes de abrirlo al público y planifica la revocación, la actualización y los cambios de ámbito. Trata un token faltante o caducado como una falta de autenticación, proporcionando un mensaje de error útil. La configuración Auth en MCP Inspector te permite rastrear el flujo OAuth paso a paso para ver dónde se rompe.

Puntos clave

  • Datos privados o escrituras: OAuth 2.1 según la especificación MCP, con PKCE S256
  • El servidor publica metadatos de recurso protegido y responde con 401 + WWW-Authenticate
  • CIMD es el método de registro preferido; DCR y clientes predefinidos siguen siendo opciones
  • Interfaz de vinculación: securitySchemes por herramienta y un error que contenga _meta["mcp/www_authenticate"]
  • Verifica cada token en cada solicitud; mTLS identifica a ChatGPT, OAuth identifica al usuario