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. |
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 (Proyectos) | |
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.