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:

4. Ottieni l'URL

Dopo il deploy, Railway ti fornirà un URL tipo:

https://meta-ads-mcp-production-xxxx.up.railway.app

Related MCP server: flour-ads

⚙️ 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

🔐 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