Facebook Ads

Servidor MCP de Facebook/Meta Ads

Este proyecto proporciona un servidor MCP que actúa como interfaz con Meta Ads, permitiendo el acceso programático a los datos y funciones de gestión de Meta Ads.

claude_demo.mp4

Configuración fácil en un clic

Para una experiencia de configuración más sencilla, ofrecemos instaladores listos para usar:

👉 Descargar instalador - https://gomarble.ai/mcp

Únete a nuestra comunidad para obtener ayuda y actualizaciones

👉 Comunidad de Slack - AI in Ads

Prueba también el servidor MCP de Google Ads

👉 Google Ads MCP - Google Ads MCP

Qué hace

• Instala y configura el servidor MCP localmente
• Maneja automáticamente la configuración del entorno
• Solicita la autenticación del token de Meta durante el proceso, lo cual es opcional
• Si no se proporciona el token de acceso de Meta, se conecta al servidor de GoMarble para crear el token en tu nombre

Aviso importante

Esta configuración no requiere que obtengas manualmente un Token de Acceso de Desarrollador de Meta.

En su lugar, se conecta de forma segura al servidor de GoMarble para crear el token en tu nombre. GoMarble no almacena tu token: se guarda localmente en tu máquina para usarlo con el servidor MCP.

---

Configuración

Requisitos previos

• Python 3.10+
• Dependencias listadas en requirements.txt

1. (Opcional pero recomendado) Crear y activar un entorno virtual:

   python3 -m venv venv
   source venv/bin/activate  # On Windows use \`venv\Scripts\activate\`
   

   Usar un entorno virtual ayuda a gestionar las dependencias del proyecto de manera limpia [Fuente].
2. Instalar dependencias:

   pip install -r requirements.txt
   

3. Obtener el token de acceso de Meta: Consigue un Token de Acceso de Usuario de Meta con los permisos necesarios (por ejemplo, ads_read). Puedes generarlo a través del portal de desarrolladores de Meta. Sigue este enlace.

Uso con clientes MCP (por ejemplo, Cursor, Claude Desktop)

Para integrar este servidor con un cliente compatible con MCP, añade una configuración (Claude) similar a la siguiente. Reemplaza YOUR_META_ACCESS_TOKEN con tu token real y ajusta la ruta a server.py si es necesario.

{
  "mcpServers": {
    "fb-ads-mcp-server": {
      "command": "python",
      "args": [
        "/path/to/your/fb-ads-mcp-server/server.py",
        "--fb-token",
        "YOUR_META_ACCESS_TOKEN"
      ]
      // If using a virtual environment, you might need to specify the python executable within the venv:
      // "command": "/path/to/your/fb-ads-mcp-server/venv/bin/python",
      // "args": [
      //   "/path/to/your/fb-ads-mcp-server/server.py",
      //   "--fb-token",
      //   "YOUR_META_ACCESS_TOKEN"
      // ]
    }
  }
}

Reinicia la aplicación del cliente MCP después de realizar la actualización en la configuración.

(Nota: En Windows, es posible que necesites ajustar la estructura del comando o usar cmd /k según tu configuración).

Depuración del servidor

Ejecuta server.py, proporcionando el token de acceso mediante el argumento --fb-token.

python server.py --fb-token YOUR_META_ACCESS_TOKEN

Herramientas MCP disponibles

Este servidor MCP proporciona herramientas para interactuar con los objetos y datos de META Ads:

Nombre de la herramienta	Descripción
Lectura de cuentas y objetos
list_ad_accounts	Lista las cuentas publicitarias vinculadas al token.
get_details_of_ad_account	Recupera los detalles de una cuenta publicitaria específica.
get_campaign_by_id	Recupera los detalles de una campaña específica.
get_adset_by_id	Recupera los detalles de un conjunto de anuncios específico.
get_ad_by_id	Recupera los detalles de un anuncio específico.
get_ad_creative_by_id	Recupera los detalles de una pieza creativa de anuncio específica.
get_adsets_by_ids	Recupera los detalles de varios conjuntos de anuncios por sus ID.
Obtención de colecciones
get_campaigns_by_adaccount	Recupera las campañas dentro de una cuenta publicitaria.
get_adsets_by_adaccount	Recupera los conjuntos de anuncios dentro de una cuenta publicitaria.
get_ads_by_adaccount	Recupera los anuncios dentro de una cuenta publicitaria.
get_adsets_by_campaign	Recupera los conjuntos de anuncios dentro de una campaña.
get_ads_by_campaign	Recupera los anuncios dentro de una campaña.
get_ads_by_adset	Recupera los anuncios dentro de un conjunto de anuncios.
get_ad_creatives_by_ad_id	Recupera las piezas creativas asociadas con un anuncio.
Información y datos de rendimiento
get_adaccount_insights	Recupera información de rendimiento de una cuenta publicitaria.
get_campaign_insights	Recupera información de rendimiento de una campaña.
get_adset_insights	Recupera información de rendimiento de un conjunto de anuncios.
get_ad_insights	Recupera información de rendimiento de un anuncio.
fetch_pagination_url	Obtiene datos de una URL de paginación (por ejemplo, de información).
Historial de actividad/cambios
get_activities_by_adaccount	Recupera el historial de cambios de una cuenta publicitaria.
get_activities_by_adset	Recupera el historial de cambios de un conjunto de anuncios.

(Nota: La mayoría de las herramientas admiten parámetros adicionales como fields, filtering, limit, paginación, rangos de fechas, etc. Consulta las cadenas de documentación detalladas dentro de server.py para obtener la lista completa y la descripción de los argumentos de cada herramienta).

(Nota: Si tu token de acceso de Meta caduca, deberás generar uno nuevo y actualizar el archivo de configuración del cliente MCP con el nuevo token para continuar usando las herramientas).

Dependencias

• mcp (>=1.6.0)
• requests (>=2.32.3)

Licencia

Este proyecto está licenciado bajo la Licencia MIT.

---

Instalación mediante Smithery

Para instalar automáticamente el Servidor de Facebook Ads para Claude Desktop mediante Smithery:

npx -y @smithery/cli install @gomarble-ai/facebook-ads-mcp-server --client claude