Connectez votre agent IA à ProxyJam

Le serveur MCP de ProxyJam donne à Claude, Cursor et aux autres clients IA 16 outils sur votre compte : trouver des offres, commander et renouveler des proxys, consulter le trafic et le solde. Vous vous connectez et choisissez ce que l'agent a le droit de faire ; tout ce qui coûte de l'argent vous montre d'abord un aperçu et attend votre accord.

Choisir votre client

Il vous faut un compte ProxyJam. La plupart des clients s'y connectent directement ; les autres utilisent une clé API. Le serveur lui-même est gratuit : vous ne payez que les proxys que votre agent commande.

Choisissez votre client

Sélectionnez-en un pour savoir comment le connecter. La plupart des clients se connectent avec votre compte ProxyJam ; VS Code et l'OpenAI Agents SDK utilisent une clé API : remplacez pj_... par la vôtre.

Anthropic

Claude

claude.ai, Claude Desktop et les applis mobiles. Ajoutez ProxyJam une seule fois comme connecteur personnalisé : il apparaît dans les trois.

Afficher la configurationMasquer la configurationConnexion au compte

Claude

1. Dans Claude, ouvrez les paramètres des connecteurs et ajoutez un connecteur personnalisé.
2. Nommez-le ProxyJam et collez https://proxyjam.com/mcp comme adresse du serveur.
3. Lancez la connexion, identifiez-vous sur ProxyJam et approuvez.

claude.ai, Claude Desktop et les applis mobiles partagent la même liste de connecteurs.

Guide complet dans la documentation

Anthropic

Claude Code

L'agent de développement d'Anthropic, dans le terminal. Une commande ajoute le serveur, et /mcp vous connecte à votre compte.

Afficher la configurationMasquer la configurationConnexion au compte

Claude Code

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

Lancez-la dans un terminal, puis tapez /mcp dans Claude Code, choisissez proxyjam et connectez-vous. Ajoutez --scope user pour en profiter dans tous vos projets.

Guide complet dans la documentation

Anysphere

Cursor

L'éditeur de code IA. Ajoutez le serveur à mcp.json : Cursor vous invite à vous identifier lors de la première connexion.

Afficher la configurationMasquer la configurationConnexion au compte

Cursor

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

~/.cursor/mcp.json, ou .cursor/mcp.json dans un projet. Cursor vous demande de vous identifier lors de la première connexion.

Guide complet dans la documentation

OpenAI

ChatGPT

Les connecteurs personnalisés nécessitent le mode développeur, qu'OpenAI propose en bêta sur certains forfaits.

Afficher la configurationMasquer la configurationConnexion au compte

ChatGPT

1. Dans les paramètres de ChatGPT, activez le mode développeur et créez un connecteur personnalisé.
2. Saisissez https://proxyjam.com/mcp comme URL et choisissez OAuth.
3. Connectez-vous à ProxyJam et approuvez.

ChatGPT s'identifie de lui-même et ouvre la page de connexion ProxyJam.

Guide complet dans la documentation

OpenAI

Codex CLI

L'agent de développement d'OpenAI, dans le terminal. Deux commandes : l'une ajoute le serveur, l'autre vous connecte.

Afficher la configurationMasquer la configurationConnexion au compte

Codex CLI

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

Lancez les deux dans un terminal ; la seconde ouvre votre navigateur pour la connexion.

Guide complet dans la documentation

Microsoft

VS Code

Le mode agent de Copilot Chat. Se connecte avec une clé API, que VS Code demande une seule fois et conserve en lieu sûr.

Afficher la configurationMasquer la configurationClé 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, avec une clé API. VS Code demande la clé une seule fois et la conserve en lieu sûr.

Guide complet dans la documentation

Google

Gemini CLI

L'agent de Google pour le terminal. Ajoutez le serveur, puis lancez /mcp auth proxyjam pour vous connecter.

Afficher la configurationMasquer la configurationConnexion au compte

Gemini CLI

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

Lancez-la dans un terminal, puis tapez /mcp auth proxyjam dans Gemini CLI pour vous connecter.

Guide complet dans la documentation

OpenAI

OpenAI Agents SDK

Framework Python pour créer vos propres agents. Se connecte avec une clé API passée dans un en-tête de requête.

Afficher la configurationMasquer la configurationClé 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, avec une clé API. pip install openai-agents.

