El servidor MCP de ProxyBox permite que tu asistente de IA trabaje con tus proxies. Le pides en español y él lista tus IPs, los prueba, solicita el cambio de IP, cotiza y arma la configuración para la herramienta que usas. Por dentro llama a la misma API del panel, con tu clave.
Funciona en Claude Desktop, Claude Code, Cursor y VS Code.
Qué necesitas
- Una cuenta en ProxyBox.
- Node.js 20 o superior instalado en la computadora. Para comprobarlo, ejecuta
node -ven la terminal. - Una clave de API, creada en Claves de API.
1. Crear la clave
En Claves de API, ponle un nombre (ej.: "Claude en el portátil") y elige el permiso:
- Solo lectura: la IA consulta catálogo, precios, proxies, pedidos y saldo. No prueba ni cambia nada.
- Lectura y escritura: la IA también prueba el proxy, solicita el cambio de IP y cancela la renovación.
La clave aparece una sola vez. La misma página ya muestra la configuración del MCP con la clave incluida.
2. Pegar la configuración
El bloque es el mismo en casi todos los programas. Cambia TU_CLAVE por la clave del paso 1:
{
"mcpServers": {
"proxybox": {
"command": "npx",
"args": ["-y", "https://proxybox.es/mcp/proxybox-mcp-0.1.0.tgz"],
"env": {
"PROXYBOX_TOKEN": "TU_CLAVE",
"PROXYBOX_SITE": "es"
}
}
}
}
PROXYBOX_SITE en es hace que todas las respuestas lleguen en español y que los enlaces de compra apunten a proxybox.es.
Dónde pegarlo en cada programa:
| Programa | Dónde va |
|---|---|
| Claude Desktop | Configuración → Desarrollador → Editar configuración (archivo claude_desktop_config.json) |
| Claude Code | Ejecuta claude mcp add-json proxybox '<el bloque "proxybox" de arriba>' o pégalo en el .mcp.json del proyecto |
| Cursor | Configuración → MCP → Añadir servidor (archivo ~/.cursor/mcp.json) |
| VS Code | Archivo .vscode/mcp.json, con la clave servers en lugar de mcpServers y "type": "stdio" dentro de proxybox |
Después de guardar, cierra y vuelve a abrir el programa. ProxyBox aparece en la lista de herramientas.
3. Pedir en español
Ejemplos que funcionan:
- "¿Qué proxies tengo y cuándo vencen?"
- "Prueba el proxy 123. Si no conecta, pide el cambio de IP."
- "Dame la configuración del primer proxy para Playwright en Python."
- "Exporta mis proxies en el formato de AdsPower."
- "¿Cuánto cuestan 5 IPs ISP de Brasil por un mes y dónde pago?"
Cómo funciona la compra en proxybox.es
En proxybox.es la compra y la renovación se pagan en el sitio, con el método de tu país (ver precios). Cuando pides comprar o renovar, la IA cotiza en dólares y te entrega el enlace del checkout. No usa saldo ni hace cobros por su cuenta. La renovación automática tampoco está disponible para cuentas de proxybox.es: renueva en el sitio antes del vencimiento.
Qué hace el MCP
| Herramienta | Qué hace | Clave |
|---|---|---|
| catalogo, cotar | Planes a la venta y precio exacto en dólares, con descuentos | lectura |
| listar_proxies, ver_proxy | Tus IPs; el detalle incluye usuario y contraseña | lectura |
| saldo, listar_pedidos, ver_pedido | Cuenta y pedidos | lectura |
| situacao_troca, listar_numeros_sms | Estado del cambio de IP y números SMS | lectura |
| exportar_proxy | Línea lista para AdsPower, GPM, Hidemium, GemLogin, MoreLogin, Dolphin, GoLogin, BitBrowser, URL HTTP o SOCKS5 | lectura |
| configurar_navegador | Código listo para Playwright, Puppeteer, Selenium, Browser Use, requests, curl o variables de entorno | lectura |
| testar_proxy, pedir_troca_ip | Prueba al momento y cambio de IP por fallo técnico | escritura |
| cancelar_renovacao | Desactiva la renovación (sin reembolso) | escritura |
| comprar, renovar_proxy | Cotización y enlace del checkout de proxybox.es | escritura |
Las reglas son las mismas del panel: el cambio de IP es por fallo técnico y los límites de llamadas por minuto son los de la API.
Problemas comunes
- "Clave inválida o revocada": la clave se borró o se copió incompleta. Genera otra en Claves de API.
- ProxyBox no aparece en el programa: comprueba que Node.js esté instalado (
node -v), que el archivo sea un JSON válido y reinicia el programa. - "Esta clave es de solo lectura": para probar o cambiar el IP, genera una clave de lectura y escritura.
Para que el asistente también navegue por los sitios con tu IP dedicada, consulta Playwright MCP con proxy.
Para elegir el tipo de IP para agentes de IA y recopilación de datos, consulta el proxy para agentes de IA.