OpenRouter MCP: configurazione, chiamate ai modelli e compromessi reali

OpenRouter MCP è un server Model Context Protocol ospitato, pensato per cercare e provare modelli: consente a un agente di verificare prezzi aggiornati, benchmark, endpoint e documentazione prima di scegliere un modello. Non sostituisce però l'API di OpenRouter in produzione.

In breve: cosa cambia con OpenRouter MCP

Il server ufficiale è disponibile all'indirizzo https://mcp.openrouter.ai/mcp. Un client compatibile, come Claude Code, Cursor o Claude Desktop, può connettersi via HTTP remoto e richiamare gli strumenti OpenRouter direttamente nella conversazione. È utile per esplorare il catalogo e testare i modelli; per il lavoro da svolgere nell'applicazione o nell'account di un provider restano invece appropriati un'API di produzione o l'MCP del provider.

Se devi...	Usa...	Perché
Trovare un modello aggiornato in base a prezzo, contesto, modalità, benchmark o provider	OpenRouter MCP	Interroga dati live su catalogo ed endpoint
Eseguire un prompt sui modelli candidati	OpenRouter MCP	`send-message` prova gli slug dei modelli indicati e restituisce un ID di generazione
Portare le chiamate ai modelli nel tuo prodotto	OpenRouter API	L'applicazione mantiene il controllo su chiavi, retry, prompt e logging
Gestire un servizio o un account specifico di un provider	L'MCP ufficiale di quel provider	Può esporre capacità che OpenRouter non possiede
Generare immagini durante l'esplorazione	OpenRouter MCP, con cautela	`generate-image` esegue inferenza e può essere a pagamento

L'annuncio ufficiale di OpenRouter parla di dati live sui modelli, classifiche, prezzi, documentazione e inferenza di test. La documentazione MCP è il riferimento per endpoint, strumenti e comportamento dell'autenticazione.

Parti dal flusso di lavoro, non dall'URL del server

Il metodo più efficace segue quattro passaggi: scoprire, confrontare, testare, verificare. In questo modo la domanda “Qual è il modello migliore?” diventa una scelta basata su vincoli espliciti.

Scopri: cerca modelli che rispettino requisiti di attività, prezzo, contesto, modalità o provider. Per i dati aggiornati su catalogo e benchmark usa list-models e list-benchmarks.
Confronta: richiama list-model-endpoints per ogni candidato, così da vedere, dove disponibili, prezzo, latenza, throughput e informazioni sulle policy dei dati a livello di provider.
Testa: esegui lo stesso prompt con send-message e uno slug di modello specifico. Questa operazione può comportare un costo di inferenza.
Verifica: passa ogni ID di generazione a get-generation per ottenere conteggio token, costo e provider che ha servito la richiesta.

Puoi usare questo prompt in Claude Code o Cursor:

Usa OpenRouter MCP per trovare tre modelli adatti a estrarre dati strutturati da
documenti legali. Requisiti: almeno 100k di contesto, tool calling e il prezzo
di input disponibile più basso. Confronta provider e policy dei dati. Poi usa
send-message per eseguire questo identico prompt sui due candidati migliori:

"Estrai dal testo qui sotto ogni data di rinnovo contrattuale. Restituisci solo JSON
con un array chiamato renewals; ogni elemento deve contenere party, date ed evidence."

Dopo i test, usa get-generation per ogni ID di generazione e riporta il costo
effettivo e il provider che ha servito la richiesta. Non chiamare alcun modello
finché non avrò approvato i candidati.

Conviene richiedere l'approvazione prima del test: le ricerche nel catalogo sono in sola lettura, mentre send-message può generare un addebito di inferenza. Per valutazioni ripetibili, indica esplicitamente modello e provider; suffissi come :free, :floor, :nitro e :online esprimono preferenze di routing, dove disponibili, e non garanzie fisse di qualità.

Collegare il server remoto ufficiale

Non c'è nulla da installare in locale. Aggiungi l'endpoint remoto, completa l'OAuth nel browser e autorizza una chiave OpenRouter dedicata, separata dalle altre chiavi. Il valore predefinito documentato è una scadenza di 7 giorni e un tetto di spesa di $10, modificabile nella schermata di approvazione. OpenRouter documenta OAuth con PKCE: l'autorizzazione avviene nel browser, senza incollare una normale API key nella configurazione del client.

Claude Code

Esegui:

claude mcp add --transport http openrouter https://mcp.openrouter.ai/mcp
claude mcp login openrouter

