# FGJ Multimedios MCP Server

Servidor MCP para envío automático de correos institucionales de FGJ Multimedios.

## Características

- ✅ Envío de correos institucionales vía SMTP (Gmail)
- ✅ Contexto personalizado para respuestas de IA
- ✅ Integración con FastMCP Cloud y desarrollo local
- ✅ Firma automática de Bélgica Jiménez (Gerente General)

## 🔑 Autenticación - IMPORTANTE

**FastMCP Cloud y desarrollo local manejan la autenticación de manera diferente:**

### FastMCP Cloud (Producción)
- ❌ **NO** uses `auth=verifier` en el servidor
- ❌ **NO** envíes headers `Authorization: Bearer` desde el cliente
- ✅ FastMCP Cloud maneja la autenticación automáticamente
- ✅ Usa `app.py` como punto de entrada (sin autenticación)

### Desarrollo Local
- ✅ Usa `auth=verifier` en el servidor (`server.py`)
- ✅ Envía `Authorization: Bearer {token}` desde el cliente
- ✅ Configura `MCP_TOKEN` en `.env`

## Despliegue en FastMCP Cloud

### Paso 1: Preparar el Repositorio

1. Asegúrate de que tu código esté en un repositorio de GitHub
2. Verifica que tengas estos archivos:
   - ✅ `app.py` - Punto de entrada para FastMCP Cloud (SIN autenticación)
   - ✅ `requirements.txt` - Dependencias completas
   - ✅ `server.py` - Servidor local con autenticación (para desarrollo)

### Paso 2: Crear Proyecto en FastMCP Cloud

1. Ve a [FastMCP Cloud](https://fastmcp.cloud) e inicia sesión con tu cuenta de GitHub
2. Haz clic en "New Project" o "Crear Proyecto"
3. Selecciona tu repositorio de GitHub
4. Configura el proyecto:
   - **Nombre del proyecto**: `fgj-multimedios-mcp` (o el que prefieras)
   - **Punto de entrada**: `app.py` ⚠️ **IMPORTANTE: Usar app.py, NO server.py**
   - **Rama**: `main` o tu rama de desarrollo

### Paso 3: Configurar Variables de Entorno

En la configuración del proyecto, añade **SOLO** estas variables:

```
EMAIL_USER=tu-correo@gmail.com
EMAIL_PASS=tu-app-password-de-gmail
```

**⚠️ IMPORTANTE:**
- `EMAIL_PASS` debe ser una **Contraseña de Aplicación** de Gmail (no tu contraseña normal)
- ❌ **NO** agregues `MCP_TOKEN` en FastMCP Cloud - no es necesario
- ✅ FastMCP Cloud maneja la autenticación automáticamente

### Paso 4: Desplegar

1. Haz clic en "Deploy" o "Desplegar"
2. FastMCP Cloud construirá y desplegará tu servidor
3. Una vez completado, recibirás una URL como:
   ```
   https://tu-proyecto.fastmcp.app/api/mcp
   ```

### Paso 5: Actualizar Cliente

Actualiza tu `client.py` para usar la URL de FastMCP Cloud:

```python
client = MultiServerMCPClient(
    {
        "fgj-server": {
            "transport": "streamable_http",
            "url": "https://tu-proyecto.fastmcp.app/api/mcp",  # ← Cambia esto
            "headers": {
                "Authorization": f"Bearer {os.getenv('MCP_TOKEN')}"
            }
        }
    }
)
```

## Variables de Entorno Requeridas

| Variable | Descripción | Ejemplo |
|----------|-------------|---------|
| `EMAIL_USER` | Correo de Gmail para envío | `menymedia@gmail.com` |
| `EMAIL_PASS` | Contraseña de aplicación Gmail | `icph zmog qhlc nocx` |
| `MCP_TOKEN` | Token secreto para autenticación | `my-secret-token` |

## Uso Local

```bash
# Instalar dependencias
pip install -r requirements.txt

# Configurar variables de entorno
cp .env.example .env
# Edita .env con tus credenciales

# Ejecutar servidor
python server.py
```

El servidor estará disponible en `http://localhost:8000/api/mcp`

## Herramientas Disponibles

- `send_email`: Envía correos institucionales
- `email_context`: Prompt con contexto de FGJ Multimedios

## Solución de Problemas

### Error de Autenticación en FastMCP Cloud

Si recibes errores `401 Unauthorized` o problemas de autenticación:

1. **Verifica que usas `app.py` como punto de entrada** en FastMCP Cloud
   - `app.py` NO tiene autenticación (correcto para FastMCP Cloud)
   - `server.py` tiene autenticación (solo para desarrollo local)

2. **Verifica las variables de entorno en FastMCP Cloud:**
   ```bash
   EMAIL_USER=tu-correo@gmail.com
   EMAIL_PASS=app-password-de-gmail
   ```
   ❌ NO agregues `MCP_TOKEN` en FastMCP Cloud

3. **Ejecuta el test de conexión:**
   ```bash
   python test_fastmcp.py
   ```

4. **Revisa los logs en FastMCP Cloud Dashboard**
   - Busca errores de SMTP o autenticación
   - Verifica que el servidor esté "running"

### Error de Autenticación en Local

Si tienes problemas en desarrollo local:

1. **Verifica tu archivo `.env`:**
   ```bash
   EMAIL_USER=tu-correo@gmail.com
   EMAIL_PASS=app-password-de-gmail
   MCP_TOKEN=tu-token-secreto
   ```

2. **Inicia el servidor con autenticación:**
   ```bash
   python server.py
   ```

3. **Verifica que el cliente use localhost:**
   ```bash
   export MCP_URL=http://localhost:8000/api
   python client.py
   ```

### Archivos del Proyecto

- `app.py` → Para FastMCP Cloud (sin autenticación)
- `server.py` → Para desarrollo local (con autenticación)
- `server_cloud.py` → **DEPRECADO** (usar `app.py`)
- `client.py` → Cliente que detecta automáticamente el modo
- `test_fastmcp.py` → Prueba de conexión

## Notas

- Cada push a la rama `main` redeployará automáticamente el servidor
- Los logs están disponibles en el dashboard de FastMCP Cloud
- El servidor se reinicia automáticamente si hay errores
- El cliente detecta automáticamente si conecta a FastMCP Cloud o localhost