Guide complet dans la documentation

Prefect

FastMCP

Bibliothèque Python pour clients et serveurs MCP. Ouvre la connexion dans votre navigateur, puis liste les outils.

Afficher la configurationMasquer la configurationConnexion au compte

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. Ouvre la connexion dans votre navigateur, puis liste les outils.

Guide complet dans la documentation

En bref : ProxyJam fait tourner un serveur MCP distant à l’adresse https://proxyjam.com/mcp, en Streamable HTTP. Votre client IA se connecte avec votre compte ProxyJam (OAuth) ou envoie une clé API, et dispose alors de 16 outils : neuf qui lisent, quatre qui modifient des réglages et trois qui dépensent de l’argent — ces trois-là s’en tiennent à un aperçu tant que vous n’avez pas confirmé.

MCP, le Model Context Protocol, est le standard ouvert qu’utilisent les assistants IA pour appeler des outils externes. Pointez un client MCP vers le serveur de ProxyJam, et votre agent pourra faire sur votre compte l’essentiel de ce qu’une clé API permet dans l’API REST. Deux choses sont bonnes à savoir avant de commencer.

C’est vous qui décidez de ce qu’il peut faire. Un client qui se connecte à votre compte vous demande d’abord votre approbation. La lecture est accordée en bloc, et elle inclut les identifiants et mots de passe de vos proxys ; la dépense depuis votre portefeuille, avec les modifications de réglages gratuites qui l’accompagnent, est une case à part, que vous ne cochez que si vous voulez que l’agent passe à l’action. Une clé API, c’est autre chose : elle ouvre tout le compte, alors préférez la connexion par compte quand votre client la permet.

L’argent ne part qu’après un aperçu. Les trois outils payants ne débitent jamais au premier appel. Ils renvoient un aperçu marqué dry_run, et ne débitent que lorsqu’ils sont rappelés avec confirm=true — ce qu’un agent prudent ne fait qu’après votre accord.

CE QUE VOTRE AGENT PEUT FAIRE

Seize outils, six usages

Parcourir le catalogue

list_offers cherche dans les offres en temps réel par type, pays, région et ville, et renvoie chaque tarif avec son prix. C'est la seule source d'identifiants d'offre : tout achat commence donc ici.

Commander des proxys

create_proxy_order achète de 1 à 50 proxys sur une offre. Le premier appel se contente d'afficher le prix et votre solde ; la commande n'est passée que lorsque vous confirmez.

Renouveler et ajouter du trafic

extend_proxy_period renouvelle un proxy pour une période de plus, et buy_proxy_bandwidth ajoute du trafic à un proxy statique. Tous deux affichent d'abord un aperçu et ne débitent qu'après votre confirmation.

Suivre commandes et trafic

Vos commandes avec leurs paramètres de connexion, et le trafic consommé par chaque proxy ou par l'ensemble. En lecture seule : l'agent peut les appeler aussi souvent qu'il veut, sans risque.

Suivre l'argent

Le solde de vos portefeuilles dans chaque devise et l'historique complet des transactions, une par une ou par pages entières. En lecture seule, là aussi.

Modifier les réglages

Faire passer un proxy de HTTP à SOCKS5 ou l'inverse, remplacer sa liste blanche d'IP, activer ou désactiver le renouvellement automatique, ou actualiser son état. Rien de tout cela n'est facturé, mais un client connecté à votre compte doit avoir le droit de dépenser pour le faire.

SÉCURITÉ

Pas un centime sans votre accord

