IR
irwinrodriguez.dev
ES EN DE
Volver a documentación

Instalación

Descarga

Descarga el instalador de FoxAgent para Windows:

Descargar FoxAgent

Windows x64 · Requiere administrador · Crea tu cuenta gratis y descarga la última versión desde tu portal, sin tarjeta.

FoxAgent va firmado digitalmente

Desde la 1.62.7, FoxAgent.McpHost.exe, FoxAgent.Broker.exe, FoxAgent.Bridge.dll, las herramientas de línea de comandos y el instalador llevan firma de editor a nombre de Irwin Alfredo Rodriguez Gimenez, con sello de tiempo. Para verlo: clic derecho sobre el fichero → Propiedades → Firmas digitales, o Get-AuthenticodeSignature en PowerShell, que tiene que decir Valid.

  • SmartScreen: el certificado es nuevo y Windows puede avisar todavía durante un tiempo. Si sale «Windows protegió tu PC», pulsa Más información: tiene que decir Editor: Irwin Alfredo Rodriguez Gimenez. Si lo dice, Ejecutar de todas formas; si dice «Editor desconocido», ese fichero no es el nuestro: no lo ejecutes.

Antes de instalar

El instalador de FoxAgent va firmado, pero el certificado es nuevo y Windows puede avisarte todavía la primera vez que lo ejecutes. Esto explica qué vas a ver, cómo seguir y cómo comprobar por tu cuenta que el fichero que has descargado es exactamente el que publicamos.

El aviso de SmartScreen

Si al ejecutarlo sale una ventana azul que dice «Windows protegió tu PC», pulsa «Más información» y mira el editor: tiene que ser Irwin Alfredo Rodriguez Gimenez. El aviso no significa que el fichero tenga nada malo: significa que Windows todavía no ha visto suficientes descargas con este certificado como para reconocerlo.

  1. Pulsa Más información.
  2. Pulsa Ejecutar de todas formas.

Antes de dar ese segundo clic, comprueba el hash: es la manera de saber que lo que vas a ejecutar es lo nuestro y no una copia alterada.

Si tu antivirus lo detiene

Algunos antivirus ponen en cuarentena instaladores poco frecuentes. Si te pasa, añade una exclusión para la carpeta de instalación, C:\Program Files\FoxAgent, y vuelve a ejecutarlo.

Si el antivirus es de la empresa y no puedes tocar sus reglas, pásale el SHA-256 de abajo a quien la administre: es lo que necesita para dar el fichero por bueno.

Comprueba lo que has descargado

Estos son los datos de la versión vigente y del día en que se publicó. El hash se calcula sobre el fichero tal cual sale del portal:

FicheroVersiónPublicadaTamañoSHA-256
FoxAgent-Setup-1.65.4.exe 1.65.4 18 oct 2026 63.5 MB 7A63BFBC94CE971D0A8387786EA16DC7B772CF9E168B7E38185068078F788B51

Para comprobarlo, abre PowerShell en la carpeta de descargas y ejecuta:

Calcular el SHA-256 del fichero descargado
Get-FileHash -Algorithm SHA256 "$HOME\Downloads\FoxAgent-Setup-1.65.4.exe"

Si el valor que sale coincide con el de la tabla, el fichero es el nuestro y está íntegro. Si no coincide, no lo ejecutes: vuelve a descargarlo y, si sigue sin coincidir, escríbenos a soporte@irwinrodriguez.dev.

Los hashes se vuelven a medir en cada versión publicada. Si has descargado una versión anterior, su hash no tiene por qué coincidir con el de esta tabla.

Requisitos del sistema

  • Windows 10 u 11 (x64), o Windows Server 2016 o posterior
  • .NET Framework 4.8, que necesita FoxAgent.Bridge por ser COM. Es lo único que hace falta tener ya instalado
  • Visual FoxPro 9.0 SP2, o VFP Advanced 10 o posterior, en la máquina donde desarrollas

El Broker y el McpHost son autocontenidos: llevan su runtime dentro y no hay que instalar ningún .NET aparte. Por eso el instalador solo comprueba .NET Framework 4.8, y te ofrece descargarlo si falta.

Qué hace el instalador

