Autenticazione e Sicurezza
In questa pagina
Lezione riscritta il 3 novembre 2026 sulla base della documentazione di OpenAI riguardante Authentication e Security & Privacy per i plugin. La versione precedente descriveva l’autenticazione tramite chiave API e una configurazione
authin un manifest inesistente; ChatGPT non può presentare una chiave API personalizzata e segue invece il flusso di autorizzazione definito nella specifica MCP (OAuth 2.1). Fonti: Authentication · Security & Privacy.
Chi deve autenticarsi
Molti server MCP possono operare in modalità sola lettura in modo anonimo. Tuttavia, qualsiasi server che espone dati specifici dell’utente o esegue operazioni di scrittura deve autenticare l’utente. Il contratto di autorizzazione segue la specifica MCP, che è identica in ChatGPT e Codex: un flusso OAuth 2.1 che coinvolge tre attori.
- Il resource server (server delle risorse): Il tuo server MCP, che espone gli strumenti e verifica il token di accesso su ogni richiesta.
- L’authorization server (server di autorizzazione): Il tuo identity provider, che emette i token e pubblica i relativi metadati di discovery.
- Il client: L’host OpenAI (ChatGPT o Codex), che agisce per conto dell’utente.
OpenAI raccomanda vivamente di affidarsi a un identity provider consolidato piuttosto che costruire l’autenticazione da zero; la loro documentazione cita specificamente Auth0 e Stytch.
Cosa richiede la specifica
Protected Resource Metadata. Il tuo server MCP deve pubblicare un documento, ad esempio all’indirizzo https://your-mcp.example.com/.well-known/oauth-protected-resource, contenente il suo identificativo canonico (resource), i suoi server di autorizzazione (authorization_servers) e, opzionalmente, gli ambiti supportati (scopes_supported). Quando arriva una richiesta senza un’autenticazione valida, il server deve rispondere con 401 Unauthorized e un header che punta a questo documento:
HTTP/1.1 401 Unauthorized
WWW-Authenticate: Bearer resource_metadata="https://your-mcp.example.com/.well-known/oauth-protected-resource", scope="files:read"
Authorization Server Metadata, situato in /.well-known/oauth-authorization-server o /.well-known/openid-configuration, deve includere l’issuer (issuer), gli endpoint di autorizzazione e token, e code_challenge_methods_supported contenente S256. Senza questo, il server MCP non è supportato, poiché PKCE è obbligatorio.
Il parametro resource end-to-end. ChatGPT aggiunge resource=… alle richieste di autorizzazione e token. Il tuo server di autorizzazione deve copiare questo valore nel token (spesso come claim aud), e il tuo server MCP deve rifiutare qualsiasi token non emesso specificamente per esso.
Come ChatGPT si registra come client
Coesistono tre metodi. Il metodo preferito è CIMD (Client ID Metadata Documents): ChatGPT utilizza l’URL di un documento di metadati ospitato su HTTPS come client_id, che il tuo server di autorizzazione legge. Abilita questa funzione pubblicando client_id_metadata_document_supported: true. ChatGPT supporta due metodi di autenticazione presso l’endpoint del token: none (client pubblico protetto da PKCE) e private_key_jwt (asserzione firmata verificabile con la chiave pubblica pubblicata da ChatGPT). La Dynamic Client Registration (DCR) rimane possibile se pubblichi un registration_endpoint: ChatGPT si registra una volta per connessione e riutilizza quel client. Un client OAuth predefinito è la terza opzione.
Per quanto riguarda i redirect, copia l’URI esatto visualizzato nella pagina di gestione del server MCP in ChatGPT nella allowlist del tuo server di autorizzazione. Questo URI dipende dal supporto per l’Issuer Identification (RFC 9207, il parametro iss restituito in ogni risposta di autorizzazione).
Il flusso visibile all’utente
- ChatGPT legge i metadati della risorsa protetta del tuo server.
- Si identifica come client OAuth (tramite CIMD, DCR o un client predefinito).
- Alla prima chiamata a uno strumento protetto, avvia il flusso authorization code + PKCE: l’utente effettua il login e acconsente agli ambiti richiesti.
- ChatGPT scambia il codice con un token e lo allega alle successive richieste MCP (
Authorization: Bearer …). - Il tuo server verifica il token su ogni richiesta prima di eseguire lo strumento.
Dichiarare quali strumenti richiedono un account
ChatGPT mostra la sua interfaccia di collegamento account solo se il tuo server segnala che OAuth è disponibile o richiesto. Questo richiede entrambe le parti: metadati ed un errore a runtime.
Innanzitutto, i metadati: ogni strumento dichiara la sua politica in _meta.securitySchemes. noauth significa chiamabile anonimamente, mentre oauth2 richiede un token con gli ambiti indicati. Dichiarare entrambi segnala che lo strumento può iniziare senza un account, ma il collegamento sblocca più funzionalità. Dichiara questo per ogni strumento, anche se l’intero server segue la stessa politica.
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
}
);
In secondo luogo, l’errore a runtime: quando il token manca o non è valido, lo strumento deve restituire un risultato di errore contenente _meta["mcp/www_authenticate"] con i parametri error e error_description. Questo contenuto è ciò che attiva effettivamente l’interfaccia di login. verifyToken è la tua funzione di verifica; gli SDK MCP per Python e TypeScript forniscono helper per scriverla.
Verificare ogni token
Una volta completato il flusso, ChatGPT allega il token così com’è a ogni richiesta. Trattalo come non attendibile ed esegui tu stesso tutte le verifiche standard del server delle risorse: validazione della firma utilizzando le chiavi pubblicate dal tuo server di autorizzazione (JWKS) e il claim iss; validità temporale (exp, nbf); audience (aud o resource) e ambiti richiesti; seguiti dalle tue regole di business. In caso di fallimento: restituisci 401 e un header WWW-Authenticate, che riavvia il flusso OAuth.
Identificare ChatGPT come client
Per verificare che una richiesta provenga genuinamente da ChatGPT, esistono due metodi. ChatGPT presenta un certificato client gestito da OpenAI durante la connessione TLS (mTLS). Verifica che faccia catena con l’autorità intermedia pubblicata da OpenAI, che sia valido per l’autenticazione client e che abbia il dnsName mtls.prod.connectors.openai.com. Non fissare (pin) l’impronta digitale del certificato foglia, poiché OpenAI potrebbe ruotarla. Puoi anche filtrare in base agli intervalli di indirizzi IP pubblicati. mTLS autentica ChatGPT; OAuth continua ad autenticare l’utente.
ChatGPT non supporta permessi machine-to-machine (client credentials, account di servizio, asserzioni JWT bearer), chiavi API personalizzate o certificati mTLS forniti dal client.
I principi di sicurezza di OpenAI
- Privilegio minimo: Richiedi solo gli ambiti, lo storage e l’accesso alla rete necessari.
- Consenso esplicito: Gli utenti devono capire quando stanno collegando un account o concedendo accesso in scrittura; usa le conferme dell’host per azioni distruttive.
- Difesa in profondità: Assume che injection di prompt e input malevoli raggiungeranno il tuo server. Valida tutti gli input lato server, anche quelli forniti dal modello, e mantieni log di audit.
Per quanto riguarda i dati: includi in structuredContent solo ciò di cui la richiesta ha bisogno, pubblica una politica di conservazione, onora le richieste di cancellazione e maschera i dati personali nei log. Per quanto riguarda l’interfaccia: il componente viene eseguito in un iframe isolato sotto una rigorosa Content Security Policy, senza accesso a window.alert, window.prompt, window.confirm o navigator.clipboard. Per quanto riguarda le operazioni: conduci una revisione di sicurezza prima del lancio, genera alert su ripetuti fallimenti di autenticazione e mantieni le dipendenze aggiornate.
Testare l’autenticazione
Inizia con un tenant di sviluppo che emetta token a breve durata, limita l’accesso a tester fidati prima di aprire a tutti e pianifica la revoca, il refresh e le modifiche agli ambiti. Tratta un token mancante o scaduto come una mancanza di autenticazione, fornendo un messaggio di errore utile. Le impostazioni Auth in MCP Inspector ti permettono di tracciare il flusso OAuth passo dopo passo per vedere dove si interrompe.
Punti chiave
- Dati privati o scritture: OAuth 2.1 secondo la specifica MCP, con PKCE
S256 - Il server pubblica i metadati della risorsa protetta e risponde con
401+WWW-Authenticate - CIMD è il metodo di registrazione preferito; DCR e client predefiniti rimangono opzioni
- Interfaccia di collegamento:
securitySchemesper strumento e un errore contenente_meta["mcp/www_authenticate"] - Verifica ogni token su ogni richiesta; mTLS identifica ChatGPT, OAuth identifica l’utente