Conecta tu agente de IA a ProxyJam

El servidor MCP de ProxyJam pone 16 herramientas de tu cuenta al alcance de Claude, Cursor y otros clientes de IA: buscar ofertas, comprar y renovar proxies, consultar el tráfico y el saldo. Tú inicias sesión y decides qué puede hacer el agente, y todo lo que cuesta dinero te enseña antes una vista previa y no sigue hasta que digas que sí.

Elige tu cliente

Necesitas una cuenta de ProxyJam. La mayoría de los clientes inician sesión con ella; el resto usa una clave API. El servidor en sí es gratuito: solo pagas los proxies que compre tu agente.

Elige tu cliente

Elige uno para ver cómo conectarlo. La mayoría de los clientes inician sesión con tu cuenta de ProxyJam; VS Code y el OpenAI Agents SDK usan una clave API, así que sustituye pj_... por la tuya.

Anthropic

Claude

claude.ai, Claude Desktop y las apps móviles. Añade ProxyJam una vez como conector personalizado y aparecerá en los tres.

Ver configuraciónOcultar configuraciónInicio de sesión

Claude

1. En Claude, abre los ajustes de conectores y añade un conector personalizado.
2. Ponle de nombre ProxyJam y pega https://proxyjam.com/mcp como dirección del servidor.
3. Conéctalo, inicia sesión en ProxyJam y aprueba el acceso.

claude.ai, Claude Desktop y las apps móviles comparten una misma lista de conectores.

Guía completa en la documentación

Anthropic

Claude Code

El agente de programación de Anthropic para la terminal. Un comando añade el servidor, y con /mcp inicias sesión.

Ver configuraciónOcultar configuraciónInicio de sesión

Claude Code

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

Ejecútalo en una terminal; luego escribe /mcp en Claude Code, elige proxyjam e inicia sesión. Añade --scope user para usarlo en todos tus proyectos.

Guía completa en la documentación

Anysphere

Cursor

El editor de código con IA. Añade el servidor a mcp.json y Cursor te pedirá que inicies sesión la primera vez que se conecte.

Ver configuraciónOcultar configuraciónInicio de sesión

Cursor

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

~/.cursor/mcp.json, o .cursor/mcp.json dentro de un proyecto. Cursor te pide que inicies sesión la primera vez que se conecta.

Guía completa en la documentación

OpenAI

ChatGPT

Los conectores personalizados requieren el modo desarrollador, que OpenAI ofrece en versión beta en algunos planes.

Ver configuraciónOcultar configuraciónInicio de sesión

ChatGPT

1. En los ajustes de ChatGPT, activa el modo desarrollador y crea un conector personalizado.
2. Introduce https://proxyjam.com/mcp como URL y elige OAuth.
3. Inicia sesión en ProxyJam y aprueba el acceso.

ChatGPT se identifica y abre el inicio de sesión de ProxyJam.

Guía completa en la documentación

OpenAI

Codex CLI

El agente de programación de OpenAI para la terminal. Dos comandos: uno añade el servidor y el otro inicia sesión.

Ver configuraciónOcultar configuraciónInicio de sesión

Codex CLI

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

Ejecuta los dos en una terminal; el segundo abre tu navegador para que inicies sesión.

Guía completa en la documentación

Microsoft

VS Code

El modo agente de Copilot Chat. Se conecta con una clave API, que VS Code te pide una sola vez y guarda de forma segura.

Ver configuraciónOcultar configuraciónClave 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 clave API. VS Code te pide la clave una sola vez y la guarda de forma segura.

Guía completa en la documentación

Google

Gemini CLI

El agente de Google para la terminal. Añade el servidor y luego inicia sesión con /mcp auth proxyjam.

Ver configuraciónOcultar configuraciónInicio de sesión

Gemini CLI

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

Ejecútalo en una terminal y luego escribe /mcp auth proxyjam en Gemini CLI para iniciar sesión.

Guía completa en la documentación

OpenAI

OpenAI Agents SDK

Framework de Python para crear tus propios agentes. Se conecta con una clave API en una cabecera de la solicitud.

