Proxidize MCP

---

Resumen

Servidor MCP para la API de Proxidize. Brinda a Claude, Cursor y otros clientes MCP acceso directo a tu infraestructura de proxies — sin necesidad de cambiar de pestaña en el panel.

Al iniciar, verifica qué suscripciones de Proxidize están activas en tu cuenta y registra solo las herramientas relevantes. El plan Per Proxy obtiene herramientas de gestión de proxies, Per GB obtiene herramientas de uso y puntos de acceso, y así sucesivamente.

---

Inicio Rápido

Requiere Node.js 18 o superior.

Claude Code

Elige un alcance y ejecuta su comando.

Local (predeterminado) — solo este proyecto, privado para ti:

claude mcp add proxidize -e PROXIDIZE_API_TOKEN=YOUR_API_TOKEN -- npx -y @proxidize/mcp

Usuario — todos tus proyectos, privado para ti:

claude mcp add proxidize --scope user -e PROXIDIZE_API_TOKEN=YOUR_API_TOKEN -- npx -y @proxidize/mcp

Proyecto — compartido con tu equipo mediante .mcp.json. Establece PROXIDIZE_API_TOKEN en tu entorno y refiérelo con la expansión ${VAR} para que el token no quede en el control de versiones:

claude mcp add --scope project proxidize -- npx -y @proxidize/mcp

Ejecuta /mcp dentro de Claude Code para verificar la conexión.

Claude Desktop

Agrega a claude_desktop_config.json:

{
  "mcpServers": {
    "proxidize": {
      "command": "npx",
      "args": ["-y", "@proxidize/mcp"],
      "env": {
        "PROXIDIZE_API_TOKEN": "YOUR_API_TOKEN"
      }
    }
  }
}

Cursor / Windsurf / VS Code

Agrega a .mcp.json o a la configuración MCP de tu IDE:

{
  "mcpServers": {
    "proxidize": {
      "command": "npx",
      "args": ["-y", "@proxidize/mcp"],
      "env": {
        "PROXIDIZE_API_TOKEN": "YOUR_API_TOKEN"
      }
    }
  }
}

Obtén tu token de API

1. Inicia sesión en el Panel de Proxidize
2. Haz clic en el menú desplegable del avatar → Configuración
3. Copia tu token de API

Nota: El acceso a proxies requiere verificación de identidad. Se requiere KYC (identificación oficial con foto) para todas las cuentas antes de que los servicios de proxy sean utilizables; las cuentas comerciales que necesiten hilos de conexión ilimitados o acceso a categorías de sitios restringidas por verificación también necesitan KYB (verificación comercial, a través de ventas).

---

Herramientas Disponibles

Cuenta

Herramienta	Descripción
get_subscription	Lista suscripciones activas, opcionalmente filtradas por un tipo de plan
get_outbound_ip	Obtén la IP pública de la máquina que ejecuta este servidor MCP (para listas blancas de IP)

Per Proxy

Herramienta	Descripción
list_proxies	Lista todos los proxies con IPs, URLs de conexión listas para usar, velocidades, uso y etiquetas
get_proxy	Obtén detalles de un solo proxy por ID de sesión
rotate_proxy	Rota la IP de un proxy y obtén la IP anterior y la nueva, opcionalmente bloqueada a una ciudad o operador
rotate_proxy_url	Rota un proxy usando su token de rotación
set_rotation_interval	Configura la rotación automática (60 segundos a 7 días) o desactívala con -1
update_proxy_password	Cambia la contraseña de todos los proxies
list_proxy_locations	Lista ciudades de EE. UU. disponibles con velocidades promedio
list_proxy_carriers	Lista operadores móviles disponibles, filtrables por ubicación
create_ip_whitelist	Agrega IPs de origen a la lista blanca para acceso a proxies
list_tags	Lista todas las etiquetas de proxies
create_tag	Crea una nueva etiqueta
delete_tag	Elimina una etiqueta (se desasigna de todos los proxies)
tag_proxy	Asigna una etiqueta a una sesión de proxy
untag_proxy	Elimina una etiqueta de una sesión de proxy

Proxies Móviles Per GB

Prefijados con mobile_. Solo se registran si tienes una suscripción móvil Per GB activa.

Herramienta	Descripción
mobile_get_usage	Saldo de datos — bytes usados y disponibles
mobile_list_locations	Ciudades disponibles con velocidades, filtrables por operador, país o estado
mobile_list_carriers	Operadores disponibles, filtrables por país
mobile_get_settings	Configuración del proxy del punto de acceso
mobile_list_access_points	Lista sub-usuarios que comparten tu grupo de datos
mobile_create_access_point	Crea un nuevo sub-usuario
mobile_create_ip_whitelist	Agrega IPs a la lista blanca con opciones de ubicación/operador/protocolo
mobile_update_ip_whitelist	Actualiza una entrada existente de la lista blanca
mobile_update_settings	Actualiza el enrutamiento del punto de acceso (ciudad, operador, protocolo)

Analítica

