Self-hosted

Si prefieres no usar el servicio gestionado, puedes levantar FXCode tú mismo. La CLI y el servidor MCP se conectan a tu instalación cambiando la dirección del API; la app de escritorio, por ahora, abre siempre app.fxcode.dev.

Requisitos

FXCode es un monorepo con la aplicación web (Next.js), el API (Fastify + PostgreSQL), la CLI, la app de escritorio y este sitio. Necesitas:

• Node.js 20 o superior y pnpm 9
• PostgreSQL 14 o superior

git clone https://github.com/fazt/fxcode.git
cd fxcode
pnpm install

Variables de entorno

El API lee apps/api/.env. Lo mínimo:

DATABASE_URL="postgresql://usuario:contraseña@localhost:5432/fxcode"
JWT_SECRET="una-cadena-larga-y-aleatoria"
PORT=4000
FRONTEND_URL="http://localhost:3000"
APP_URL="http://localhost:3000"

La aplicación lee apps/web/.env.local:

AUTH_SECRET="otra-cadena-larga-y-aleatoria"
NEXTAUTH_URL="http://localhost:3000"
NEXT_PUBLIC_API_URL="http://localhost:4000"
BACKEND_URL="http://localhost:4000"

Todo lo demás es opcional y activa funciones concretas: correo (AWS SES), almacenamiento de adjuntos (S3; sin él se guardan en disco), IA (OpenAI o Gemini), reuniones (Google Meet o Zoom) y login con Google, Microsoft o GitHub (ver las variables AUTH_* en CLAUDE.md).

Base de datos y primer usuario

pnpm db:push        # crea las tablas
pnpm create-admin   # el primer usuario administrador
pnpm dev            # aplicación en :3000 y API en :4000

Entra en http://localhost:3000, y en Ajustes define los estados de tus tareas: marca cuál cuenta como terminado y cuál lleva la animación de progreso (por ejemplo «Working»).

Conectar las herramientas

fxc auth login --api-url https://api.tu-dominio.com -e tu@correo.dev

El servidor MCP usa la misma sesión de la CLI.