Estas cuatro cosas, sin preguntar más de lo necesario:

  1. Instala los componentes
    • FoxAgent.Broker.exe: el registro de instancias conectadas
    • FoxAgent.McpHost.exe: el que habla MCP con tu cliente de IA
    • FoxAgent.Bridge.dll: el puente COM que vive dentro de tu proceso VFP
    • El SDK\: las dos clases base, la plantilla y los ejemplos
  2. Registra el Bridge como componente COM
    • Para que VFP pueda crearlo con CREATEOBJECT("FoxAgent.Bridge"). El RegAsm que usa es el de .NET Framework 4.x, no el de .NET moderno.
  3. Instala el Broker como servicio de Windows
    • El servicio FoxAgentBroker queda con arranque automático y se pone en marcha en ese momento. Se ve en services.msc.
  4. Configura tu cliente de IA si lo encuentra
    • Configura Claude Desktop y OpenCode si están instalados. Para los demás deja el bloque MCP ya montado, con la ruta real puesta, en C:\Program Files\FoxAgent\mcp-foxagent.json. Un cliente MCP no es opcional: sin él no hay agente.

Comprobar la instalación

Después de instalar, comprueba que el servicio está corriendo:

Comprobar que el servicio del Broker está corriendo
# En PowerShell o CMD:
sc query FoxAgentBroker

# Debería decir: STATE: 4 RUNNING

También puedes abrir services.msc y buscar «FoxAgent Broker» en la lista.

Carpeta de instalación Por defecto, FoxAgent se instala en C:\Program Files\FoxAgent, sin el (x86): aunque el Bridge sea x86 por vivir dentro de VFP, el instalador va en modo 64 bits. El SDK está en C:\Program Files\FoxAgent\SDK.

Orden de arranque

Siempre en este orden. Si abres tu cliente de IA antes de que tu aplicación se haya registrado, no verá ninguna instancia.

  1. FoxAgent.Broker: servicio de Windows, arranque automático
  2. Tu aplicación VFP: se registra con Connect()
  3. El cliente MCP: Claude Desktop, Claude Code o cualquier otro

Modo evaluación

Sin fichero de licencia, FoxAgent funciona en modo evaluación: una instancia VFP y una herramienta propia. Las 55 herramientas integradas no tienen límite. No caduca y no pide tarjeta.

Tu ID de máquina

La licencia Developer va atada a la máquina donde desarrollas, así que la compra te pide su ID: 16 caracteres hexadecimales. Cualquiera de estas tres formas te lo da.

Tres formas de obtener el ID de máquina
# 1. Desde la línea de comandos
"C:\Program Files\FoxAgent\FoxAgent.Broker.exe" --machine-id

# 2. Desde el navegador, con el servicio arrancado
http://localhost:7400/license      -> campo "machineId"

# 3. Con restart-broker.cmd, que lo imprime al terminar

Los guiones y las mayúsculas dan igual: pégalo en el checkout tal y como salga.

Instalar tu licencia

  1. Descarga el fichero .lic desde el detalle de tu licencia, en el portal.
  2. Guárdalo como foxagent.lic junto a FoxAgent.Broker.exe (mayúsculas y minúsculas dan igual). En otra carpeta no lo encuentra, y si lo descargaste como foxagent (1).lic o foxagent.lic.txt, renómbralo.
  3. Ejecuta restart-broker.cmd como administrador. El Broker lee la licencia solo al arrancar: copiar el fichero no basta por sí solo.

El propio script consulta http://localhost:7400/license y te dice cómo ha quedado. Mira el campo mode:

ValorQué ha pasado
"Licensed"La licencia está activa
"Evaluation"No la ha cogido: comprueba el nombre del fichero y que esté en esa carpeta
"MaintenanceExpired"La licencia es válida, pero este build es más nuevo de lo que cubre tu mantenimiento. Mientras tanto funciona con los límites de evaluación: instala el build anterior o renueva y sustituye el .lic
"LicenseExpired"Se acabó la prueba de 30 días. FoxAgent sigue arrancando, con los límites de evaluación, y esa misma salida trae tu machineId para comprar
¿Cambiaste de máquina? La licencia solo arranca en la máquina a la que está atada. Si has cambiado de equipo, escríbeme y te la reemito.

Siguientes pasos