La lecture, par défaut. Quand un client se connecte, ProxyJam vous montre ce qu’il demande. La lecture de vos commandes, de votre portefeuille et du catalogue est accordée en bloc — et vos commandes contiennent les identifiants et mots de passe de vos proxys. La dépense passe par une case à part, Autoriser les dépenses depuis mon portefeuille, décochée au départ, qui couvre aussi les modifications de réglages gratuites.
D’abord un aperçu. create_proxy_order, extend_proxy_period et buy_proxy_bandwidth démarrent avec confirm=false : ils renvoient l’offre, le prix et votre solde, et ne débitent rien.
Votre accord, puis le paiement. L’agent ne rappelle l’outil avec confirm=true qu’une fois que vous avez approuvé l’aperçu. Les règles pour l’agent, dans les prompts ci-dessous, le disent en toutes lettres.
Jamais de double débit. L’appel de confirmation réutilise l’idempotency_key de l’aperçu : une requête relancée renvoie le premier résultat au lieu d’acheter une seconde fois. Chaque nouvel achat reçoit une nouvelle clé.
Une clé API ouvre tout le compte. Les clés créées dans le tableau de bord ne peuvent pas être restreintes : elles donnent accès à tout, lecture et dépenses comprises. Connectez-vous avec votre compte quand votre client le permet, et fixez une date d’expiration à toute clé que vous utilisez.
L’accès s’arrête quand vous le révoquez. Un client connecté figure sous Applications connectées dans les paramètres du tableau de bord ; révoquez-le là et il cesse de fonctionner en moins de cinq minutes. Changer de mot de passe ou vous déconnecter partout révoque toutes les connexions. Une clé cesse de fonctionner dès que vous la supprimez sur la page Clés API.

CONFIGURATION

Trois étapes pour vous connecter

Ajoutez le serveur à votre client
Choisissez votre client ci-dessus et copiez sa configuration. L’adresse est https://proxyjam.com/mcp.
Connectez-vous et choisissez ce qu'il peut faire
Le client ouvre ProxyJam dans votre navigateur. Connectez-vous, lisez ce qu’il demande, et ne cochez Autoriser les dépenses depuis mon portefeuille que si l’agent doit commander, renouveler ou modifier des réglages. Chaque approbation remplace la précédente : vous pourrez vous reconnecter plus tard pour changer d’avis. Un client qui ne sait pas se connecter à un compte utilise une clé API à la place : elle commence par pj_ et ne s’affiche qu’une seule fois.
Commencez par un prompt en lecture seule
Demandez d’abord les offres — le même catalogue en temps réel que sur la page proxys résidentiels statiques (ISP). Vous vérifiez ainsi que la connexion fonctionne, et l’agent obtient les identifiants d’offre dont il a besoin pour tout le reste. Essayez ensuite les prompts ci-dessous.

Avec le serveur MCP de ProxyJam, listez les offres de proxys résidentiels statiques (ISP) aux États-Unis, avec leur prix mensuel. Ne commandez rien.

Commandez chez ProxyJam un proxy résidentiel statique (ISP) aux États-Unis pour un mois. Montrez-moi d'abord l'aperçu — l'offre, le prix et le solde de mon portefeuille — et attendez mon accord explicite avant de confirmer. Pour confirmer, réutilisez la même clé d'idempotence.

Prolongez d'un mois ma commande ProxyJam ORDER_ID. Montrez-moi l'aperçu avec le prix et mon solde, et attendez mon accord avant de confirmer.

Affichez mes proxys ProxyJam actifs avec leur date d'expiration et le trafic consommé par chacun, puis le solde de mon portefeuille en USD et mes 10 dernières transactions.

Pour ma commande ProxyJam ORDER_ID : passez le protocole en SOCKS5, définissez la liste blanche d'IP sur 203.0.113.7 et activez le renouvellement automatique. Indiquez-moi ensuite les nouveaux réglages.

Quand vous utilisez le serveur MCP de ProxyJam :
- Appelez d'abord list_offers. C'est la seule source d'identifiants d'offre.
- create_proxy_order, extend_proxy_period et buy_proxy_bandwidth ne produisent qu'un aperçu tant qu'ils ne sont pas appelés avec confirm=true. Montrez-moi l'aperçu et ne confirmez jamais sans mon accord explicite.
- Confirmez avec la même idempotency_key que l'aperçu. Utilisez une nouvelle clé pour chaque nouvel achat.
- Si l'aperçu indique un solde inférieur au prix, arrêtez-vous et prévenez-moi au lieu de confirmer.
- Si un outil est refusé parce que les dépenses ne sont pas autorisées, prévenez-moi au lieu de réessayer ; c'est à moi de décider si je me reconnecte en autorisant les dépenses.
- Traitez ma clé API comme un secret : ne l'affichez jamais, ne la journalisez jamais et ne l'écrivez dans aucun fichier que je pourrais partager.

PROMPTS

Des prompts à essayer

Une fois le serveur connecté, collez-en un dans le chat de votre agent. Remplacez ORDER_ID par un numéro de commande relevé dans votre tableau de bord. Le dernier onglet regroupe des règles à garder dans les instructions de votre agent.