Il primo comando registra il server HTTP remoto, il secondo avvia il flusso OAuth. In una sessione Claude Code puoi anche usare /mcp, come indicato nella documentazione MCP di Claude Code: seleziona il server OpenRouter e autenticalo.

Per verificare la connessione, prova una richiesta in sola lettura come: “Usa OpenRouter MCP per elencare due modelli attuali con almeno 128k di contesto e mostrare i rispettivi prezzi di input.”

Cursor

Aggiungi il server remoto a ~/.cursor/mcp.json:

{
  "mcpServers": {
    "openrouter": {
      "url": "https://mcp.openrouter.ai/mcp"
    }
  }
}

Se il server non compare, ricarica Cursor. L'autenticazione parte dalle impostazioni MCP di Cursor oppure al primo utilizzo di uno strumento. La CLI documentata è cursor-agent; verifica la voce con:

cursor-agent mcp list

La documentazione MCP di Cursor spiega la configurazione a livello utente e di progetto. Inserisci la voce al livello che ti serve e non includere una configurazione di autenticazione personale in un repository condiviso.

Claude Desktop e Claude Web

Se OpenRouter non è presente nella directory dei connettori di Claude, la guida alla connessione di OpenRouter indica di aggiungere un connettore remoto personalizzato:

Apri Settings > Connectors > Customize > Connectors.
Fai clic su +, quindi scegli Add custom connector.
Assegna il nome OpenRouter MCP.
Inserisci https://mcp.openrouter.ai/mcp come URL del server MCP remoto.
Lascia vuoti i campi OAuth, aggiungi il connettore, aprilo e fai clic su Connect.
Completa l'approvazione OpenRouter nel browser.

Alcune organizzazioni disabilitano i connettori personalizzati. Se l'opzione non è disponibile in un account gestito, rivolgiti all'amministratore. La documentazione MCP di Anthropic tratta i concetti del protocollo dal lato client.

Cosa puoi chiedergli senza rischi

La maggior parte degli strumenti ufficiali di OpenRouter MCP esegue consultazioni live. Per orientarsi è più utile raggrupparli in base agli effetti collaterali che imparare a memoria l'intero elenco.

Gruppo di strumenti	Esempi	Fatturazione o effetto collaterale
Catalogo e benchmark	`list-models`, `get-model`, `list-benchmarks`, `list-daily-model-rankings`	Consultazione in sola lettura
Endpoint e routing	`list-model-endpoints`, `list-providers`	Consultazione in sola lettura
Documentazione e account	`search-docs`, `get-credits`, `get-generation`	Consultazione in sola lettura
Inferenza di test	`send-message`	Chiamata al modello fatturabile
Esplorazione immagini	`generate-image`	Generazione fatturabile
Feedback	`send-feedback`	Scrive feedback per una delle tue generazioni

Per scegliere un modello, esplicita il criterio decisionale: “Trova il modello meno costoso con tool calling e finestra di contesto di 64k, poi mostra l'endpoint disponibile più veloce.” I filtri documentati includono prezzo, contesto minimo, famiglia del modello, autore, provider, modalità, parametri supportati, intervalli di benchmark, tasso di successo nel tool calling, disponibilità di zero data retention e regione.

Per un test controllato, specifica uno slug e rendi il prompt riproducibile:

Usa OpenRouter MCP send-message con il modello "openai/gpt-4o".
Invia esattamente questo messaggio utente e non aggiungere un system prompt:

"Restituisci un oggetto JSON con le chiavi title e risks. Analizza questa release note:
[incolla qui il testo]"

Mostrami la risposta e l'ID di generazione. Non eseguire altri modelli.

Lo slug è solo esemplificativo: usa quello che list-models conferma come disponibile. Per confronti verificabili, richiedi esplicitamente gli strumenti di consultazione, i valori restituiti e un ID di generazione, anziché accettare una raccomandazione di modello non supportata da dati.

OpenRouter MCP o MCP ufficiali dei provider?

OpenRouter MCP è un livello trasversale di analisi e test fra provider. Un MCP ufficiale del provider è in genere la scelta migliore quando l'azione riguarda il prodotto, l'account o il piano dati di quel provider.

