# Server MCP per agenti AI | ProxyJam Collega Claude, Cursor e altri client MCP al tuo account ProxyJam: cerca offerte, ordina e rinnova proxy, vedi il traffico. Nessun acquisto senza il tuo sì. - Canonical: https://proxyjam.com/it/mcp/ - Updated: 2026-10-14 - Language: it Con il server MCP di ProxyJam, Claude, Cursor e gli altri client AI hanno a disposizione 16 strumenti sul tuo account: cercano offerte, ordinano e rinnovano proxy, controllano traffico e saldo. Sei tu ad accedere e a decidere cosa può fare l’agente, e tutto ciò che costa denaro ti mostra prima un’anteprima e aspetta il tuo sì. Ti serve un account ProxyJam. La maggior parte dei client accede con quello; gli altri usano una chiave API. Il server in sé è gratuito: paghi solo i proxy che il tuo agente ordina. ProxyJam mette a disposizione un server MCP remoto all’indirizzo `https://proxyjam.com/mcp`, su Streamable HTTP. Il tuo client AI accede con il tuo account ProxyJam (OAuth) oppure invia una chiave API, e ottiene 16 strumenti: nove in lettura, quattro che modificano le impostazioni e tre che spendono denaro — e questi tre si fermano all’anteprima finché non confermi. ## Sedici strumenti, sei compiti ### Esplora il catalogo list_offers cerca tra le offerte disponibili in tempo reale per tipo, paese, regione e città, e restituisce ogni tariffa con il suo prezzo. È l’unica fonte degli ID delle offerte, quindi ogni acquisto parte da qui. ### Ordina proxy create_proxy_order acquista da 1 a 50 proxy da un’offerta. La prima chiamata mostra soltanto il prezzo e il tuo saldo; l’ordine parte quando confermi. ### Rinnova e aggiungi traffico extend_proxy_period rinnova un proxy per un altro periodo e buy_proxy_bandwidth aggiunge traffico a un proxy statico. Entrambi mostrano prima un’anteprima e addebitano solo quando confermi. ### Controlla ordini e traffico I tuoi ordini con i dati di connessione, e il traffico consumato da ogni singolo proxy o da tutti insieme. Sola lettura: l’agente può chiamarli tutte le volte che vuole, senza rischi. ### Tieni d’occhio i conti I saldi del wallet in ogni valuta e lo storico completo delle transazioni, una per volta o una pagina intera alla volta. Anche questo in sola lettura. ### Modifica le impostazioni Passa un proxy da HTTP a SOCKS5 e viceversa, sostituisci la sua whitelist IP, attiva o disattiva il rinnovo automatico o aggiornane lo stato. Nessuna di queste operazioni costa nulla, ma un client che ha effettuato l’accesso può eseguirle solo se gli hai consentito di spendere. ## I soldi si muovono solo quando lo dici tu 1. **Di base si legge e basta.** Quando un client accede, ProxyJam ti mostra che cosa richiede. La lettura di ordini, wallet e catalogo viene concessa in blocco — e negli ordini ci sono i nomi utente e le password dei tuoi proxy. La spesa è una casella a parte, *Consenti spese dal mio wallet*, che all’inizio non è spuntata e copre anche le modifiche gratuite alle impostazioni. 2. **Prima l’anteprima.** `create_proxy_order`, `extend_proxy_period` e `buy_proxy_bandwidth` partono con `confirm=false`: restituiscono l’offerta, il prezzo e il tuo saldo, senza addebitare nulla. 3. **Prima il tuo sì, poi l’addebito.** L’agente richiama lo strumento con `confirm=true` solo dopo che hai approvato l’anteprima. Le regole per l’agente nei prompt qui sotto lo dicono senza giri di parole. 4. **Nessun doppio addebito.** La chiamata di conferma riusa la `idempotency_key` dell’anteprima, quindi una richiesta ripetuta restituisce il primo risultato invece di acquistare due volte. Ogni nuovo acquisto riceve una nuova chiave. 5. **Una chiave API apre l’intero account.** Le chiavi create nella dashboard non prevedono permessi più ristretti: danno accesso a tutto, lettura e spesa comprese. Dove il tuo client lo consente, accedi con l’account, e a ogni chiave che usi dai una data di scadenza. 6. **L’accesso finisce quando lo revochi.** Un client che ha effettuato l’accesso compare in *App collegate* nelle [impostazioni della dashboard](https://app.proxyjam.com/settings); revocalo da lì e smette di funzionare entro cinque minuti. Cambiare la password o uscire da tutte le sessioni revoca ogni connessione. Una chiave smette di funzionare non appena la elimini nella pagina [Chiavi API](https://app.proxyjam.com/apikey). ## Collegati in tre passaggi 1. **Aggiungi il server al tuo client** Scegli il tuo client qui sopra e copiane la configurazione. L’indirizzo è `https://proxyjam.com/mcp`. 2. **Accedi e scegli cosa può fare** Il client apre ProxyJam nel browser. Accedi, leggi che cosa ti chiede e spunta *Consenti spese dal mio wallet* solo se l’agente deve ordinare, rinnovare o modificare le impostazioni. Ogni approvazione sostituisce la precedente, quindi puoi ricollegarti in seguito per cambiare idea. Un client che non supporta l’accesso usa invece una [chiave API](https://app.proxyjam.com/apikey): inizia con `pj_` e viene mostrata una sola volta. 3. **Inizia con un prompt in sola lettura** Come prima cosa chiedi le offerte — lo stesso catalogo in tempo reale della pagina dei [proxy residenziali statici (ISP)](/it/isp-proxies/). Così hai la prova che la connessione funziona, e l’agente ottiene gli ID delle offerte che gli servono per tutto il resto. Poi prova i prompt qui sotto. ## Scegli il tuo client Scegline uno per vedere come collegarlo. La maggior parte dei client accede con il tuo account ProxyJam; VS Code e l’OpenAI Agents SDK usano una chiave API, quindi sostituisci pj_... con la tua. ### Claude (Anthropic) claude.ai, Claude Desktop e le app mobile condividono un unico elenco di connettori. 1. In Claude, apri le impostazioni dei connettori e aggiungi un connettore personalizzato. 2. Chiamalo ProxyJam e incolla https://proxyjam.com/mcp come indirizzo del server. 3. Avvia la connessione, accedi a ProxyJam e approva. Guida completa nella documentazione: https://docs.proxyjam.com/mcp-server#claude-ai-and-claude-desktop ### Claude Code (Anthropic) Eseguilo in un terminale, poi digita /mcp in Claude Code, scegli proxyjam ed effettua l’accesso. Aggiungi --scope user per usarlo in tutti i progetti. ``` claude mcp add --transport http proxyjam https://proxyjam.com/mcp ``` Guida completa nella documentazione: https://docs.proxyjam.com/mcp-server#claude-code ### Cursor (Anysphere) ~/.cursor/mcp.json, oppure .cursor/mcp.json in un progetto. Cursor ti chiede di accedere alla prima connessione. ``` { "mcpServers": { "proxyjam": { "url": "https://proxyjam.com/mcp" } } } ``` Guida completa nella documentazione: https://docs.proxyjam.com/mcp-server#cursor ### ChatGPT (OpenAI) ChatGPT si identifica e apre la pagina di accesso di ProxyJam. 1. Nelle impostazioni di ChatGPT, attiva la modalità sviluppatore e crea un connettore personalizzato. 2. Inserisci https://proxyjam.com/mcp come URL e scegli OAuth. 3. Accedi a ProxyJam e approva. Guida completa nella documentazione: https://docs.proxyjam.com/mcp-server#chatgpt ### Codex CLI (OpenAI) Eseguili entrambi in un terminale; il secondo apre il browser per l’accesso. ``` codex mcp add proxyjam --url https://proxyjam.com/mcp codex mcp login proxyjam ``` Guida completa nella documentazione: https://docs.proxyjam.com/mcp-server#codex-cli ### VS Code (Microsoft) .vscode/mcp.json, con una chiave API. VS Code chiede la chiave una sola volta e la conserva in modo sicuro. ``` { "inputs": [ { "type": "promptString", "id": "proxyjam-api-key", "description": "ProxyJam API key", "password": true } ], "servers": { "proxyjam": { "type": "http", "url": "https://proxyjam.com/mcp", "headers": { "X-API-Key": "${input:proxyjam-api-key}" } } } } ``` Guida completa nella documentazione: https://docs.proxyjam.com/mcp-server#vs-code ### Gemini CLI (Google) Eseguilo in un terminale, poi digita /mcp auth proxyjam in Gemini CLI per accedere. ``` gemini mcp add --transport http proxyjam https://proxyjam.com/mcp ``` Guida completa nella documentazione: https://docs.proxyjam.com/mcp-server#gemini-cli ### OpenAI Agents SDK (OpenAI) Python, con una chiave API. pip install openai-agents. ``` import asyncio from agents import Agent, Runner from agents.mcp import MCPServerStreamableHttp async def main(): async with MCPServerStreamableHttp( name="ProxyJam", params={ "url": "https://proxyjam.com/mcp", "headers": {"X-API-Key": "pj_..."}, }, ) as proxyjam: agent = Agent( name="Assistant", instructions="Use the ProxyJam tools. Never confirm " "a purchase without the user's yes.", mcp_servers=[proxyjam], ) result = await Runner.run( agent, "List ISP proxy offers in the United States.") print(result.final_output) asyncio.run(main()) ``` Guida completa nella documentazione: https://docs.proxyjam.com/mcp-server#openai-agents-sdk ### FastMCP (Prefect) Python. pip install fastmcp. Effettua l’accesso tramite il browser ed elenca gli strumenti. ``` import asyncio from fastmcp import Client async def main(): # auth="oauth" opens your browser to sign in to ProxyJam. async with Client("https://proxyjam.com/mcp", auth="oauth") as client: for tool in await client.list_tools(): print(tool.name) asyncio.run(main()) ``` Guida completa nella documentazione: https://docs.proxyjam.com/mcp-server#generic-fastmcp-client-python ## Prompt da provare Una volta collegato il server, incollane uno nella chat del tuo agente. Sostituisci ORDER_ID con il numero di un ordine preso dalla dashboard. L’ultima scheda è un insieme di regole da tenere nelle istruzioni del tuo agente. ### Trova un proxy Sola lettura. Una prima chiamata sicura. Usando il server MCP di ProxyJam, elenca le offerte di proxy residenziali statici (ISP) negli Stati Uniti con i relativi prezzi mensili. Non ordinare nulla. ### Acquisto con anteprima Addebita solo dopo il tuo sì. Ordina con ProxyJam un proxy residenziale statico (ISP) negli Stati Uniti per un mese. Prima mostrami l’anteprima — l’offerta, il prezzo e il saldo del mio wallet — e aspetta il mio sì esplicito prima di confermare. Quando confermi, riusa la stessa chiave di idempotenza. ### Rinnovo Proroga un ordine, prima l’anteprima. Rinnova di un mese il mio ordine ProxyJam ORDER_ID. Mostrami l’anteprima con il prezzo e il mio saldo, e aspetta il mio sì prima di confermare. ### Consumi e saldo Ordini, traffico e soldi in un’unica risposta. Mostrami i miei proxy ProxyJam attivi con le date di scadenza e il traffico consumato da ciascuno, poi il saldo del mio wallet in USD e le mie ultime 10 transazioni. ### Impostazioni Modifiche che non costano nulla. Per il mio ordine ProxyJam ORDER_ID: passa il protocollo a SOCKS5, imposta la whitelist IP su 203.0.113.7 e attiva il rinnovo automatico. Poi dimmi quali sono le nuove impostazioni. ### Regole per l’agente Per CLAUDE.md, AGENTS.md o le regole di Cursor. Quando usi il server MCP di ProxyJam: - Chiama prima list_offers. È l’unica fonte degli ID delle offerte. - create_proxy_order, extend_proxy_period e buy_proxy_bandwidth restano anteprime finché non li richiami con confirm=true. Mostrami l’anteprima e non confermare mai senza il mio sì esplicito. - Conferma con la stessa idempotency_key dell’anteprima. Usa una chiave nuova per ogni nuovo acquisto. - Se l’anteprima mostra un saldo inferiore al prezzo, fermati e avvisami invece di confermare. - Se uno strumento viene rifiutato perché la spesa non è consentita, dimmelo invece di riprovare; sono io a decidere se ricollegarti con la spesa consentita. - Tratta la mia chiave API come un segreto: non stamparla, non scriverla nei log e non inserirla in file che potrei condividere. ## Tutti i 16 strumenti | Strumento | Cosa fa | Effetto | |---|---|---| | list_offers | Cerca nel catalogo per tipo, paese, regione e città; restituisce gli ID delle offerte e le tariffe | Sola lettura | | list_my_orders | Elenca i tuoi ordini di proxy, una pagina alla volta | Sola lettura | | get_order | Un ordine completo, con i dati di connessione del proxy | Sola lettura | | get_my_traffic_summary | Il traffico consumato da tutti i tuoi proxy attivi | Sola lettura | | get_order_traffic | Il traffico consumato da un singolo ordine | Sola lettura | | list_my_wallets | I tuoi wallet, uno per valuta | Sola lettura | | get_wallet_balance | Il saldo di un wallet | Sola lettura | | list_wallet_transactions | Lo storico delle transazioni di un wallet, una pagina alla volta | Sola lettura | | get_transaction | Una singola transazione | Sola lettura | | create_proxy_order | Acquista da 1 a 50 proxy da un’offerta | Spende denaro, prima l’anteprima | | extend_proxy_period | Rinnova un proxy attivo per un altro periodo | Spende denaro, prima l’anteprima | | buy_proxy_bandwidth | Aggiunge da 1 a 5.000 GB di traffico a un proxy statico | Spende denaro, prima l’anteprima | | set_auto_renew | Attiva o disattiva il rinnovo automatico | Modifica le impostazioni, gratis | | set_proxy_whitelist | Sostituisce l’elenco degli IP autorizzati a usare il proxy | Modifica le impostazioni, gratis | | change_proxy_protocol | Passa da HTTP a SOCKS5 e viceversa | Modifica le impostazioni, gratis | | sync_proxy_state | Rilegge lo stato attuale del proxy | Modifica le impostazioni, gratis | Gli strumenti che il server espone oggi. I tre che spendono denaro restituiscono un’anteprima finché non vengono richiamati con confirm=true. Un client che ha effettuato l’accesso può chiamare gli ultimi sette solo se gli hai consentito di spendere. ## Dati di connessione - **Endpoint:** https://proxyjam.com/mcp - **Trasporto:** Streamable HTTP - **Autenticazione:** Accesso con il tuo account ProxyJam (OAuth 2.1), oppure una chiave API nell’header X-API-Key - **Permessi:** Lettura per impostazione predefinita; spesa e modifiche alle impostazioni solo se le consenti - **Elenchi di riferimento:** Stati degli ordini, valute, protocolli proxy, tipi di offerta e metodi di pagamento, come risorse MCP - **Prezzo:** Gratuito. Paghi solo i proxy che ordini ## Domande sul server MCP ### Quali client AI possono collegarsi? Qualsiasi client MCP che si colleghi a un server remoto tramite Streamable HTTP e che supporti l’accesso con OAuth o ti permetta di aggiungere un header alla richiesta. Le configurazioni qui sopra coprono Claude (claude.ai, Claude Desktop e le app mobile), Claude Code, Cursor, ChatGPT, VS Code, Codex CLI, Gemini CLI, l’OpenAI Agents SDK e FastMCP. ### Posso collegarlo a claude.ai o a ChatGPT? Sì. In Claude aggiungi un connettore personalizzato con l’indirizzo https://proxyjam.com/mcp, poi accedi a ProxyJam; il connettore compare anche in Claude Desktop e nelle app mobile. In ChatGPT i connettori MCP personalizzati richiedono la modalità sviluppatore, che OpenAI offre in beta su alcuni piani; aggiungi lo stesso indirizzo e scegli OAuth. ### Il server MCP ha un costo? No. Collegarsi e chiamare gli strumenti è gratuito. Paghi solo ciò che il tuo agente ordina, agli stessi prezzi della dashboard, con il tuo wallet ProxyJam. ### Il mio agente può spendere soldi senza chiedermelo? Non per sbaglio. Un client che accede con l’account non può spendere nulla, a meno che tu non abbia spuntato *Consenti spese dal mio wallet* quando l’hai approvato. Anche in quel caso, i tre strumenti che addebitano — ordine, rinnovo e acquisto di traffico — alla prima chiamata restituiscono un’anteprima e addebitano solo quando vengono richiamati con confirm=true; un agente scrupoloso ti mostra l’anteprima e aspetta, ed è proprio ciò che gli chiedono le regole per l’agente qui sopra. Una chiave API non ha limiti di spesa, quindi a un agente dai una chiave che puoi eliminare. ### Che cosa non può fare l’agente tramite MCP? Ricaricare il wallet, gestire le chiavi API, modificare le impostazioni dell’account, verificare indirizzi IP o usare le funzioni dei proxy mobile, come il reset dell’IP. Tutto questo resta nella dashboard e nella REST API. ### Mi serve una chiave API? No, se il tuo client supporta l’accesso con l’account. Una richiesta senza accesso né chiave viene rifiutata con un rimando alla pagina di accesso di ProxyJam: è così che claude.ai, Claude Code, Cursor e gli altri client avviano l’accesso da soli. I client che non lo supportano inviano invece una chiave API. ### Come consento la spesa in un secondo momento, o come la revoco? Ricollegati e approva con la casella spuntata o meno: ogni approvazione sostituisce la precedente. In Claude Code, per esempio, basta digitare /mcp e accedere di nuovo a proxyjam. ### Come revoco l’accesso a un agente? Per un client che ha effettuato l’accesso, revocalo da App collegate nelle impostazioni della dashboard: smette di funzionare entro cinque minuti, mentre le altre connessioni continuano a funzionare. Cambiare la password o uscire da tutte le sessioni le revoca tutte in una volta. Per una chiave API, eliminala nella pagina Chiavi API; una chiave creata con una data di scadenza smette di funzionare anche da sola. ### Un agente può registrarsi da solo? Sì, con dei limiti. Un agente senza un account alle spalle può registrarsi e ottenere una chiave che legge soltanto il catalogo pubblico. Se rivendichi quella chiave con il codice che ProxyJam ti invia via email, la chiave viene associata al tuo account e può leggere i tuoi ordini e il tuo wallet, ma non potrà mai spendere. Le istruzioni per gli agenti sono in auth.md. ## Inizia con poco Collegati, chiedi le offerte e leggi la risposta prima di lasciare che un agente ordini qualcosa. Quando arriva il momento di acquistare, l’anteprima ti mostra l’offerta, il prezzo e il tuo saldo, e non viene addebitato nulla finché non dici sì. ## Fonti - [Model Context Protocol — Transports](https://modelcontextprotocol.io/specification/2025-06-18/basic/transports) — il trasporto Streamable HTTP usato da questo server - [Scheda del server MCP](/.well-known/mcp/server-card.json) — endpoint, trasporto e autenticazione, per gli agenti che trovano ProxyJam da soli - [auth.md](/auth.md) — come un agente accede, si registra o usa una chiave API - [Metadati del server di autorizzazione OAuth](/.well-known/oauth-authorization-server) — gli endpoint e gli scope che un client individua quando accede - [Skill per agenti di ProxyJam](/.well-known/agent-skills/proxyjam/SKILL.md) — la guida d’uso che un agente può caricare prima della sua prima chiamata MCP, il [Model Context Protocol](https://modelcontextprotocol.io/), è lo standard aperto con cui gli assistenti AI richiamano strumenti esterni. Collega un client MCP al server di ProxyJam e il tuo agente potrà fare sul tuo account quasi tutto ciò che una chiave API permette di fare con la REST API. Prima di iniziare, ci sono due cose da sapere. **Decidi tu cosa può fare.** Un client che accede con l’account ti chiede prima l’approvazione. La lettura viene concessa in un unico blocco e comprende i nomi utente e le password dei tuoi proxy; la spesa dal wallet, e con essa le modifiche gratuite alle impostazioni, è una casella a parte, da spuntare solo se vuoi che l’agente passi all’azione. Con una chiave API è diverso: apre l’intero account, quindi, dove il tuo client lo consente, meglio accedere con l’account. **I soldi si muovono solo dopo un’anteprima.** I tre strumenti che costano denaro non addebitano mai nulla alla prima chiamata. Restituiscono un’anteprima contrassegnata come `dry_run` e addebitano solo quando vengono richiamati con `confirm=true`, cosa che un agente scrupoloso fa solo dopo il tuo sì.