Collega il tuo agente AI a ProxyJam

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ì.

Scegli il tuo client

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.

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.

Anthropic

Claude

claude.ai, Claude Desktop e le app mobile. Aggiungi ProxyJam una sola volta come connettore personalizzato e lo ritrovi in tutte e tre.

Mostra la configurazioneNascondi la configurazioneAccesso con account

Claude

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.

claude.ai, Claude Desktop e le app mobile condividono un unico elenco di connettori.

Guida completa nella documentazione

Anthropic

Claude Code

L’agente di programmazione di Anthropic per il terminale. Basta un comando per aggiungere il server, e con /mcp effettui l’accesso.

Mostra la configurazioneNascondi la configurazioneAccesso con account

Claude Code

claude mcp add --transport http proxyjam https://proxyjam.com/mcp

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.

Guida completa nella documentazione

Anysphere

Cursor

L’editor di codice con AI integrata. Aggiungi il server a mcp.json e Cursor ti chiederà di accedere la prima volta che si collega.

Mostra la configurazioneNascondi la configurazioneAccesso con account

Cursor

{
  "mcpServers": {
    "proxyjam": {
      "url": "https://proxyjam.com/mcp"
    }
  }
}

~/.cursor/mcp.json, oppure .cursor/mcp.json in un progetto. Cursor ti chiede di accedere alla prima connessione.

Guida completa nella documentazione

OpenAI

ChatGPT

I connettori personalizzati richiedono la modalità sviluppatore, che OpenAI offre in beta su alcuni piani.

Mostra la configurazioneNascondi la configurazioneAccesso con account

ChatGPT

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.

ChatGPT si identifica e apre la pagina di accesso di ProxyJam.

Guida completa nella documentazione

OpenAI

Codex CLI

L’agente di programmazione di OpenAI per il terminale. Due comandi: aggiungi il server, poi accedi.

Mostra la configurazioneNascondi la configurazioneAccesso con account

Codex CLI

codex mcp add proxyjam --url https://proxyjam.com/mcp
codex mcp login proxyjam

Eseguili entrambi in un terminale; il secondo apre il browser per l’accesso.

Guida completa nella documentazione

Microsoft

VS Code

La modalità agente di Copilot Chat. Si collega con una chiave API, che VS Code chiede una sola volta e conserva in modo sicuro.

Mostra la configurazioneNascondi la configurazioneChiave API

VS Code

{
  "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}" }
    }
  }
}

.vscode/mcp.json, con una chiave API. VS Code chiede la chiave una sola volta e la conserva in modo sicuro.

Guida completa nella documentazione

Google

Gemini CLI

L’agente di Google per il terminale. Aggiungi il server, poi digita /mcp auth proxyjam per accedere.

Mostra la configurazioneNascondi la configurazioneAccesso con account

Gemini CLI

gemini mcp add --transport http proxyjam https://proxyjam.com/mcp

Eseguilo in un terminale, poi digita /mcp auth proxyjam in Gemini CLI per accedere.

Guida completa nella documentazione

OpenAI

OpenAI Agents SDK

Framework Python per costruire i tuoi agenti. Si collega con una chiave API nell’header della richiesta.

Mostra la configurazioneNascondi la configurazioneChiave API

OpenAI Agents SDK

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())

Python, con una chiave API. pip install openai-agents.

Guida completa nella documentazione

Prefect

FastMCP

Libreria Python per client e server MCP. Effettua l’accesso tramite il browser ed elenca gli strumenti.

Mostra la configurazioneNascondi la configurazioneAccesso con account

FastMCP

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())

Python. pip install fastmcp. Effettua l’accesso tramite il browser ed elenca gli strumenti.

Guida completa nella documentazione

In breve: 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.

MCP, il Model Context Protocol, è 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ì.

COSA PUÒ FARE IL TUO AGENTE

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.

SICUREZZA

I soldi si muovono solo quando lo dici tu

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.
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.
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.
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.
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.
L’accesso finisce quando lo revochi. Un client che ha effettuato l’accesso compare in App collegate nelle impostazioni della dashboard; 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.

CONFIGURAZIONE

Collegati in tre passaggi

Aggiungi il server al tuo client
Scegli il tuo client qui sopra e copiane la configurazione. L’indirizzo è https://proxyjam.com/mcp.
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: inizia con pj_ e viene mostrata una sola volta.
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). 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.

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.

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.

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.

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.

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.

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.

PROMPT

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. Acquisto con anteprima Addebita solo dopo il tuo sì. Rinnovo Proroga un ordine, prima l’anteprima. Consumi e saldo Ordini, traffico e soldi in un’unica risposta. Impostazioni Modifiche che non costano nulla. Regole per l’agente Per CLAUDE.md, AGENTS.md o le regole di Cursor.

RIFERIMENTO

Tutti i 16 strumenti

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.
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

SERVER

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

DOCUMENTAZIONE

Per approfondire

Guida al server MCP Gli argomenti di ogni strumento e un ordine passo per passo

Guida rapida Dalla registrazione alla prima chiamata API

Autenticazione Creazione, scadenza e revoca delle chiavi

Idempotenza Come i tentativi ripetuti evitano i doppi addebiti

Riferimento API Ogni endpoint REST, da provare nel browser

Specifica OpenAPI L’API descritta per i generatori di codice

FAQ

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 — il trasporto Streamable HTTP usato da questo server
Scheda del server MCP — endpoint, trasporto e autenticazione, per gli agenti che trovano ProxyJam da soli
auth.md — come un agente accede, si registra o usa una chiave API
Metadati del server di autorizzazione OAuth — gli endpoint e gli scope che un client individua quando accede
Skill per agenti di ProxyJam — la guida d’uso che un agente può caricare prima della sua prima chiamata

Collega il tuo agente AI a ProxyJam

Scegli il tuo client

Claude

Claude Code

Cursor

ChatGPT

Codex CLI

VS Code

Gemini CLI

OpenAI Agents SDK

FastMCP

Sedici strumenti, sei compiti

Esplora il catalogo

Ordina proxy

Rinnova e aggiungi traffico

Controlla ordini e traffico

Tieni d’occhio i conti

Modifica le impostazioni

I soldi si muovono solo quando lo dici tu

Collegati in tre passaggi

Aggiungi il server al tuo client

Accedi e scegli cosa può fare

Inizia con un prompt in sola lettura

Prompt da provare

Tutti i 16 strumenti

Dati di connessione

Per approfondire

Domande sul server MCP

Inizia con poco

Fonti