Registrada cuando al menos un plan está activo. Respaldada por el servicio de analítica de Proxidize; la superficie de consulta puede evolucionar.

Herramienta	Descripción
get_traffic_analytics	Ancho de banda y conteos de solicitudes/fallos a lo largo del tiempo, por sesión de proxy o punto de acceso
get_top_domains	Dominios de destino principales clasificados por volumen de datos y por número de solicitudes
get_connection_history	Registro por solicitud: URL, método, estado, duración, bytes, IP de origen, geo ascendente, errores

Proxies Residenciales Per GB

Igual que los móviles, prefijados con residential_. Solo se registran con una suscripción residencial activa.

Herramienta	Descripción
residential_get_usage	Saldo de datos residenciales
residential_list_locations	Ubicaciones residenciales disponibles, filtrables por operador, país o estado
residential_list_carriers	Operadores residenciales disponibles, filtrables por país
residential_get_settings	Configuración del punto de acceso
residential_list_access_points	Lista sub-usuarios residenciales
residential_create_access_point	Crea un sub-usuario residencial
residential_create_ip_whitelist	Agrega IPs a la lista blanca para proxies residenciales
residential_update_ip_whitelist	Actualiza una entrada de lista blanca residencial
residential_update_settings	Actualiza el enrutamiento del punto de acceso (ciudad, operador, protocolo)

---

Configuración

Variables de Entorno

Variable	Requerida	Predeterminado	Descripción
PROXIDIZE_API_TOKEN	Sí	—	Tu token de API de Proxidize
PROXIDIZE_BASE_URL	No	https://api.proxidize.com/api/v1	URL base de la API. Debe ser una URL HTTPS *.proxidize.com, o una dirección de bucle local (localhost/127.0.0.1) para pruebas locales — cualquier otra cosa se rechaza al inicio para que tu token de API nunca se envíe a otro host
PROXIDIZE_PROXY_HOST	No	pg.proxi.es	Host de puerta de enlace de proxy utilizado en las URLs de conexión
PROXIDIZE_TIMEOUT	No	30000	Tiempo de espera de solicitud en milisegundos
PROXIDIZE_MAX_RETRIES	No	2	Máximo de reintentos en errores del servidor (0-5)
PROXIDIZE_DISABLE_ANALYTICS	No	—	Establece a 1 para deshabilitar la analítica de uso anónima (DO_NOT_TRACK=1 también funciona)

Descubrimiento de herramientas

Al iniciar, el servidor consulta la API de suscripciones para descubrir tus planes activos. Las herramientas se registran por plan:

• per_proxy_mobile → 14 herramientas de gestión de proxies
• per_gb_mobile → 9 herramientas móviles
• per_gb_residential → 9 herramientas residenciales
• Cualquier plan activo → 3 herramientas de analítica
• Siempre cargadas → get_subscription, get_outbound_ip

Sin suscripción, sin herramientas específicas de suscripción. Nada se expone que tu cuenta no pueda usar.

Analítica de uso

El servidor recopila analítica de uso anónima (qué herramientas se llaman, latencia y tasas de error) a través de PostHog para ayudarnos a mejorarlo. Las respuestas de las herramientas y los argumentos de las llamadas nunca se envían — solo el nombre de la herramienta, el tiempo y el éxito/fallo. Puedes optar por no participar en cualquier momento estableciendo PROXIDIZE_DISABLE_ANALYTICS=1 (o el estándar DO_NOT_TRACK=1) en el entorno del servidor.

---

Clientes Compatibles

Funciona con cualquier cliente compatible con MCP:

• Claude Code (CLI, Desktop, Web)
• Claude Desktop
• Cursor
• Windsurf
• VS Code (con la extensión MCP)

---

Solución de Problemas

"PROXIDIZE_API_TOKEN is required"

Establece la variable de entorno en la configuración de tu servidor MCP. Consulta Inicio Rápido.

El servidor se conecta pero solo muestra get_subscription y get_outbound_ip

El descubrimiento de suscripciones falló o no encontró planes activos. Verifica que tu token de API sea válido (regéneralo desde el panel de Proxidize en Configuración) y que tu cuenta tenga una suscripción activa.

Las herramientas devuelven "HTTP 401: Invalid token"

Verifica que el token no se haya regenerado desde que configuraste el servidor.

Errores de tiempo de espera

Aumenta el tiempo de espera: establece PROXIDIZE_TIMEOUT a 60000 en tu configuración de entorno.

---

Desarrollo

Para ejecutar desde el código fuente en lugar de npm:

git clone https://github.com/proxidize/proxidize-mcp.git
cd proxidize-mcp
npm install
npm run build

Luego apunta tu cliente MCP a la salida de compilación — por ejemplo, claude mcp add proxidize -e PROXIDIZE_API_TOKEN=YOUR_API_TOKEN -- node /path/to/proxidize-mcp/dist/index.js.

Ejecuta la suite de pruebas con npm test (no se necesitan credenciales — inicia el servidor contra una API simulada).

---

Licencia

MIT