# Meta Ads MCP Server - Railway Deploy

Server MCP per gestire le campagne Meta Ads da qualsiasi macchina.

## 🚀 Deploy su Railway

### 1. Prerequisiti
- Account Railway (https://railway.app)
- Token di accesso Meta Marketing API

### 2. Deploy

**Opzione A: Deploy da GitHub**
1. Fai push di questa cartella su un repo GitHub
2. Vai su Railway → New Project → Deploy from GitHub
3. Seleziona il repository
4. Railway farà il deploy automaticamente

**Opzione B: Deploy con Railway CLI**
```bash
# Installa Railway CLI
npm install -g @railway/cli

# Login
railway login

# Crea progetto e deploya
railway init
railway up
```

### 3. Configura le Variabili d'Ambiente

In Railway, vai su Settings → Variables e aggiungi:

| Variabile | Descrizione |
|-----------|-------------|
| `META_ACCESS_TOKEN` | Token di accesso Meta Marketing API |
| `META_APP_SECRET` | (Opzionale) App secret per refresh token |
| `META_APP_ID` | (Opzionale) App ID per OAuth |

### 4. Ottieni l'URL

Dopo il deploy, Railway ti fornirà un URL tipo:
```
https://meta-ads-mcp-production-xxxx.up.railway.app
```

## ⚙️ Configura Claude Desktop

Aggiungi questa configurazione a `claude_desktop_config.json`:

**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`

```json
{
  "mcpServers": {
    "meta-ads": {
      "url": "https://TUO-URL-RAILWAY.railway.app/mcp"
    }
  }
}
```

## 📡 Endpoints

| Endpoint | Descrizione |
|----------|-------------|
| `GET /` | Info server e configurazione |
| `GET /health` | Health check |
| `POST /mcp` | Endpoint MCP principale |
| `GET /sse` | Server-Sent Events |

## 🔐 Come ottenere il Meta Access Token

1. Vai su [Meta for Developers](https://developers.facebook.com)
2. Crea un'app o usa una esistente
3. Vai su Tools → Graph API Explorer
4. Seleziona la tua app
5. Aggiungi i permessi: `ads_management`, `ads_read`
6. Genera il token
7. (Opzionale) Converti in token a lunga durata

## 🧪 Test

Verifica che funzioni:
```bash
# Health check
curl https://TUO-URL.railway.app/health

# Risposta attesa:
# {"status":"ok","timestamp":"...","service":"meta-ads-mcp"}
```

## 💰 Costi Railway

- Piano Free: 500 ore/mese (sufficiente per uso personale)
- Piano Hobby: $5/mese (sempre attivo)

## 🔧 Troubleshooting

**Token scaduto**
- Rigenera il token su Meta for Developers
- Aggiorna la variabile `META_ACCESS_TOKEN` su Railway

**Errori di connessione**
- Verifica che l'URL sia corretto (con /mcp alla fine)
- Controlla i log su Railway Dashboard

**Permessi insufficienti**
- Verifica che il token abbia i permessi `ads_management` e `ads_read`