Autenticação e Segurança
Nesta página
Lição reescrita em 3 de novembro de 2026 com base na documentação de plugins Authentication e Security & Privacy da OpenAI. A versão anterior descrevia a autenticação por chave de API e uma configuração
authnum manifesto inexistente; o ChatGPT não pode apresentar uma chave de API personalizada e segue, em vez disso, o fluxo de autorização definido na especificação MCP (OAuth 2.1). Fontes: Authentication · Security & Privacy.
Quem precisa de autenticar
Muitos servidores MCP podem operar anonimamente em modo de leitura. No entanto, qualquer servidor que exponha dados específicos do utilizador ou execute operações de escrita deve autenticar o utilizador. O contrato de autorização segue a especificação MCP, que é idêntica no ChatGPT e no Codex: um fluxo OAuth 2.1 que envolve três intervenientes.
- O servidor de recursos: O seu servidor MCP, que expõe ferramentas e verifica o token de acesso em cada pedido.
- O servidor de autorização: O seu fornecedor de identidade, que emite tokens e publica os seus metadados de descoberta.
- O cliente: O anfitrião da OpenAI (ChatGPT ou Codex), a atuar em nome do utilizador.
A OpenAI recomenda vivamente confiar num fornecedor de identidade estabelecido em vez de construir a autenticação do zero; a sua documentação aponta especificamente para o Auth0 e o Stytch.
O que a especificação exige
Metadados de Recurso Protegido. O seu servidor MCP deve publicar um documento, por exemplo em https://your-mcp.example.com/.well-known/oauth-protected-resource, contendo o seu identificador canónico (resource), os seus servidores de autorização (authorization_servers) e, opcionalmente, os âmbitos suportados (scopes_supported). Quando chega um pedido sem autenticação válida, o servidor deve responder com 401 Unauthorized e um cabeçalho que aponta para 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"
Metadados do Servidor de Autorização, localizados em /.well-known/oauth-authorization-server ou /.well-known/openid-configuration, devem incluir o emissor (issuer), os endpoints de autorização e de token, e code_challenge_methods_supported contendo S256. Sem isto, o servidor MCP não é suportado, pois o PKCE é obrigatório.
O parâmetro resource de ponta a ponta. O ChatGPT adiciona resource=… aos pedidos de autorização e de token. O seu servidor de autorização deve copiar isto para o token (frequentemente como a reivindicação aud), e o seu servidor MCP deve rejeitar qualquer token não emitido especificamente para si.
Como o ChatGPT se regista como cliente
Três métodos coexistem. O método preferido é o CIMD (Client ID Metadata Documents): o ChatGPT utiliza o URL de um documento de metadados alojado em HTTPS como client_id, que o seu servidor de autorização lê. Ative isto publicando client_id_metadata_document_supported: true. O ChatGPT suporta dois métodos de autenticação no endpoint de token: none (cliente público protegido por PKCE) e private_key_jwt (asserção assinada verificável com a chave pública publicada pelo ChatGPT). O Registo Dinâmico de Cliente (DCR) permanece possível se publicar um registration_endpoint: o ChatGPT regista-se uma vez por ligação e reutiliza esse cliente. Um cliente OAuth predefinido é a terceira opção.
No que diz respeito aos redirecionamentos, copie o URI exato apresentado na página de gestão do servidor MCP no ChatGPT para a lista de permissões do seu servidor de autorização. Este URI depende do suporte para Identificação do Emissor (RFC 9207, o parâmetro iss devolvido em cada resposta de autorização).
O fluxo visível para o utilizador
- O ChatGPT lê os metadados de recurso protegido do seu servidor.
- Identifica-se como um cliente OAuth (via CIMD, DCR ou um cliente predefinido).
- Na primeira chamada a uma ferramenta protegida, inicia o fluxo authorization code + PKCE: o utilizador inicia sessão e consente nos âmbitos solicitados.
- O ChatGPT troca o código por um token e anexa-o aos pedidos MCP subsequentes (
Authorization: Bearer …). - O seu servidor verifica o token em cada pedido antes de executar a ferramenta.
Declarar quais as ferramentas que exigem uma conta
O ChatGPT só apresenta a sua interface de ligação de conta se o seu servidor sinalizar que o OAuth está disponível ou é necessário. Isto requer ambas as partes: metadados e um erro de tempo de execução.
Primeiro, os metadados: cada ferramenta declara a sua política em _meta.securitySchemes. noauth significa que pode ser chamada anonimamente, enquanto oauth2 requer um token com os âmbitos indicados. Declarar ambos sinaliza que a ferramenta pode começar sem uma conta, mas a ligação desbloqueia mais funcionalidades. Declare isto por ferramenta, mesmo que todo o servidor siga a mesma política.
server.registerTool(
"create_doc",
{
title: "Create Document",
description: "Creates a new document in the user's account.",
inputSchema: { title: z.string().min(1) },
_meta: { securitySchemes: [{ type: "oauth2", scopes: ["docs.write"] }] },
},
async ({ title }, extra) => {
const token = await verifyToken(extra); // signature, iss, aud, exp, scopes
if (!token) {
return {
isError: true,
content: [{ type: "text", text: "Login required to create a document." }],
_meta: {
"mcp/www_authenticate": [
'Bearer resource_metadata="https://your-mcp.example.com/.well-known/oauth-protected-resource", error="insufficient_scope", error_description="Link your account to continue"',
],
},
};
}
// … create document for token.sub
}
);
Segundo, o erro de tempo de execução: quando o token está em falta ou é inválido, a ferramenta deve devolver um resultado de erro contendo _meta["mcp/www_authenticate"] com os parâmetros error e error_description. Este conteúdo é o que realmente aciona a interface de início de sessão. verifyToken é a sua função de verificação; os SDKs MCP em Python e TypeScript fornecem auxiliares para a escrever.
Verificar cada token
Assim que o fluxo termina, o ChatGPT anexa o token tal como está a cada pedido. Trate-o como não confiável e realize todas as verificações padrão de servidor de recursos: validação da assinatura usando chaves publicadas pelo seu servidor de autorização (JWKS) e a reivindicação iss; validade temporal (exp, nbf); audiência (aud ou resource) e âmbitos necessários; seguido das suas próprias regras de negócio. Em caso de falha: devolva 401 e um cabeçalho WWW-Authenticate, o que reinicia o fluxo OAuth.
Identificar o ChatGPT como cliente
Para verificar se um pedido provém genuinamente do ChatGPT, existem dois métodos. O ChatGPT apresenta um certificado de cliente gerido pela OpenAI durante a ligação TLS (mTLS). Verifique se ele encadeia até à autoridade intermédia publicada pela OpenAI, se é válido para autenticação de cliente e se tem o dnsName mtls.prod.connectors.openai.com. Não fixe a impressão digital do certificado folha, pois a OpenAI pode rodá-la. Pode também filtrar com base em intervalos de endereços IP publicados. O mTLS autentica o ChatGPT; o OAuth continua a autenticar o utilizador.
O ChatGPT não suporta permissões máquina-a-máquina (client credentials, contas de serviço, asserções JWT bearer), chaves de API personalizadas ou certificados mTLS fornecidos pelo cliente.
Princípios de segurança da OpenAI
- Privilégio mínimo: Solicite apenas os âmbitos, armazenamento e acesso à rede necessários.
- Consentimento explícito: Os utilizadores devem compreender quando estão a ligar uma conta ou a conceder acesso de escrita; utilize confirmações do anfitrião para ações destrutivas.
- Defesa em profundidade: Assuma que injeções de prompts e entradas maliciosas chegarão ao seu servidor. Valide todas as entradas no lado do servidor, mesmo as fornecidas pelo modelo, e mantenha registos de auditoria.
No que diz respeito aos dados: inclua apenas o que o pedido necessita em structuredContent, publique uma política de retenção, honre os pedidos de eliminação e mascare dados pessoais nos registos. No que diz respeito à interface: o componente é executado num iframe isolado sob uma Política de Segurança de Conteúdo estrita, sem acesso a window.alert, window.prompt, window.confirm ou navigator.clipboard. No que diz respeito às operações: realize uma revisão de segurança antes do lançamento, alerte para falhas de autenticação repetidas e mantenha as dependências atualizadas.
Testar a autenticação
Comece com um locatário de desenvolvimento que emita tokens de curta duração, restrinja o acesso a testadores de confiança antes de abrir o acesso e planeie a revogação, atualização e alterações de âmbito. Trate um token em falta ou expirado como uma falta de autenticação, fornecendo uma mensagem de erro útil. As definições Auth no MCP Inspector permitem-lhe rastrear o fluxo OAuth passo a passo para ver onde este falha.
Pontos-chave
- Dados privados ou escritas: OAuth 2.1 conforme a especificação MCP, com PKCE
S256 - O servidor publica metadados de recurso protegido e responde com
401+WWW-Authenticate - O CIMD é o método de registo preferido; o DCR e clientes predefinidos permanecem como opções
- Interface de ligação:
securitySchemespor ferramenta e um erro contendo_meta["mcp/www_authenticate"] - Verifique cada token em cada pedido; o mTLS identifica o ChatGPT, o OAuth identifica o utilizador