Ver configuraciónOcultar configuraciónClave 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 clave API. pip install openai-agents.

Guía completa en la documentación

Prefect

FastMCP

Biblioteca de Python para clientes y servidores MCP. Inicia sesión a través de tu navegador y lista las herramientas.

Ver configuraciónOcultar configuraciónInicio de sesión

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. Inicia sesión a través de tu navegador y lista las herramientas.

Guía completa en la documentación

En resumen: ProxyJam ofrece un servidor MCP remoto en https://proxyjam.com/mcp sobre Streamable HTTP. Tu cliente de IA inicia sesión con tu cuenta de ProxyJam (OAuth) o envía una clave API, y obtiene 16 herramientas: nueve de lectura, cuatro que cambian ajustes y tres que gastan dinero — y esas tres se quedan en una vista previa hasta que confirmas.

MCP, el Model Context Protocol, es el estándar abierto con el que los asistentes de IA llaman a herramientas externas. Apunta un cliente MCP al servidor de ProxyJam y tu agente podrá hacer en tu cuenta casi todo lo que permite una clave API en la API REST. Antes de empezar, conviene saber dos cosas.

Tú decides qué puede hacer. Un cliente que inicia sesión te pide primero tu aprobación. La lectura se concede en bloque e incluye los usuarios y contraseñas de tus proxies; el gasto desde tu billetera, y con él los cambios de ajustes gratuitos, es una casilla aparte que solo marcas si quieres que el agente actúe. Con una clave API es distinto: abre toda la cuenta, así que, si tu cliente lo permite, mejor inicia sesión.

El dinero se mueve después de una vista previa. Las tres herramientas que cuestan dinero nunca cobran en la primera llamada. Devuelven una vista previa marcada como dry_run y solo cobran cuando se las vuelve a llamar con confirm=true, algo que un agente prudente hace únicamente después de que digas que sí.

QUÉ PUEDE HACER TU AGENTE

Dieciséis herramientas, seis tareas

Explorar el catálogo

list_offers busca ofertas en vivo por tipo, país, región y ciudad, y devuelve cada tarifa con su precio. Es la única herramienta que da los identificadores de oferta, así que toda compra empieza aquí.

Comprar proxies

create_proxy_order compra de 1 a 50 proxies de una oferta. La primera llamada solo muestra el precio y tu saldo; el pedido se hace cuando confirmas.

Renovar y añadir tráfico

extend_proxy_period renueva un proxy por otro periodo y buy_proxy_bandwidth añade tráfico a uno estático. Las dos muestran antes una vista previa y solo cobran cuando confirmas.

Consultar pedidos y tráfico

Tus pedidos con sus datos de conexión, y el tráfico que ha consumido cada proxy o todos juntos. Son de solo lectura: el agente puede llamarlas tantas veces como quiera sin riesgo.

Seguir la pista al dinero

El saldo de tus billeteras en cada moneda y el historial completo de transacciones, de una en una o página a página. También de solo lectura.

Cambiar ajustes

Pasa un proxy de HTTP a SOCKS5 o al revés, sustituye su lista blanca de IP, activa o desactiva la renovación automática o actualiza su estado. Nada de esto cuesta dinero, pero un cliente con sesión iniciada necesita tener permitido el gasto para hacerlo.

SEGURIDAD

El dinero solo se mueve cuando tú lo dices