Fattore decisionale	OpenRouter MCP	MCP ufficiale del provider
Scelta del modello	Confronta modelli di molti provider in un unico catalogo	Di norma è incentrato sui modelli o servizi di un solo provider
Prezzi e routing	Confronta prezzi, endpoint e opzioni di fallback fra provider	Usa l'account e le regole di routing del provider
Azioni di dominio	Limitato agli strumenti esposti da OpenRouter	Più adatto a file, progetti, job o azioni dell'account posseduti dal provider
Portabilità	Un solo endpoint remoto può servire diversi client MCP	Configurazione del client e ambito del provider variano in base al servizio
Confine delle credenziali	Chiave OAuth OpenRouter dedicata, con scadenza e limite	OAuth o credenziali API specifiche del provider
Traffico dell'applicazione in produzione	Continua a usare l'API OpenRouter	Usa l'API del provider o la sua integrazione di produzione supportata

Scegli OpenRouter MCP quando la domanda è “Quale modello o instradamento dovrei usare?”. Scegli un MCP first-party quando la domanda è “Cosa posso fare all'interno del servizio di questo provider?”. Se servono entrambe le capacità, possono essere collegati allo stesso agente.

I server MCP locali o multimodali creati dalla community costituiscono una categoria distinta. La pagina Works With OpenRouter di OpenRouter descrive un server per vari client e flussi di lavoro con testo, immagini, audio e video; richiede una API key OpenRouter e crediti, e non è il servizio ospitato ufficiale su mcp.openrouter.ai.

I limiti da considerare in un progetto reale

Aspetto	Cosa succede	Azione consigliata
Integrazione nell'applicazione	MCP serve alla ricerca e ai test in fase di sviluppo, non al normale traffico del prodotto	Richiama `https://openrouter.ai/api/v1` direttamente dal codice di produzione
Fatturazione dell'inferenza	`send-message` e `generate-image` possono consumare il budget della chiave MCP; gli strumenti di consultazione non effettuano chiamate di inferenza	Mantieni il limite predefinito finché non hai testato, richiedi approvazione e verifica ogni ID di generazione
Dati sorgente e prompt	La documentazione MCP di OpenRouter afferma che il codice sorgente non viene inviato per impostazione predefinita, ma il contenuto incluso esplicitamente in una chiamata fatturabile può raggiungere il modello selezionato	Invia solo il testo necessario al test
Selezione del provider	Il routing dinamico può cambiare il provider che serve la richiesta al variare di prezzo, latenza o disponibilità	Blocca un provider per valutazioni riproducibili o per una policy dei dati obbligatoria

“@OpenRouter’s ori harness/cli has been a blessing... p.s: also thanks for openrouter mcp for quickly checking up info on models 🫰” — @CodewithP, X, a proposito di un caso d'uso per la consultazione di informazioni sui modelli.

Il cookbook MCP di OpenRouter tratta anche il caso opposto: usare i modelli OpenRouter come backend LLM per altri server di strumenti MCP, invece di collegare un client di coding a OpenRouter MCP.

Come risolvere il primo errore di chiamata

Il server compare, ma gli strumenti non si autenticano. Ripeti il passaggio OAuth specifico del client. La chiave dedicata ha una durata documentata di 7 giorni e può essere disconnessa anche dalla dashboard OpenRouter.
Non si apre alcuna finestra del browser. Usa claude mcp login openrouter, l'azione /mcp di Claude Code, le impostazioni MCP di Cursor oppure il pulsante Connect del connettore Claude.
Claude Desktop non offre l'opzione per un connettore personalizzato. Verifica se un amministratore dell'organizzazione ha disabilitato i connettori personalizzati.
La risposta su un modello sembra non aggiornata. Chiedi esplicitamente list-models, list-benchmarks o list-model-endpoints e richiedi i valori restituiti.
Un test costa più del previsto o passa da un provider diverso. Verifica il relativo ID di generazione con get-generation, quindi blocca un provider esplicito per la successiva esecuzione riproducibile.

FAQ

OpenRouter MCP può chiamare qualsiasi modello OpenRouter?

Può testare gli slug dei modelli esposti dal catalogo live, nei limiti di disponibilità, capacità, credito e vincoli di routing. Verifica prima lo slug con list-models.

Posso usare OpenRouter MCP contemporaneamente con Claude Desktop, Cursor e Claude Code?

Puoi aggiungere lo stesso endpoint ufficiale in ogni client, seguendo la configurazione e il flusso di autenticazione documentati per ciascuno. Evita di inserire credenziali personali nelle configurazioni condivise.

Dovrei installare invece un pacchetto community `openrouter-mcp`?

Solo se ti serve un flusso stdio locale o un'orchestrazione multimodale che il server ospitato ufficiale non offre. Prima verifica repository, gestione delle credenziali, origine del pacchetto e stato della manutenzione.

Inizia con una query del catalogo in sola lettura; autorizza una chiamata di inferenza controllata solo dopo aver chiarito modello, route e limite di spesa.