Trouver un proxy Lecture seule. Un premier appel sans risque. Acheter avec aperçu Débit uniquement après votre accord. Renouveler Prolonger une commande, aperçu d'abord. Consommation et solde Commandes, trafic et argent en une seule réponse. Réglages Des modifications qui ne coûtent rien. Règles pour l'agent Pour CLAUDE.md, AGENTS.md ou les règles de Cursor.

RÉFÉRENCE

Les 16 outils

Les outils que le serveur expose aujourd'hui. Les trois qui dépensent de l'argent renvoient un aperçu tant qu'ils ne sont pas rappelés avec confirm=true. Un client connecté à votre compte ne peut appeler les sept derniers que si vous avez autorisé les dépenses.
Outil	Ce qu'il fait	Effet
list_offers	Cherche dans le catalogue par type, pays, région et ville ; renvoie les identifiants d'offre et les tarifs	Lecture seule
list_my_orders	Liste vos commandes de proxys, page par page	Lecture seule
get_order	Une commande en détail, paramètres de connexion du proxy compris	Lecture seule
get_my_traffic_summary	Le trafic consommé par l'ensemble de vos proxys actifs	Lecture seule
get_order_traffic	Le trafic consommé par une commande	Lecture seule
list_my_wallets	Vos portefeuilles, un par devise	Lecture seule
get_wallet_balance	Le solde d'un portefeuille	Lecture seule
list_wallet_transactions	L'historique des transactions d'un portefeuille, page par page	Lecture seule
get_transaction	Une transaction	Lecture seule
create_proxy_order	Achète de 1 à 50 proxys sur une offre	Payant, après aperçu
extend_proxy_period	Renouvelle un proxy actif pour une période de plus	Payant, après aperçu
buy_proxy_bandwidth	Ajoute de 1 à 5 000 Go de trafic à un proxy statique	Payant, après aperçu
set_auto_renew	Active ou désactive le renouvellement automatique	Réglage gratuit
set_proxy_whitelist	Remplace la liste des IP autorisées à utiliser le proxy	Réglage gratuit
change_proxy_protocol	Bascule entre HTTP et SOCKS5	Réglage gratuit
sync_proxy_state	Relit l'état actuel du proxy	Réglage gratuit

SERVEUR

Paramètres de connexion

Point d'accès: https://proxyjam.com/mcp
Transport: Streamable HTTP
Authentification: Connexion avec votre compte ProxyJam (OAuth 2.1), ou clé API dans l'en-tête X-API-Key
Accès: Lecture par défaut ; dépenses et modifications de réglages uniquement si vous les autorisez
Listes de référence: Statuts de commande, devises, protocoles de proxy, types d'offre et moyens de paiement, sous forme de ressources MCP
Prix: Gratuit. Vous ne payez que les proxys que vous commandez

DOCUMENTATION

Pour aller plus loin

Guide du serveur MCP Les arguments de chaque outil et une commande pas à pas

Démarrage rapide De l'inscription au premier appel d'API

Authentification Créer, faire expirer et révoquer des clés

Idempotence Relancer une requête sans payer deux fois

Référence de l'API Chaque endpoint REST, à tester dans le navigateur

Spécification OpenAPI L'API décrite pour les générateurs de code

FAQ

Questions sur le serveur MCP

Quels clients IA peuvent se connecter ?

Tout client MCP capable de joindre un serveur distant en Streamable HTTP et, soit de se connecter via OAuth, soit de vous laisser ajouter un en-tête de requête. Les configurations ci-dessus couvrent Claude (claude.ai, Claude Desktop et les applis mobiles), Claude Code, Cursor, ChatGPT, VS Code, Codex CLI, Gemini CLI, l'OpenAI Agents SDK et FastMCP.

Puis-je le connecter à claude.ai ou à ChatGPT ?

Oui. Dans Claude, ajoutez un connecteur personnalisé avec l'adresse https://proxyjam.com/mcp, puis connectez-vous à ProxyJam ; le connecteur apparaît aussi dans Claude Desktop et les applis mobiles. Dans ChatGPT, les connecteurs MCP personnalisés nécessitent le mode développeur, qu'OpenAI propose en bêta sur certains forfaits ; ajoutez la même adresse et choisissez OAuth.

Le serveur MCP est-il payant ?

