Acceso remoto

Accede a SimpliGen desde un agente ejecutándose en un VPS u otra máquina a través de un túnel seguro.

View as Markdown Open in ChatGPT Open in Claude

Por defecto, un agente se conecta a SimpliGen en la misma máquina. Si ejecutas tu agente en otro lugar, como en un VPS, aún puedes acceder a SimpliGen a través de un túnel seguro, sin cambios en la aplicación.

La idea

El servicio de control de SimpliGen solo escucha en localhost, por seguridad. El truco es tunelizar el localhost de la máquina remota al localhost de tu máquina SimpliGen. Un túnel inverso SSH hace exactamente eso, y SSH se encarga de toda la encriptación y autenticación.

Lo que necesitas

SimpliGen ejecutándose en tu máquina de inicio, con un token de emparejamiento (crea uno en Settings -> Connect an agent -> Manual setup).
El puerto control-API. En Windows está en %APPDATA%\simpligen\agent-api.json, por ejemplo 48199.
Acceso SSH desde tu máquina de inicio a la máquina remota.

Abre el túnel

Desde tu máquina de inicio (donde se ejecuta SimpliGen), abre un túnel inverso a la máquina remota. Reemplaza 48199 con tu puerto y user@your-vps con tu servidor:

ssh -N -R 48199:localhost:48199 user@your-vps

Esto hace que localhost:48199 en la máquina remota se reenvíe a localhost:48199 en tu máquina de inicio. Mantenlo ejecutándose mientras el agente trabaja.

Configura el agente

En la máquina remota, configura el servidor MCP de tu agente con tu token y puerto:

{
  "mcpServers": {
    "simpligen": {
      "command": "npx",
      "args": ["-y", "@simpligen/mcp"],
      "env": {
        "SIMPLIGEN_TOKEN": "sg-agent-...",
        "SIMPLIGEN_API_PORT": "48199"
      }
    }
  }
}

SIMPLIGEN_API_PORT le dice al conector qué puerto usar, ya que la máquina remota no tiene una instalación de SimpliGen para detectarlo. Cada solicitud viaja por el túnel a SimpliGen en tu máquina de inicio.

Mantén ambos en ejecución

SimpliGen debe permanecer abierto en tu máquina de inicio, y el túnel debe mantenerse activo. Si alguno se detiene, el agente perderá su conexión hasta que lo reinicies.

Usando Tailscale o una red privada

Si usas una red de malla privada como Tailscale, ejecuta el mismo túnel SSH inverso sobre ella para una conexión estable sin abrir ningún puerto en tu enrutador de inicio. La mecánica es idéntica: el localhost de la máquina remota aún se reenvía al localhost de tu máquina de inicio.

Una nota sobre seguridad

Debido a que el túnel termina en localhost en ambos extremos, no estás exponiendo SimpliGen a Internet público. SSH encripta y autentica la conexión, y tu token de emparejamiento autoriza al agente. Puedes revocar ese token desde Connected agents en cualquier momento para cortar el acceso.