Guía: conecta tus proxies a tu IA (MCP)

El conector MCP de ProxySEO (Model Context Protocol) permite que tu asistente de IA —Claude Desktop, Claude Code, Codex, Cursor, LangChain…— use tus proxies dedicados directamente: listar tus IPs, obtener una lista lista para usar o comprobar que el proxy funciona, todo desde la conversación. La instalación lleva unos 5 minutos.

¿Solo quieres lo esencial? 1) genera tu API key en el panel, 2) descarga el conector, 3) pega la configuración en tu cliente de IA, 4) reinícialo. Detalle abajo.

1Genera tu API key

Entra en tu área de cliente → tu servicio de proxy → tarjeta «Acceso para agentes IA (MCP)» → botón «Generar API key».

Importante: la clave se muestra una sola vez. Cópiala y guárdala en un gestor de contraseñas. Si la pierdes, revócala y genera otra (puedes tener hasta 3 activas).

2Descarga el conector

Elige el binario de tu sistema operativo desde la última versión publicada:

Sistema	Archivo
Windows	proxy-mcp-windows-amd64.exe
macOS (Apple Silicon · M1/M2/M3)	proxy-mcp-darwin-arm64
macOS (Intel)	proxy-mcp-darwin-amd64
Linux (64 bits)	proxy-mcp-linux-amd64
Linux (ARM64)	proxy-mcp-linux-arm64

3Instala el conector

macOS

Linux

Windows

Abre Terminal y, en la carpeta de Descargas, da permisos y muévelo al PATH (ajusta el nombre del archivo a tu Mac):

chmod +x ~/Downloads/proxy-mcp-darwin-arm64
sudo mv ~/Downloads/proxy-mcp-darwin-arm64 /usr/local/bin/proxy-mcp

La primera vez, macOS puede bloquearlo por seguridad. Si pasa: Ajustes del Sistema → Privacidad y seguridad → «Abrir de todos modos», o ejecuta:

xattr -d com.apple.quarantine /usr/local/bin/proxy-mcp

chmod +x ~/Downloads/proxy-mcp-linux-amd64
sudo mv ~/Downloads/proxy-mcp-linux-amd64 /usr/local/bin/proxy-mcp

Crea una carpeta, por ejemplo C:\Tools\proxyseo\, y mueve ahí el archivo descargado. Renómbralo a proxy-mcp.exe para simplificar. La ruta completa será C:\Tools\proxyseo\proxy-mcp.exe (la necesitarás en el paso 4).

En la configuración de Windows, usa doble barra invertida en la ruta: C:\\Tools\\proxyseo\\proxy-mcp.exe

4Configura tu cliente de IA

Sustituye TU_API_KEY por la clave del paso 1 y, en Windows, la ruta del comando por la del paso 3.

Claude Desktop

Claude Code

Cursor / otros

Abre Claude Desktop → Ajustes → Desarrollador → Editar configuración. Eso abre el archivo claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Añade el bloque proxyseo dentro de mcpServers:

{
  "mcpServers": {
    "proxyseo": {
      "command": "/usr/local/bin/proxy-mcp",
      "env": {
        "PROXYSEO_API_KEY": "TU_API_KEY"
      }
    }
  }
}

Desde la terminal, en tu proyecto:

claude mcp add proxyseo /usr/local/bin/proxy-mcp \
  --env PROXYSEO_API_KEY=TU_API_KEY

O añade manualmente a .mcp.json en la raíz del proyecto el mismo bloque mcpServers que en Claude Desktop.

Cursor y la mayoría de clientes compatibles con MCP usan el mismo formato. En Cursor: Settings → MCP → Add new server, o edita ~/.cursor/mcp.json:

{
  "mcpServers": {
    "proxyseo": {
      "command": "/usr/local/bin/proxy-mcp",
      "env": {
        "PROXYSEO_API_KEY": "TU_API_KEY"
      }
    }
  }
}

Cualquier cliente MCP que acepte un comando por stdio es compatible: LangChain, Codex, agentes propios, etc.

5Reinicia y prueba

Cierra y vuelve a abrir tu cliente de IA por completo. Luego prueba con una frase como:

Lista mis proxies de ProxySEO y comprueba que funcionan.

Si todo está bien, tu IA usará las herramientas del conector y te devolverá tus IPs y su estado.

Herramientas disponibles

Herramienta	Qué hace
list_proxies	Lista todas las IPs de tu servicio en formato IP:puerto.
get_proxy	Devuelve un proxy listo para usar (URL de conexión o JSON con credenciales).
proxy_status	Estado de tu servicio: plan, tipo de autenticación, nº de IPs y puertos.
check_proxy	Comprueba en tiempo real que el proxy sale a internet y es anónimo.

Solución de problemas

El servidor no aparece en mi cliente de IA

Reinícialo por completo (no solo la ventana). Verifica que la ruta del command es correcta y que el archivo tiene permisos de ejecución (paso 3).

Error de autenticación / 401

La API key es incorrecta o fue revocada. Genera una nueva en el panel y actualízala en la configuración.

macOS dice que no puede verificar el desarrollador

Ejecuta el comando xattr del paso 3, o autorízalo en Ajustes → Privacidad y seguridad.

check_proxy falla

Espera 1–2 minutos tras activar el servicio (las IPs tardan un momento en propagarse) y reintenta. Si persiste, abre un ticket.

¿Necesitas ayuda? Abre un ticket desde tu área de cliente y te echamos una mano.