Por defecto, solo lectura. Cuando un cliente inicia sesión, ProxyJam te muestra lo que pide. La lectura de tus pedidos, tu billetera y el catálogo se concede en bloque — y los pedidos incluyen los usuarios y contraseñas de tus proxies. El gasto es una casilla aparte, Permitir gastos de mi billetera, que aparece sin marcar y que también cubre los cambios de ajustes gratuitos.
Primero, la vista previa. create_proxy_order, extend_proxy_period y buy_proxy_bandwidth empiezan con confirm=false: devuelven la oferta, el precio y tu saldo, y no cobran nada.
Primero tu sí, después el cargo. El agente vuelve a llamar con confirm=true solo cuando has aprobado la vista previa. Las reglas para el agente que encontrarás en los prompts de abajo lo dicen con todas las letras.
Sin cobros dobles. La llamada de confirmación reutiliza la idempotency_key de la vista previa, así que si la solicitud se reintenta, devuelve el primer resultado en lugar de comprar dos veces. Cada compra nueva lleva una clave nueva.
Una clave API abre toda la cuenta. Las claves del panel no admiten permisos más acotados: lo permiten todo, leer y gastar incluidos. Inicia sesión siempre que tu cliente lo permita, y ponle fecha de caducidad a cualquier clave que uses.
El acceso termina cuando lo revocas. Un cliente con sesión iniciada aparece en Apps conectadas, en los ajustes del panel; revócalo ahí y dejará de funcionar en cinco minutos como mucho. Cambiar la contraseña o cerrar sesión en todos los dispositivos revoca todas las conexiones. Una clave deja de funcionar en cuanto la eliminas en la página Claves API.

CONFIGURACIÓN

Conéctalo en tres pasos

Añade el servidor a tu cliente
Elige tu cliente arriba y copia su configuración. La dirección es https://proxyjam.com/mcp.
Inicia sesión y decide qué puede hacer
El cliente abre ProxyJam en tu navegador. Inicia sesión, lee lo que pide y marca Permitir gastos de mi billetera solo si el agente va a comprar, renovar o cambiar ajustes. Cada aprobación sustituye a la anterior, así que puedes volver a conectarte más adelante para cambiarlo. Un cliente que no puede iniciar sesión usa en su lugar una clave API: empieza por pj_ y solo se muestra una vez.
Empieza con un prompt de solo lectura
Pide primero las ofertas — el mismo catálogo en vivo que ves en la página de proxies residenciales estáticos (ISP). Así compruebas que la conexión funciona y el agente obtiene los identificadores de oferta que necesita para todo lo demás. Después, prueba los prompts de abajo.

Con el servidor MCP de ProxyJam, muéstrame las ofertas de proxies residenciales estáticos (ISP) en Estados Unidos con sus precios mensuales. No hagas ningún pedido.

Compra en ProxyJam un proxy residencial estático (ISP) en Estados Unidos por un mes. Primero enséñame la vista previa — la oferta, el precio y el saldo de mi billetera — y espera a que te dé un sí explícito antes de confirmar. Al confirmar, reutiliza la misma clave de idempotencia.

Amplía un mes mi pedido de ProxyJam ORDER_ID. Enséñame la vista previa con el precio y mi saldo, y espera a que te diga que sí antes de confirmar.

Muéstrame mis proxies activos de ProxyJam con su fecha de caducidad y el tráfico que ha consumido cada uno; después, el saldo de mi billetera en USD y mis últimas 10 transacciones.

Para mi pedido de ProxyJam ORDER_ID: cambia el protocolo a SOCKS5, establece la lista blanca de IP en 203.0.113.7 y activa la renovación automática. Después dime cómo han quedado los ajustes.

Cuando uses el servidor MCP de ProxyJam:
- Llama primero a list_offers. Es la única fuente de identificadores de oferta.
- create_proxy_order, extend_proxy_period y buy_proxy_bandwidth son solo vistas previas hasta que se llaman con confirm=true. Enséñame la vista previa y nunca confirmes sin mi aprobación expresa.
- Confirma con la misma idempotency_key que la vista previa. Usa una clave nueva para cada compra nueva.
- Si la vista previa muestra un saldo inferior al precio, detente y avísame en lugar de confirmar.
- Si una herramienta se rechaza porque el gasto no está permitido, avísame en lugar de reintentar; yo decido si vuelvo a conectarme con el gasto permitido.
- Trata mi clave API como un secreto: nunca la muestres, no la escribas en logs ni la guardes en un archivo que yo pueda compartir.

PROMPTS

Prompts para probar

Pega uno en el chat de tu agente cuando el servidor esté conectado. Sustituye ORDER_ID por un número de pedido de tu panel. La última pestaña es un conjunto de reglas para dejar fijas en las instrucciones de tu agente.