Non. La connexion et les appels d'outils sont gratuits. Vous ne payez que ce que votre agent commande, aux mêmes prix que dans le tableau de bord, depuis votre portefeuille ProxyJam.

Mon agent peut-il dépenser de l'argent sans me demander ?

Pas par mégarde. Un client connecté à votre compte ne peut rien dépenser du tout si vous n'avez pas coché *Autoriser les dépenses depuis mon portefeuille* en l'approuvant. Même dans ce cas, les trois outils payants — commande, renouvellement et achat de trafic — renvoient un aperçu au premier appel et ne débitent que s'ils sont rappelés avec confirm=true ; un agent prudent vous montre cet aperçu et attend, et les règles pour l'agent ci-dessus le lui demandent. Une clé API, elle, n'a aucune limite de dépense : confiez donc à un agent une clé que vous pouvez supprimer.

Qu'est-ce que l'agent ne peut pas faire via MCP ?

Recharger le portefeuille, gérer les clés API, modifier les paramètres du compte, vérifier des adresses IP ou utiliser les actions propres aux proxys mobiles, comme le changement d'IP. Tout cela reste dans le tableau de bord et l'API REST.

Ai-je besoin d'une clé API ?

Pas si votre client sait se connecter à votre compte. Une requête qui ne porte ni connexion ni clé est refusée, avec un renvoi vers la connexion ProxyJam : c'est ainsi que claude.ai, Claude Code, Cursor et les autres clients la déclenchent d'eux-mêmes. Les clients qui ne savent pas se connecter envoient une clé API à la place.

Comment autoriser les dépenses plus tard, ou revenir dessus ?

Reconnectez-vous et approuvez avec la case cochée ou décochée : chaque approbation remplace la précédente. Dans Claude Code, par exemple, il suffit de taper /mcp, puis de vous reconnecter à proxyjam.

Comment révoquer l'accès d'un agent ?

Pour un client connecté à votre compte, révoquez-le sous Applications connectées, dans les paramètres du tableau de bord ; il s'arrête en moins de cinq minutes, et vos autres connexions continuent de fonctionner. Changer de mot de passe ou vous déconnecter partout les révoque toutes d'un coup. Pour une clé API, supprimez-la sur la page Clés API ; une clé créée avec une date d'expiration cesse aussi de fonctionner d'elle-même.

Un agent peut-il s'inscrire tout seul ?

Oui, dans certaines limites. Un agent sans compte peut s'enregistrer et obtenir une clé qui ne lit que le catalogue public. Si vous rattachez cette clé à votre compte grâce au code que ProxyJam vous envoie par e-mail, elle peut lire vos commandes et votre portefeuille, mais elle ne pourra jamais dépenser. La marche à suivre pour les agents se trouve dans auth.md.

Commencez petit

Connectez le serveur, demandez les offres et lisez ce qui revient avant de laisser un agent commander quoi que ce soit. Le moment venu d’acheter, l’aperçu affiche l’offre, le prix et votre solde, et rien n’est débité tant que vous n’avez pas dit oui.

Sources

Model Context Protocol — Transports — le transport Streamable HTTP qu’utilise ce serveur
Carte du serveur MCP — le point d’accès, le transport et l’authentification, pour les agents qui découvrent ProxyJam par eux-mêmes
auth.md — comment un agent se connecte, s’inscrit ou utilise une clé API
Métadonnées du serveur d’autorisation OAuth — les points d’accès et les scopes qu’un client découvre au moment de se connecter
Skill d’agent ProxyJam — le guide d’utilisation qu’un agent peut charger avant son premier appel

Connectez votre agent IA à ProxyJam

Choisissez votre client

Claude

Claude Code

Cursor

ChatGPT

Codex CLI

VS Code

Gemini CLI

OpenAI Agents SDK

FastMCP

Seize outils, six usages

Parcourir le catalogue

Commander des proxys

Renouveler et ajouter du trafic

Suivre commandes et trafic

Suivre l'argent

Modifier les réglages

Pas un centime sans votre accord

Trois étapes pour vous connecter

Ajoutez le serveur à votre client

Connectez-vous et choisissez ce qu'il peut faire

Commencez par un prompt en lecture seule

Des prompts à essayer

Les 16 outils

Paramètres de connexion

Pour aller plus loin

Questions sur le serveur MCP

Commencez petit

Sources