# MCP-Server für KI-Agenten | ProxyJam Claude, Cursor & Co. per MCP mit Ihrem ProxyJam-Konto verbinden: Angebote finden, Proxys bestellen und verlängern. Gekauft wird erst nach Ihrem Ja. - Canonical: https://proxyjam.com/de/mcp/ - Updated: 2026-10-14 - Language: de Der MCP-Server von ProxyJam gibt Claude, Cursor und anderen KI-Clients 16 Tools für Ihr Konto: Angebote finden, Proxys bestellen und verlängern, Traffic und Guthaben im Blick behalten. Sie melden sich an und legen fest, was der Agent darf — und alles, was Geld kostet, zeigt Ihnen zuerst eine Vorschau und wartet auf Ihr Ja. Sie brauchen ein ProxyJam-Konto. Die meisten Clients melden sich damit an, die übrigen nutzen einen API-Schlüssel. Der Server selbst ist kostenlos; Sie zahlen nur für die Proxys, die Ihr Agent bestellt. ProxyJam betreibt unter `https://proxyjam.com/mcp` einen Remote-MCP-Server mit Streamable HTTP als Transport. Ihr KI-Client meldet sich entweder mit Ihrem ProxyJam-Konto an (OAuth) oder sendet einen API-Schlüssel und erhält 16 Tools: neun, die lesen, vier, die Einstellungen ändern, und drei, die Geld ausgeben — und diese drei liefern nur eine Vorschau, bis Sie bestätigen. ## Sechzehn Tools, sechs Aufgaben ### Den Katalog durchsuchen list_offers durchsucht die aktuellen Angebote nach Typ, Land, Region und Stadt und liefert jeden Tarif mit seinem Preis. Nur hier gibt es Angebots-IDs, deshalb beginnt jeder Kauf an dieser Stelle. ### Proxys bestellen create_proxy_order kauft 1 bis 50 Proxys aus einem Angebot. Der erste Aufruf zeigt nur den Preis und Ihr Guthaben; bestellt wird erst, wenn Sie bestätigen. ### Verlängern und Traffic nachkaufen extend_proxy_period verlängert einen Proxy um eine weitere Laufzeit, buy_proxy_bandwidth bucht zusätzlichen Traffic für einen statischen Proxy. Beide zeigen zuerst eine Vorschau und buchen erst ab, wenn Sie bestätigen. ### Bestellungen und Traffic prüfen Ihre Bestellungen samt Verbindungsdaten und der Traffic, den jeder einzelne Proxy oder alle zusammen verbraucht haben. Rein lesend — der Agent darf das so oft abrufen, wie er will. ### Die Finanzen im Blick Wallet-Guthaben in jeder Währung und der vollständige Transaktionsverlauf, einzeln oder seitenweise. Ebenfalls rein lesend. ### Einstellungen ändern Einen Proxy zwischen HTTP und SOCKS5 umstellen, seine IP-Whitelist ersetzen, die automatische Verlängerung ein- oder ausschalten oder seinen Status aktualisieren. Nichts davon kostet etwas, ein angemeldeter Client braucht dafür aber die Freigabe für Ausgaben. ## Geld fließt nur, wenn Sie es sagen 1. **Lesen ist der Standard.** Wenn sich ein Client anmeldet, zeigt ProxyJam Ihnen, welche Rechte er anfordert. Das Lesen Ihrer Bestellungen, Ihres Wallets und des Katalogs wird gemeinsam freigegeben — und zu den Bestellungen gehören die Logins und Passwörter Ihrer Proxys. Ausgaben sind ein eigenes Kästchen, *Ausgaben aus meinem Wallet erlauben*, das zunächst nicht angehakt ist und auch die kostenlosen Einstellungsänderungen umfasst. 2. **Erst die Vorschau.** `create_proxy_order`, `extend_proxy_period` und `buy_proxy_bandwidth` starten mit `confirm=false`: Sie erhalten Angebot, Preis und Ihr Guthaben, abgebucht wird nichts. 3. **Erst Ihr Ja, dann die Abbuchung.** Der Agent ruft das Tool erst dann erneut mit `confirm=true` auf, wenn Sie die Vorschau freigegeben haben. Die Agentenregeln in den Prompts unten sagen das unmissverständlich. 4. **Keine doppelten Abbuchungen.** Der bestätigende Aufruf verwendet den `idempotency_key` der Vorschau, sodass eine wiederholte Anfrage das erste Ergebnis zurückgibt, statt ein zweites Mal zu kaufen. Jeder neue Kauf bekommt einen neuen Schlüssel. 5. **Ein API-Schlüssel öffnet das ganze Konto.** Schlüssel aus dem Dashboard lassen sich nicht auf engere Rechte beschränken; sie dürfen alles, Lesen und Ausgeben eingeschlossen. Melden Sie sich an, wo Ihr Client das unterstützt, und versehen Sie jeden Schlüssel, den Sie dennoch nutzen, mit einem Ablaufdatum. 6. **Der Zugriff endet, wenn Sie ihn widerrufen.** Ein angemeldeter Client erscheint unter *Verknüpfte Apps* in Ihren [Dashboard-Einstellungen](https://app.proxyjam.com/settings); widerrufen Sie ihn dort, ist er innerhalb von fünf Minuten gesperrt. Wenn Sie Ihr Passwort ändern oder sich überall abmelden, werden alle Verbindungen widerrufen. Ein Schlüssel funktioniert nicht mehr, sobald Sie ihn auf der Seite [API-Schlüssel](https://app.proxyjam.com/apikey) löschen. ## In drei Schritten verbunden 1. **Den Server in Ihrem Client hinzufügen** Wählen Sie oben Ihren Client aus und kopieren Sie seine Konfiguration. Die Adresse lautet `https://proxyjam.com/mcp`. 2. **Anmelden und festlegen, was er darf** Der Client öffnet ProxyJam in Ihrem Browser. Melden Sie sich an, lesen Sie, welche Rechte er anfordert, und haken Sie *Ausgaben aus meinem Wallet erlauben* nur an, wenn der Agent bestellen, verlängern oder Einstellungen ändern soll. Jede Freigabe ersetzt die vorherige, Sie können also später neu verbinden und die Auswahl ändern. Ein Client, der sich nicht anmelden kann, nutzt stattdessen einen [API-Schlüssel](https://app.proxyjam.com/apikey): Er beginnt mit `pj_` und wird nur ein einziges Mal angezeigt. 3. **Mit einem Prompt beginnen, der nur liest** Fragen Sie zuerst nach Angeboten — es ist derselbe Live-Katalog wie auf der Seite zu [Static Residential (ISP) Proxys](/de/isp-proxies/). So sehen Sie, dass die Verbindung steht, und der Agent erhält die Angebots-IDs, die er für alles Weitere braucht. Probieren Sie danach die Prompts unten aus. ## Wählen Sie Ihren Client Wählen Sie einen aus, um zu sehen, wie Sie ihn verbinden. Die meisten Clients melden sich mit Ihrem ProxyJam-Konto an; VS Code und das OpenAI Agents SDK nutzen einen API-Schlüssel — ersetzen Sie dort pj_... durch Ihren eigenen. ### Claude (Anthropic) claude.ai, Claude Desktop und die Mobil-Apps nutzen dieselbe Connector-Liste. 1. Öffnen Sie in Claude die Connector-Einstellungen und fügen Sie einen benutzerdefinierten Connector hinzu. 2. Nennen Sie ihn ProxyJam und tragen Sie https://proxyjam.com/mcp als Serveradresse ein. 3. Stellen Sie die Verbindung her, melden Sie sich bei ProxyJam an und erteilen Sie die Freigabe. Ausführliche Anleitung in der Dokumentation: https://docs.proxyjam.com/mcp-server#claude-ai-and-claude-desktop ### Claude Code (Anthropic) Führen Sie den Befehl in einem Terminal aus, geben Sie dann in Claude Code /mcp ein, wählen Sie proxyjam und melden Sie sich an. Mit --scope user steht der Server in jedem Projekt zur Verfügung. ``` claude mcp add --transport http proxyjam https://proxyjam.com/mcp ``` Ausführliche Anleitung in der Dokumentation: https://docs.proxyjam.com/mcp-server#claude-code ### Cursor (Anysphere) ~/.cursor/mcp.json oder .cursor/mcp.json in einem Projekt. Cursor bittet Sie bei der ersten Verbindung, sich anzumelden. ``` { "mcpServers": { "proxyjam": { "url": "https://proxyjam.com/mcp" } } } ``` Ausführliche Anleitung in der Dokumentation: https://docs.proxyjam.com/mcp-server#cursor ### ChatGPT (OpenAI) ChatGPT gibt sich als Client zu erkennen und öffnet die Anmeldung bei ProxyJam. 1. Aktivieren Sie in den Einstellungen von ChatGPT den Entwicklermodus und legen Sie einen benutzerdefinierten Connector an. 2. Geben Sie https://proxyjam.com/mcp als URL ein und wählen Sie OAuth. 3. Melden Sie sich bei ProxyJam an und erteilen Sie die Freigabe. Ausführliche Anleitung in der Dokumentation: https://docs.proxyjam.com/mcp-server#chatgpt ### Codex CLI (OpenAI) Führen Sie beide in einem Terminal aus; der zweite öffnet Ihren Browser für die Anmeldung. ``` codex mcp add proxyjam --url https://proxyjam.com/mcp codex mcp login proxyjam ``` Ausführliche Anleitung in der Dokumentation: https://docs.proxyjam.com/mcp-server#codex-cli ### VS Code (Microsoft) .vscode/mcp.json, mit einem API-Schlüssel. VS Code fragt den Schlüssel einmal ab und speichert ihn sicher. ``` { "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}" } } } } ``` Ausführliche Anleitung in der Dokumentation: https://docs.proxyjam.com/mcp-server#vs-code ### Gemini CLI (Google) Führen Sie den Befehl in einem Terminal aus und geben Sie dann in Gemini CLI /mcp auth proxyjam ein, um sich anzumelden. ``` gemini mcp add --transport http proxyjam https://proxyjam.com/mcp ``` Ausführliche Anleitung in der Dokumentation: https://docs.proxyjam.com/mcp-server#gemini-cli ### OpenAI Agents SDK (OpenAI) Python, mit einem API-Schlüssel. 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()) ``` Ausführliche Anleitung in der Dokumentation: https://docs.proxyjam.com/mcp-server#openai-agents-sdk ### FastMCP (Prefect) Python. pip install fastmcp. Meldet sich über Ihren Browser an und listet die Tools auf. ``` 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()) ``` Ausführliche Anleitung in der Dokumentation: https://docs.proxyjam.com/mcp-server#generic-fastmcp-client-python ## Prompts zum Ausprobieren Fügen Sie einen davon in den Chat Ihres Agenten ein, sobald der Server verbunden ist. Ersetzen Sie ORDER_ID durch eine Bestellnummer aus Ihrem Dashboard. Der letzte Tab enthält Regeln, die Sie dauerhaft in den Anweisungen Ihres Agenten hinterlegen. ### Proxy finden Rein lesend. Ein sicherer erster Aufruf. Liste über den ProxyJam-MCP-Server die Angebote für statische Residential-Proxys (ISP) in den USA mit ihren Monatspreisen auf. Bestelle nichts. ### Kauf mit Vorschau Abbuchung erst nach Ihrem Ja. Bestelle bei ProxyJam einen statischen Residential-Proxy (ISP) in den USA für einen Monat. Zeig mir zuerst die Vorschau — Angebot, Preis und mein Wallet-Guthaben — und warte auf mein ausdrückliches Ja, bevor du bestätigst. Verwende beim Bestätigen denselben Idempotency-Key. ### Verlängern Eine Bestellung verlängern, zuerst mit Vorschau. Verlängere meine ProxyJam-Bestellung ORDER_ID um einen Monat. Zeig mir die Vorschau mit Preis und meinem Guthaben und warte auf mein Ja, bevor du bestätigst. ### Verbrauch und Guthaben Bestellungen, Traffic und Geld in einer Antwort. Zeig mir meine aktiven ProxyJam-Proxys mit Ablaufdatum und dem Traffic, den jeder davon verbraucht hat, danach das Guthaben meines USD-Wallets und meine letzten 10 Transaktionen. ### Einstellungen Änderungen, die nichts kosten. Für meine ProxyJam-Bestellung ORDER_ID: Stell das Protokoll auf SOCKS5 um, setz die IP-Whitelist auf 203.0.113.7 und schalte die automatische Verlängerung ein. Nenn mir danach die neuen Einstellungen. ### Agentenregeln Für CLAUDE.md, AGENTS.md oder Cursor-Regeln. Wenn du den ProxyJam-MCP-Server nutzt: - Ruf zuerst list_offers auf. Nur dort bekommst du Angebots-IDs. - create_proxy_order, extend_proxy_period und buy_proxy_bandwidth liefern nur eine Vorschau, bis confirm=true gesetzt ist. Zeig mir die Vorschau und bestätige nie ohne mein ausdrückliches Ja. - Bestätige mit demselben idempotency_key wie bei der Vorschau. Verwende für jeden neuen Kauf einen neuen Schlüssel. - Zeigt die Vorschau ein Guthaben unter dem Preis, brich ab und sag mir Bescheid, statt zu bestätigen. - Wird ein Tool abgelehnt, weil Ausgaben nicht erlaubt sind, sag mir Bescheid, statt es erneut zu versuchen; ich entscheide, ob ich mit erlaubten Ausgaben neu verbinde. - Behandle meinen API-Schlüssel als Geheimnis: Gib ihn nie aus, protokolliere ihn nicht und schreib ihn in keine Datei, die ich weitergeben könnte. ## Alle 16 Tools | Tool | Funktion | Wirkung | |---|---|---| | list_offers | Durchsucht den Katalog nach Typ, Land, Region und Stadt; liefert Angebots-IDs und Tarife | Lesend | | list_my_orders | Listet Ihre Proxy-Bestellungen seitenweise auf | Lesend | | get_order | Eine Bestellung im Detail, einschließlich der Verbindungsdaten des Proxys | Lesend | | get_my_traffic_summary | Traffic-Verbrauch aller Ihrer aktiven Proxys | Lesend | | get_order_traffic | Traffic-Verbrauch einer Bestellung | Lesend | | list_my_wallets | Ihre Wallets, eines pro Währung | Lesend | | get_wallet_balance | Das Guthaben eines Wallets | Lesend | | list_wallet_transactions | Der Transaktionsverlauf eines Wallets, seitenweise | Lesend | | get_transaction | Eine einzelne Transaktion | Lesend | | create_proxy_order | Kauft 1 bis 50 Proxys aus einem Angebot | Kostenpflichtig, mit Vorschau | | extend_proxy_period | Verlängert einen aktiven Proxy um eine weitere Laufzeit | Kostenpflichtig, mit Vorschau | | buy_proxy_bandwidth | Bucht 1 bis 5.000 GB Traffic für einen statischen Proxy hinzu | Kostenpflichtig, mit Vorschau | | set_auto_renew | Schaltet die automatische Verlängerung ein oder aus | Ändert Einstellungen, kostenlos | | set_proxy_whitelist | Ersetzt die Liste der IPs, die den Proxy nutzen dürfen | Ändert Einstellungen, kostenlos | | change_proxy_protocol | Wechselt zwischen HTTP und SOCKS5 | Ändert Einstellungen, kostenlos | | sync_proxy_state | Liest den aktuellen Status des Proxys neu ein | Ändert Einstellungen, kostenlos | Die Tools, die der Server derzeit anbietet. Die drei, die Geld ausgeben, liefern eine Vorschau, bis sie erneut mit confirm=true aufgerufen werden. Die letzten sieben kann ein angemeldeter Client nur aufrufen, wenn Sie Ausgaben erlaubt haben. ## Verbindungsdaten - **Endpunkt:** https://proxyjam.com/mcp - **Transport:** Streamable HTTP - **Authentifizierung:** Anmeldung mit Ihrem ProxyJam-Konto (OAuth 2.1) oder ein API-Schlüssel im Header X-API-Key - **Zugriff:** Standardmäßig nur lesend; Ausgaben und Einstellungsänderungen nur, wenn Sie sie erlauben - **Referenzlisten:** Bestellstatus, Währungen, Proxy-Protokolle, Angebotsarten und Zahlungsmethoden, als MCP-Ressourcen - **Preis:** Kostenlos. Sie zahlen nur für die Proxys, die Sie bestellen ## Fragen zum MCP-Server ### Welche KI-Clients können sich verbinden? Jeder MCP-Client, der sich über Streamable HTTP mit einem Remote-Server verbindet und sich entweder per OAuth anmeldet oder einen eigenen Request-Header zulässt. Die Konfigurationen oben decken Claude (claude.ai, Claude Desktop und die Mobil-Apps), Claude Code, Cursor, ChatGPT, VS Code, Codex CLI, Gemini CLI, das OpenAI Agents SDK und FastMCP ab. ### Kann ich den Server mit claude.ai oder ChatGPT verbinden? Ja. Fügen Sie in Claude einen benutzerdefinierten Connector mit der Adresse https://proxyjam.com/mcp hinzu und melden Sie sich dann bei ProxyJam an; der Connector erscheint auch in Claude Desktop und den Mobil-Apps. In ChatGPT setzen benutzerdefinierte MCP-Connectors den Entwicklermodus voraus, den OpenAI in einigen Tarifen als Beta anbietet; tragen Sie dieselbe Adresse ein und wählen Sie OAuth. ### Kostet der MCP-Server etwas? Nein. Verbinden und Tools aufrufen ist kostenlos. Sie zahlen nur für das, was Ihr Agent bestellt — zu denselben Preisen wie im Dashboard und aus Ihrem ProxyJam-Wallet. ### Kann mein Agent ohne Rückfrage Geld ausgeben? Nicht aus Versehen. Ein angemeldeter Client kann überhaupt nichts ausgeben, wenn Sie bei der Freigabe nicht *Ausgaben aus meinem Wallet erlauben* angehakt haben. Selbst dann liefern die drei kostenpflichtigen Tools — Bestellen, Verlängern und Traffic-Kauf — beim ersten Aufruf eine Vorschau und buchen erst ab, wenn sie erneut mit confirm=true aufgerufen werden; ein sorgfältiger Agent zeigt Ihnen diese Vorschau und wartet, und die Agentenregeln oben weisen ihn genau dazu an. Ein API-Schlüssel kennt kein Ausgabenlimit — geben Sie einem Agenten also einen Schlüssel, den Sie jederzeit löschen können. ### Was kann der Agent über MCP nicht? Das Wallet aufladen, API-Schlüssel verwalten, Kontoeinstellungen ändern, IP-Adressen prüfen oder die Aktionen für mobile Proxys nutzen, etwa das Zurücksetzen der IP. Das bleibt dem Dashboard und der REST API vorbehalten. ### Brauche ich einen API-Schlüssel? Nicht, wenn sich Ihr Client anmelden kann. Eine Anfrage ohne Anmeldung und ohne Schlüssel wird abgewiesen, mit einem Verweis auf die Anmeldung bei ProxyJam — so starten claude.ai, Claude Code, Cursor und die anderen Clients die Anmeldung von selbst. Clients, die sich nicht anmelden können, senden stattdessen einen API-Schlüssel. ### Wie erlaube ich Ausgaben nachträglich oder ziehe die Erlaubnis zurück? Verbinden Sie sich erneut und erteilen Sie die Freigabe mit oder ohne Häkchen im Kästchen: Jede Freigabe ersetzt die vorherige. In Claude Code heißt das zum Beispiel: /mcp aufrufen und sich erneut bei proxyjam anmelden. ### Wie entziehe ich einem Agenten den Zugriff? Einen angemeldeten Client widerrufen Sie unter „Verknüpfte Apps“ in den Einstellungen des Dashboards; er ist innerhalb von fünf Minuten gesperrt, und Ihre übrigen Verbindungen funktionieren weiter. Wenn Sie Ihr Passwort ändern oder sich überall abmelden, werden alle auf einmal widerrufen. Einen API-Schlüssel löschen Sie auf der Seite „API-Schlüssel“; ein Schlüssel mit Ablaufdatum verliert seine Gültigkeit außerdem von selbst. ### Kann sich ein Agent selbst registrieren? Ja, mit Einschränkungen. Ein Agent ohne Konto im Hintergrund kann sich registrieren und erhält einen Schlüssel, der nur den öffentlichen Katalog lesen kann. Übernehmen Sie diesen Schlüssel mit dem Code, den ProxyJam Ihnen per E-Mail schickt, wird er Ihrem Konto zugeordnet und kann Ihre Bestellungen und Ihr Wallet lesen — Geld ausgeben kann er aber nie. Die Schritte für Agenten stehen in auth.md. ## Klein anfangen Verbinden Sie den Server, fragen Sie nach Angeboten und sehen Sie sich an, was zurückkommt, bevor Sie einen Agenten irgendetwas bestellen lassen. Wenn es ans Kaufen geht, zeigt die Vorschau Angebot, Preis und Ihr Guthaben — abgebucht wird erst, wenn Sie Ja sagen. ## Quellen - [Model Context Protocol — Transports](https://modelcontextprotocol.io/specification/2025-06-18/basic/transports) — der Transport Streamable HTTP, über den dieser Server kommuniziert - [MCP-Server-Card](/.well-known/mcp/server-card.json) — Endpunkt, Transport und Authentifizierung, für Agenten, die ProxyJam selbstständig finden - [auth.md](/auth.md) — wie sich ein Agent anmeldet, registriert oder einen API-Schlüssel nutzt - [Metadaten des OAuth-Autorisierungsservers](/.well-known/oauth-authorization-server) — die Endpunkte und Scopes, die ein Client bei der Anmeldung ermittelt - [Agent-Skill von ProxyJam](/.well-known/agent-skills/proxyjam/SKILL.md) — die Nutzungsanleitung, die ein Agent vor seinem ersten Aufruf laden kann MCP, das [Model Context Protocol](https://modelcontextprotocol.io/), ist der offene Standard, über den KI-Assistenten externe Tools aufrufen. Richten Sie einen MCP-Client auf den Server von ProxyJam, und Ihr Agent kann in Ihrem Konto das meiste von dem tun, was ein API-Schlüssel in der REST API kann. Zwei Dinge sollten Sie vorab wissen. **Sie legen fest, was er darf.** Ein Client, der sich anmeldet, bittet Sie zuerst um Ihre Freigabe. Lesen wird als ein Block gewährt, und dazu gehören die Logins und Passwörter Ihrer Proxys; Ausgaben aus Ihrem Wallet — und damit auch die kostenlosen Einstellungsänderungen — sind ein eigenes Kästchen, das Sie nur anhaken, wenn der Agent handeln soll. Bei einem API-Schlüssel ist das anders: Er öffnet das ganze Konto, melden Sie sich also lieber an, wo Ihr Client das unterstützt. **Geld fließt erst nach einer Vorschau.** Die drei kostenpflichtigen Tools buchen beim ersten Aufruf nie etwas ab. Sie liefern eine mit `dry_run` gekennzeichnete Vorschau und buchen erst ab, wenn sie erneut mit `confirm=true` aufgerufen werden — und ein sorgfältiger Agent tut das erst nach Ihrem Ja.