# Serveur MCP pour agents IA | ProxyJam Connectez Claude, Cursor et d'autres clients MCP à votre compte ProxyJam : offres, commandes, renouvellements, trafic. Aucun achat sans votre accord. - Canonical: https://proxyjam.com/fr/mcp/ - Updated: 2026-10-14 - Language: fr 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. 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. 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é. ## 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. ## Pas un centime sans votre accord 1. **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. 2. **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. 3. **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. 4. **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é. 5. **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. 6. **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](https://app.proxyjam.com/settings) ; 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](https://app.proxyjam.com/apikey). ## Trois étapes pour vous connecter 1. **Ajoutez le serveur à votre client** Choisissez votre client ci-dessus et copiez sa configuration. L'adresse est `https://proxyjam.com/mcp`. 2. **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](https://app.proxyjam.com/apikey) à la place : elle commence par `pj_` et ne s'affiche qu'une seule fois. 3. **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)](/fr/isp-proxies/). 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. ## 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. ### Claude (Anthropic) claude.ai, Claude Desktop et les applis mobiles partagent la même liste de connecteurs. 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. Guide complet dans la documentation: https://docs.proxyjam.com/mcp-server#claude-ai-and-claude-desktop ### Claude Code (Anthropic) 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. ``` claude mcp add --transport http proxyjam https://proxyjam.com/mcp ``` Guide complet dans la documentation: https://docs.proxyjam.com/mcp-server#claude-code ### Cursor (Anysphere) ~/.cursor/mcp.json, ou .cursor/mcp.json dans un projet. Cursor vous demande de vous identifier lors de la première connexion. ``` { "mcpServers": { "proxyjam": { "url": "https://proxyjam.com/mcp" } } } ``` Guide complet dans la documentation: https://docs.proxyjam.com/mcp-server#cursor ### ChatGPT (OpenAI) ChatGPT s'identifie de lui-même et ouvre la page de connexion ProxyJam. 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. Guide complet dans la documentation: https://docs.proxyjam.com/mcp-server#chatgpt ### Codex CLI (OpenAI) Lancez les deux dans un terminal ; la seconde ouvre votre navigateur pour la connexion. ``` codex mcp add proxyjam --url https://proxyjam.com/mcp codex mcp login proxyjam ``` Guide complet dans la documentation: https://docs.proxyjam.com/mcp-server#codex-cli ### VS Code (Microsoft) .vscode/mcp.json, avec une clé API. VS Code demande la clé une seule fois et la conserve en lieu sûr. ``` { "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}" } } } } ``` Guide complet dans la documentation: https://docs.proxyjam.com/mcp-server#vs-code ### Gemini CLI (Google) Lancez-la dans un terminal, puis tapez /mcp auth proxyjam dans Gemini CLI pour vous connecter. ``` gemini mcp add --transport http proxyjam https://proxyjam.com/mcp ``` Guide complet dans la documentation: https://docs.proxyjam.com/mcp-server#gemini-cli ### OpenAI Agents SDK (OpenAI) Python, avec une clé 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()) ``` Guide complet dans la documentation: https://docs.proxyjam.com/mcp-server#openai-agents-sdk ### FastMCP (Prefect) Python. pip install fastmcp. Ouvre la connexion dans votre navigateur, puis liste les outils. ``` 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()) ``` Guide complet dans la documentation: https://docs.proxyjam.com/mcp-server#generic-fastmcp-client-python ## 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. 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. ### Acheter avec aperçu Débit uniquement après votre accord. 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. ### Renouveler Prolonger une commande, aperçu d'abord. 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. ### Consommation et solde Commandes, trafic et argent en une seule réponse. 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. ### Réglages Des modifications qui ne coûtent rien. 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. ### Règles pour l'agent Pour CLAUDE.md, AGENTS.md ou les règles de Cursor. 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. ## Les 16 outils | 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 | 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. ## 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 ## 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](https://modelcontextprotocol.io/specification/2025-06-18/basic/transports) — le transport Streamable HTTP qu'utilise ce serveur - [Carte du serveur MCP](/.well-known/mcp/server-card.json) — le point d'accès, le transport et l'authentification, pour les agents qui découvrent ProxyJam par eux-mêmes - [auth.md](/auth.md) — comment un agent se connecte, s'inscrit ou utilise une clé API - [Métadonnées du serveur d'autorisation OAuth](/.well-known/oauth-authorization-server) — les points d'accès et les scopes qu'un client découvre au moment de se connecter - [Skill d'agent ProxyJam](/.well-known/agent-skills/proxyjam/SKILL.md) — le guide d'utilisation qu'un agent peut charger avant son premier appel MCP, le [Model Context Protocol](https://modelcontextprotocol.io/), 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.