Entorno de PRE: solo datos de prueba. Los correos solo llegan al equipo y los cobros son de prueba.
Guilda WorkDevelopers

CONFIGURACIÓN

Variables de entorno

Qué variable activa cada pieza — app, MCP remoto, herramientas conectadas.

Cada herramienta conectada es opcional por separado: sin su variable configurada, las tools de solo lectura de esa herramienta devuelven una lista vacía y las de escritura fallan con un mensaje claro — sin tumbar el resto del servidor. Esta página cubre las variables de la app y del servidor MCP; las de despliegue de cada pieza del stack Docker (contraseñas de base de datos, orígenes públicos...) están documentadas herramienta por herramienta en la guía de autoalojamiento.

La app en sí

VariablePara qué
GUILDA_SECRET_KEYFirma las cookies de sesión Flask — genera un valor real en producción (python -c "import secrets; print(secrets.token_hex(32))"), nunca dejes que se genere uno aleatorio en cada arranque.
GUILDA_HOSTInterfaz donde escucha serve.py — 127.0.0.1 en producción (Caddy hace de proxy inverso delante), no 0.0.0.0.
GUILDA_PORTPuerto interno del proceso Flask (por defecto 8000).

Servidor MCP remoto (ChatGPT)

VariablePara qué
MCP_REMOTO_ORIGINURL pública de mcp_server_remoto.py — el identificador que ChatGPT compara contra el token recibido (RFC8707).
HYDRA_PUBLIC_ORIGINURL pública de Ory Hydra — el issuer_url que ChatGPT descubre y usa para el registro dinámico de cliente y el login real.
MCP_REMOTO_PUERTOPuerto donde escucha el proceso (por defecto 8017) — Caddy le hace de proxy inverso, nunca se publica directo a internet.
VariablePara qué
MCP_REMOTO_CLIENTESNombres de clientes OAuth que pueden usar el MCP además de los que pasan por la pantalla de consentimiento (por defecto claude-desktop).
GUILDA_MCP_GRUPOS, GUILDA_MCP_SOLO_LECTURAPerfil del servidor MCP: grupos de herramientas expuestos y modo solo lectura.
GUILDA_MCP_LIMITE_POR_MINUTO, GUILDA_MCP_LIMITE_ESCRITURAS_POR_MINUTOLímites por persona (120 y 40 por defecto).
GUILDA_MCP_MAX_TEXTO, GUILDA_MCP_MAX_CHARSTamaño máximo de un texto (12 000) y de un listado (60 000) en las respuestas del MCP.

API y ayuda

VariablePara qué
GUILDA_API_LIMITE_POR_MINUTOPeticiones por minuto y persona en /api/v1 (600 por defecto).
GUILDA_API_LIMITE_ESCRITURAS_POR_MINUTO, GUILDA_API_LIMITE_PESADAS_POR_MINUTOCupos propios de las escrituras (200) y de las operaciones pesadas (20) por minuto y persona.
GUILDA_LIMITER_URIAlmacén de los límites de uso (en memoria por defecto; con varios procesos, Redis).
GUILDA_FICHAJE_AVISO_HORASHoras de jornada abierta tras las que se avisa de una salida olvidada.
GUILDA_FIREBASE_CREDENTIALS_PATHRuta al JSON de cuenta de servicio de Firebase para las notificaciones push a la app móvil. Sin ella, el push queda desactivado (las notificaciones dentro de la app siguen funcionando).
GUILDA_CSPPolítica de contenido de la app web: reportar (por defecto: el navegador avisa a /csp-report de lo que bloquearía, sin bloquear), forzar (bloquea los scripts que no sean del sitio ni lleven el nonce de la petición) o no.
GUILDA_AYUDA_URLDirección del centro de ayuda a la que enlaza cada pantalla (por defecto https://help. + el dominio del entorno, GUILDA_DOMINIO_BASE).

Herramientas conectadas (MCP y backoffice)

Cada tool de MCP que toca el stack compartido (sin tenant, ver Asistente de IA (MCP)) necesita el token de API de esa herramienta:

VariableHerramientaNota
ESPOCRM_API_KEYEspoCRM (CRM)
NEXTCLOUD_ADMIN_USER / _PASSWORDNextcloud (Drive)
OPENPROJECT_API_TOKENOpenProject (gestión de proyectos de equipo)
CHATWOOT_AGENT_API_TOKENChatwoot (Soporte)Token de un agente normal (su perfil → Ajustes de acceso a la API) — distinto de CHATWOOT_PLATFORM_API_TOKEN, que solo gestiona altas de usuarios.
METABASE_API_KEYMetabase (Analítica)
N8N_API_KEYn8n (Automatizaciones)
OUTLINE_API_TOKENOutline (Documentación)
SYNAPSE_BOT_ACCESS_TOKENSynapse/Matrix (Chat)Token de un usuario «bot» dedicado (créalo con register_new_matrix_user dentro del contenedor) — nunca reutilices el token de una persona real.
MINIO_ROOT_PASSWORDMinIO (Almacenamiento)
UPTIME_KUMA_API_KEYUptime Kuma (Monitorización)

Las 9 herramientas con parámetro tenant explícito no usan una única variable global — su credencial se genera y guarda automáticamente por tenant al aprovisionarlo (backoffice o cli.py crear-tenant), salvo el puñado de pasos manuales documentados en la guía de autoalojamiento para cada una.

No hay ninguna variable para Vaultwarden en esta lista, a propósito — queda excluido del MCP bajo cualquier circunstancia.