Buscar un proxy Solo lectura. Una primera llamada sin riesgo. Comprar con vista previa Solo cobra después de tu sí. Renovar Amplía un pedido, con vista previa primero. Uso y saldo Pedidos, tráfico y dinero en una sola respuesta. Ajustes Cambios que no cuestan nada. Reglas del agente Para CLAUDE.md, AGENTS.md o las reglas de Cursor.

REFERENCIA

Las 16 herramientas

Las herramientas que el servidor ofrece hoy. Las tres que gastan dinero devuelven una vista previa hasta que se las vuelve a llamar con confirm=true. Un cliente con sesión iniciada solo puede usar las siete últimas si has permitido el gasto.
Herramienta	Qué hace	Efecto
list_offers	Busca en el catálogo por tipo, país, región y ciudad; devuelve identificadores de oferta y tarifas	Solo lectura
list_my_orders	Lista tus pedidos de proxies, página a página	Solo lectura
get_order	Un pedido completo, con los datos de conexión del proxy	Solo lectura
get_my_traffic_summary	Tráfico consumido por todos tus proxies activos	Solo lectura
get_order_traffic	Tráfico consumido por un pedido	Solo lectura
list_my_wallets	Tus billeteras, una por moneda	Solo lectura
get_wallet_balance	El saldo de una billetera	Solo lectura
list_wallet_transactions	El historial de transacciones de una billetera, página a página	Solo lectura
get_transaction	Una transacción	Solo lectura
create_proxy_order	Compra de 1 a 50 proxies de una oferta	Gasta dinero, con vista previa antes
extend_proxy_period	Renueva un proxy activo por otro periodo	Gasta dinero, con vista previa antes
buy_proxy_bandwidth	Añade de 1 a 5.000 GB de tráfico a un proxy estático	Gasta dinero, con vista previa antes
set_auto_renew	Activa o desactiva la renovación automática	Cambia ajustes, gratis
set_proxy_whitelist	Sustituye la lista de IP autorizadas a usar el proxy	Cambia ajustes, gratis
change_proxy_protocol	Cambia entre HTTP y SOCKS5	Cambia ajustes, gratis
sync_proxy_state	Vuelve a leer el estado actual del proxy	Cambia ajustes, gratis

SERVIDOR

Datos de conexión

Endpoint: https://proxyjam.com/mcp
Transporte: Streamable HTTP
Autenticación: Inicio de sesión con tu cuenta de ProxyJam (OAuth 2.1) o una clave API en la cabecera X-API-Key
Acceso: Lectura por defecto; gasto y cambios de ajustes solo si los permites
Listas de referencia: Estados de pedido, monedas, protocolos de proxy, tipos de oferta y métodos de pago, como recursos MCP
Precio: Gratis. Solo pagas los proxies que compres

DOCUMENTACIÓN

Para saber más

Guía del servidor MCP Los argumentos de cada herramienta y un pedido de ejemplo

Guía rápida Del registro a la primera llamada a la API

Autenticación Crear claves, ponerles caducidad y revocarlas

Idempotencia Cómo se evitan los cobros dobles al reintentar

Referencia de la API Todos los endpoints REST, ejecutables en el navegador

Especificación OpenAPI La API descrita para generadores de código

FAQ

Preguntas sobre el servidor MCP

¿Qué clientes de IA pueden conectarse?

Cualquier cliente MCP que se conecte a un servidor remoto por Streamable HTTP y que, o bien inicie sesión con OAuth, o bien te deje añadir una cabecera a la solicitud. Las configuraciones de arriba cubren Claude (claude.ai, Claude Desktop y las apps móviles), Claude Code, Cursor, ChatGPT, VS Code, Codex CLI, Gemini CLI, el OpenAI Agents SDK y FastMCP.

¿Puedo conectarlo a claude.ai o a ChatGPT?

Sí. En Claude, añade un conector personalizado con la dirección https://proxyjam.com/mcp e inicia sesión en ProxyJam; el conector aparecerá también en Claude Desktop y en las apps móviles. En ChatGPT, los conectores MCP personalizados requieren el modo desarrollador, que OpenAI ofrece en versión beta en algunos planes; añade la misma dirección y elige OAuth.

¿Cuesta algo el servidor MCP?

