Skip to main content
Glama
Meta Ads MCP Server

Meta Ads MCP Server

by manolocinti

Meta Ads MCP Server - Railway Deploy

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

🚀 Deploy su Railway

1. Prerequisiti

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

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

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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server for managing ad campaigns across Google Ads, Meta, and more. Enables deploying campaigns, checking performance, and managing budgets from terminal or AI assistants.
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      MCP server to manage Meta Ads (Facebook/Instagram) campaigns, ad sets, insights, and audiences from Claude Code using natural language.
      9
      8 npm
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      A clean-room Meta Ads MCP server that lets you build, launch, and read Meta ad campaigns via Claude Code using a single system-user token.
      17
      MIT