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í
| Variable | Para qué |
|---|---|
GUILDA_SECRET_KEY | Firma 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_HOST | Interfaz donde escucha serve.py — 127.0.0.1 en producción (Caddy hace de proxy inverso delante), no 0.0.0.0. |
GUILDA_PORT | Puerto interno del proceso Flask (por defecto 8000). |
Servidor MCP remoto (ChatGPT)
| Variable | Para qué |
|---|---|
MCP_REMOTO_ORIGIN | URL pública de mcp_server_remoto.py — el identificador que ChatGPT compara contra el token recibido (RFC8707). |
HYDRA_PUBLIC_ORIGIN | URL 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_PUERTO | Puerto donde escucha el proceso (por defecto 8017) — Caddy le hace de proxy inverso, nunca se publica directo a internet. |
| Variable | Para qué |
|---|---|
MCP_REMOTO_CLIENTES | Nombres 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_LECTURA | Perfil del servidor MCP: grupos de herramientas expuestos y modo solo lectura. |
GUILDA_MCP_LIMITE_POR_MINUTO, GUILDA_MCP_LIMITE_ESCRITURAS_POR_MINUTO | Límites por persona (120 y 40 por defecto). |
GUILDA_MCP_MAX_TEXTO, GUILDA_MCP_MAX_CHARS | Tamaño máximo de un texto (12 000) y de un listado (60 000) en las respuestas del MCP. |
API y ayuda
| Variable | Para qué |
|---|---|
GUILDA_API_LIMITE_POR_MINUTO | Peticiones por minuto y persona en /api/v1 (600 por defecto). |
GUILDA_API_LIMITE_ESCRITURAS_POR_MINUTO, GUILDA_API_LIMITE_PESADAS_POR_MINUTO | Cupos propios de las escrituras (200) y de las operaciones pesadas (20) por minuto y persona. |
GUILDA_LIMITER_URI | Almacén de los límites de uso (en memoria por defecto; con varios procesos, Redis). |
GUILDA_FICHAJE_AVISO_HORAS | Horas de jornada abierta tras las que se avisa de una salida olvidada. |
GUILDA_FIREBASE_CREDENTIALS_PATH | Ruta 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_CSP | Polí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_URL | Direcció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:
| Variable | Herramienta | Nota |
|---|---|---|
ESPOCRM_API_KEY | EspoCRM (CRM) | |
NEXTCLOUD_ADMIN_USER / _PASSWORD | Nextcloud (Drive) | |
OPENPROJECT_API_TOKEN | OpenProject (gestión de proyectos de equipo) | |
CHATWOOT_AGENT_API_TOKEN | Chatwoot (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_KEY | Metabase (Analítica) | |
N8N_API_KEY | n8n (Automatizaciones) | |
OUTLINE_API_TOKEN | Outline (Documentación) | |
SYNAPSE_BOT_ACCESS_TOKEN | Synapse/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_PASSWORD | MinIO (Almacenamiento) | |
UPTIME_KUMA_API_KEY | Uptime 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.