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

# 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

{
  "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
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:

# 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