Servidor MCP de Facebook/Meta Ads
Este proyecto proporciona un servidor MCP que actúa como interfaz de Meta Ads, permitiendo el acceso programático a los datos de Meta Ads y a las funciones de gestión.
claude_demo.mp4
Fácil configuración con un solo clic
Para una experiencia de configuración más simple, ofrecemos instaladores listos para usar:
👉 Descargar instalador -https://gomarble.ai/mcp
Únete a nuestra comunidad para obtener ayuda y actualizaciones
👉 Comunidad 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 de forma local
- Gestiona automáticamente la configuración del entorno
- Solicita autenticación Meta token durante el proceso que es opcional
- Si no se proporciona el token de acceso Meta, se conecta al servidor de GoMarble para crear el token en su nombre
Aviso importante
Esta configuración no requiere que obtenga manualmente un token de acceso de desarrollador Meta.
En su lugar, se conecta de forma segura al servidor de GoMarble para crear el token en su nombre. GoMarble no almacena su token - se guarda localmente en su máquina para su uso con el servidor MCP.
Configuración
Requisitos previos
- Python 3.10+
- Dependencias listadas en
requirements.txt
- (Opcional pero recomendado) Crear y activar un entorno virtual:
python3 -m venv venv
source venv/bin/activate # En Windows usevenv\Scripts\activate
Usar un entorno virtual ayuda a gestionar las dependencias del proyecto de forma limpia[Fuente]. - Instalar dependencias:
pip install -r requirements.txt - Obtener Meta Access Token: Obtén un Token de Acceso de Usuario Meta con los permisos necesarios (por ejemplo,
ads_read). Puedes generarlo a través del portal Meta Developer. 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. Sustituye YOUR_META_ACCESS_TOKEN por tu token real y ajusta la ruta a server.py si es necesario.
{ "mcpServidores": { "fb-ads-mcp-server": { "command": "python", "args": [ "/ruta/a/tu/servidor/fb-ads-mcp/servidor.py", "--fb-token", "TU_META_ACCESO_TOKEN" ] // Si usas un entorno virtual, puede que necesites especificar el ejecutable python dentro del venv: // "command": "/ruta/a/tu/servidor/fb-ads-mcp/venv/bin/python", // "args": [ // "/ruta/su/servidor/fb-ads-mcp/servidor.py", // "--fb-token", // "YOUR_META_ACCESS_TOKEN" // ] } }
Reinicie la aplicación Cliente MCP después de realizar la actualización en la configuración.
(Nota: En Windows, es posible que tenga que ajustar la estructura del comando o utilizar cmd /k en función de su configuración)
Depuración del servidor
Ejecute server.py, proporcionando el token de acceso mediante el argumento --fb-token.
python servidor.py --fb-token TU_META_TOKEN_ACCESO
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 de anuncios vinculadas al token. |
| obtener_detalles_de_cuenta_anuncio | Recupera los detalles de una cuenta publicitaria específica. |
| get_campaign_by_id | Obtiene detalles de una campaña específica. |
| get_adset_by_id | Obtiene detalles de un conjunto de anuncios específico. |
| get_ad_by_id | Obtiene detalles de un anuncio específico. |
| get_ad_creative_by_id | Obtiene detalles de una creatividad de anuncio específica. |
| get_adsets_by_ids | Recupera detalles de varios conjuntos de anuncios por sus ID. |
| Obtención de colecciones | |
| get_campaigns_by_adaccount | Recupera campañas dentro de una cuenta publicitaria. |
| get_adsets_por_cuenta_anuncial | Recupera los conjuntos de anuncios de una cuenta publicitaria. |
| get_ads_by_adaccount | Recupera anuncios de una cuenta publicitaria. |
| get_adsets_by_campaign | Recupera los conjuntos de anuncios de una campaña. |
| get_ads_by_campaign | Recupera anuncios de una campaña. |
| get_ads_by_adset | Recupera anuncios de un conjunto de anuncios. |
| get_ad_creatives_by_ad_id | Recupera las creatividades asociadas a un anuncio. |
| Información y datos de rendimiento | |
| get_adaccount_insights | Recupera información sobre el rendimiento de una cuenta de anuncios. |
| get_campaign_insights | Obtiene información sobre el rendimiento de una campaña. |
| get_adset_insights | Obtiene información sobre el rendimiento de un conjunto de anuncios. |
| get_ad_insights | Obtiene información sobre el rendimiento de un anuncio. |
| fetch_pagination_url | Obtiene datos de una URL de paginación (por ejemplo, de insights). |
| Historial de actividades/cambios | |
| get_activities_by_adaccount (obtener actividades por cuenta de anuncio) | Recupera el historial de cambios de una cuenta de anuncios. |
| 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 campos, filtrado, límite, paginación, intervalos de fechas, etc.). Consulte los docstrings detallados dentro de server.py para obtener la lista completa y la descripción de argumentos de cada herramienta)
(Nota: Si tu token de acceso a Meta caduca, tendrás que generar uno nuevo y actualizar el archivo de configuración del Cliente MCP con el nuevo token para seguir utilizando las herramientas)
Dependencias
- mcp (>=1.6.0)
- requests (>=2.32.3)
Licencia
Este proyecto está licenciado bajo la Licencia MIT.
Instalación a través de Smithery
Para instalar Facebook Ads Server para Claude Desktop automáticamente a través de Smithery:
npx -y @smithery/cli install @gomarble-ai/facebook-ads-mcp-server --client claude