No. Conectarse y llamar a las herramientas es gratis. Solo pagas lo que compre tu agente, a los mismos precios que en el panel, con cargo a tu billetera de ProxyJam.

¿Puede mi agente gastar dinero sin preguntarme?

No por accidente. Un cliente que inicia sesión no puede gastar nada a menos que hayas marcado *Permitir gastos de mi billetera* al aprobarlo. Aun así, las tres herramientas que cobran — comprar, renovar y añadir tráfico — devuelven una vista previa en la primera llamada y solo cobran cuando se las vuelve a llamar con confirm=true; un agente prudente te enseña esa vista previa y espera, y las reglas para el agente de más arriba se lo indican. Una clave API no tiene límite de gasto, así que dale al agente una clave que puedas eliminar.

¿Qué no puede hacer el agente por MCP?

Recargar la billetera, gestionar las claves API, cambiar los ajustes de la cuenta, comprobar direcciones IP ni usar las acciones de los proxies móviles, como restablecer la IP. Todo eso sigue en el panel y en la API REST.

¿Necesito una clave API?

No, si tu cliente inicia sesión. Una solicitud que no lleva ni sesión ni clave se rechaza con una indicación que apunta al inicio de sesión de ProxyJam, y así es como claude.ai, Claude Code, Cursor y los demás clientes lo inician por su cuenta. Los clientes que no pueden iniciar sesión envían una clave API en su lugar.

¿Cómo permito el gasto más adelante, o cómo lo retiro?

Vuelve a conectarte y aprueba con la casilla marcada o sin marcar: cada aprobación sustituye a la anterior. En Claude Code, por ejemplo, basta con /mcp y volver a iniciar sesión en proxyjam.

¿Cómo revoco el acceso de un agente?

Si el cliente inició sesión, revócalo en Apps conectadas, dentro de los ajustes del panel; dejará de funcionar en cinco minutos como mucho, y tus demás conexiones seguirán funcionando. Cambiar la contraseña o cerrar sesión en todos los dispositivos las revoca todas a la vez. Si es una clave API, elimínala en la página Claves API; una clave creada con fecha de caducidad también deja de funcionar por sí sola.

¿Puede un agente registrarse por su cuenta?

Sí, con límites. Un agente sin ninguna cuenta detrás puede registrarse y obtener una clave que solo lee el catálogo público. Si reclamas esa clave con el código que ProxyJam te envía por correo, pasa a formar parte de tu cuenta y puede leer tus pedidos y tu billetera, pero nunca podrá gastar. Los pasos para agentes están en auth.md.

Empieza poco a poco

Conéctate, pide las ofertas y lee lo que te devuelve antes de dejar que un agente compre nada. Cuando llegue el momento de comprar, la vista previa te muestra la oferta, el precio y tu saldo, y no se cobra nada hasta que digas que sí.

Fuentes

Model Context Protocol — Transportes — el transporte Streamable HTTP que usa este servidor
Tarjeta del servidor MCP — el endpoint, el transporte y la autenticación, para los agentes que descubren ProxyJam por su cuenta
auth.md — cómo inicia sesión un agente, cómo se registra o cómo usa una clave API
Metadatos del servidor de autorización OAuth — los endpoints y los scopes que descubre un cliente al iniciar sesión
Skill de agente de ProxyJam — la guía de uso que un agente puede cargar antes de su primera llamada

Conecta tu agente de IA a ProxyJam

Elige tu cliente

Claude

Claude Code

Cursor

ChatGPT

Codex CLI

VS Code

Gemini CLI

OpenAI Agents SDK

FastMCP

Dieciséis herramientas, seis tareas

Explorar el catálogo

Comprar proxies

Renovar y añadir tráfico

Consultar pedidos y tráfico

Seguir la pista al dinero

Cambiar ajustes

El dinero solo se mueve cuando tú lo dices

Conéctalo en tres pasos

Añade el servidor a tu cliente

Inicia sesión y decide qué puede hacer

Empieza con un prompt de solo lectura

Prompts para probar

Las 16 herramientas

Datos de conexión

Para saber más

Preguntas sobre el servidor MCP

Empieza poco a poco

Fuentes