# Servidor MCP para agentes de IA | ProxyJam Conecta Claude, Cursor y otros clientes MCP a tu cuenta de ProxyJam: busca ofertas, compra y renueva proxies, controla el tráfico. Sin tu sí, no hay compra. - Canonical: https://proxyjam.com/es/mcp/ - Updated: 2026-10-14 - Language: es 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í. 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. 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. ## 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. ## El dinero solo se mueve cuando tú lo dices 1. **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. 2. **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. 3. **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. 4. **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. 5. **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. 6. **El acceso termina cuando lo revocas.** Un cliente con sesión iniciada aparece en *Apps conectadas*, en los [ajustes del panel](https://app.proxyjam.com/settings); 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](https://app.proxyjam.com/apikey). ## Conéctalo en tres pasos 1. **Añade el servidor a tu cliente** Elige tu cliente arriba y copia su configuración. La dirección es `https://proxyjam.com/mcp`. 2. **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](https://app.proxyjam.com/apikey): empieza por `pj_` y solo se muestra una vez. 3. **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)](/es/isp-proxies/). 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. ## 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. ### Claude (Anthropic) claude.ai, Claude Desktop y las apps móviles comparten una misma lista de conectores. 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. Guía completa en la documentación: https://docs.proxyjam.com/mcp-server#claude-ai-and-claude-desktop ### Claude Code (Anthropic) 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. ``` claude mcp add --transport http proxyjam https://proxyjam.com/mcp ``` Guía completa en la documentación: https://docs.proxyjam.com/mcp-server#claude-code ### Cursor (Anysphere) ~/.cursor/mcp.json, o .cursor/mcp.json dentro de un proyecto. Cursor te pide que inicies sesión la primera vez que se conecta. ``` { "mcpServers": { "proxyjam": { "url": "https://proxyjam.com/mcp" } } } ``` Guía completa en la documentación: https://docs.proxyjam.com/mcp-server#cursor ### ChatGPT (OpenAI) ChatGPT se identifica y abre el inicio de sesión de ProxyJam. 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. Guía completa en la documentación: https://docs.proxyjam.com/mcp-server#chatgpt ### Codex CLI (OpenAI) Ejecuta los dos en una terminal; el segundo abre tu navegador para que inicies sesión. ``` codex mcp add proxyjam --url https://proxyjam.com/mcp codex mcp login proxyjam ``` Guía completa en la documentación: https://docs.proxyjam.com/mcp-server#codex-cli ### VS Code (Microsoft) .vscode/mcp.json, con una clave API. VS Code te pide la clave una sola vez y la guarda de forma segura. ``` { "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}" } } } } ``` Guía completa en la documentación: https://docs.proxyjam.com/mcp-server#vs-code ### Gemini CLI (Google) Ejecútalo en una terminal y luego escribe /mcp auth proxyjam en Gemini CLI para iniciar sesión. ``` gemini mcp add --transport http proxyjam https://proxyjam.com/mcp ``` Guía completa en la documentación: https://docs.proxyjam.com/mcp-server#gemini-cli ### OpenAI Agents SDK (OpenAI) Python, con una clave 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()) ``` Guía completa en la documentación: https://docs.proxyjam.com/mcp-server#openai-agents-sdk ### FastMCP (Prefect) Python. pip install fastmcp. Inicia sesión a través de tu navegador y lista las herramientas. ``` 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()) ``` Guía completa en la documentación: https://docs.proxyjam.com/mcp-server#generic-fastmcp-client-python ## 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. 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. ### Comprar con vista previa Solo cobra después de tu sí. 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. ### Renovar Amplía un pedido, con vista previa primero. 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. ### Uso y saldo Pedidos, tráfico y dinero en una sola respuesta. 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. ### Ajustes Cambios que no cuestan nada. 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. ### Reglas del agente Para CLAUDE.md, AGENTS.md o las reglas de Cursor. 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. ## Las 16 herramientas | 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 | 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. ## 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 ## 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](https://modelcontextprotocol.io/specification/2025-06-18/basic/transports) — el transporte Streamable HTTP que usa este servidor - [Tarjeta del servidor MCP](/.well-known/mcp/server-card.json) — el endpoint, el transporte y la autenticación, para los agentes que descubren ProxyJam por su cuenta - [auth.md](/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](/.well-known/oauth-authorization-server) — los endpoints y los scopes que descubre un cliente al iniciar sesión - [Skill de agente de ProxyJam](/.well-known/agent-skills/proxyjam/SKILL.md) — la guía de uso que un agente puede cargar antes de su primera llamada MCP, el [Model Context Protocol](https://modelcontextprotocol.io/), 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í.