Meta Ads MCP Server (Facebook & Instagram, 1-click connect)

Conecta Claude, ChatGPT o Cursor a Meta Ads con un clic: inicia sesión con Facebook, 12 herramientas, Insights, Ad Library, leads. Sin configuración, sin aplicación de desarrollador.

Documentación

Meta Ads MCP Server: ejecuta tus anuncios de Facebook e Instagram desde Claude o ChatGPT

Pega un enlace en Claude o ChatGPT, inicia sesión con Facebook, y tu IA podrá leer y gestionar tus anuncios de Facebook e Instagram. Sin cuenta de desarrollador, nada que instalar, aproximadamente un minuto de configuración. Todo lo que está debajo del enlace es la referencia completa para ti y tu agente de IA.

Tu enlace MCP

https://connector.get-ryze.ai/mcp

Guía de configuración completa ↓

Configúralo en 3 pasos, aproximadamente 1 minuto

  1. 01Copia tu enlace MCP:https://connector.get-ryze.ai/mcp
  2. 02En Claude ve a Configuración → Conectores → Añadir conector personalizado. Nómbralo Ryze AI, pega el enlace, haz clic en Añadir. En ChatGPT es Configuración → Apps → Crear app.
  3. 03Haz clic en Conectar, inicia sesión con Facebook, elige tu espacio de trabajo. Abre un nuevo chat y pregunta: "¿Cuál de mis anuncios desperdició más dinero este mes?"

Funciona en Claude, ChatGPT, Cursor y Claude Code · Conexión gratuita · Guía de configuración completa

Diagram of the Ryze AI Meta Ads MCP server: Claude, ChatGPT, Cursor and Claude Code on the left connect through one server URL, https://connector.get-ryze.ai/mcp, with OAuth 2.0 and approval-gated writes, to Facebook and Instagram ad accounts on the right — 12 Meta Ads tools including runRawInsights, runGraphRead, runGraphWrite, searchAdLibrary and listLeads.

Una URL entre tu cliente de IA y Meta Ads

01 — Resumen

Qué hace este servidor MCP de Meta Ads

La versión corta

  1. Una URL, https://connector.get-ryze.ai/mcp, funciona en Claude, ChatGPT, Claude Code, Cursor y cualquier cliente MCP.
  2. Inicia sesión con Facebook. Sin app de desarrollador de Meta, sin token de acceso, sin revisión de app, sin servidor que ejecutar.
  3. 12 herramientas de Meta Ads: 9 de lectura (Insights, lecturas de Graph, creativos, clientes potenciales, Biblioteca de Anuncios) y 3 de escritura, cada una con aprobación.
  4. El mismo endpoint incluye Google Ads, TikTok, GA4, Search Console y Shopify — más de 150 herramientas en total.
  5. Conexión gratuita. Ads Autopilot de pago cuesta $89/mes fijos si quieres que Ryze AI ejecute las optimizaciones por ti.

meta_ads · especificación del servidorOAuth2

Nombre del servidor

Ryze AI (Meta Ads MCP)

Endpoint

https://connector.get-ryze.ai/mcp

Transporte

MCP remoto sobre HTTP Streamable

Autenticación

OAuth 2.0 (inicio de sesión con Facebook, un espacio de trabajo de Ryze por conexión)

Alojamiento

Alojado por Ryze AI — nada que instalar o ejecutar

Herramientas de Meta Ads

12 (9 de lectura · 3 de escritura, con aprobación)

También en este endpoint

Google Ads, TikTok, GA4, Search Console, Shopify — más de 150 herramientas

App de desarrollador / token

No requerido

Precio

Conexión gratuita · Ads Autopilot de pago $89/mes fijos

Actualizado

3 de septiembre de 2026

MCP (Model Context Protocol) es el estándar abierto que los asistentes de IA usan para llamar a herramientas externas. Un servidor MCP de Meta Ads convierte tus cuentas de anuncios de Facebook e Instagram en un conjunto de esas herramientas, para que un asistente pueda diagnosticar un pico de CPM, clasificar creativos fatigados, exportar clientes potenciales o mover un presupuesto desde un chat en lugar de Ads Manager. La mayoría de los servidores MCP de Meta Ads en GitHub son procesos locales de Python que configuras con tu propia app de Meta y token de acceso; este está alojado, así que toda la configuración es una URL y un inicio de sesión con Facebook. La comparación más abajo cubre cuándo el autoalojamiento es la mejor opción.

/01

OAuth de Facebook gestionado

Inicio de sesión en el navegador con Facebook, tokens intercambiados y renovados en el servidor. Sin app de desarrollador de Meta, sin token de Marketing API, sin revisión de app.

/02

API de Insights sin procesar

runRawInsights informa a nivel de cuenta, campaña, conjunto de anuncios o anuncio con desgloses por edad, género, país, región, dispositivo, plataforma y ubicación, además de ventanas de atribución.

/03

Lecturas completas de Graph API

runGraphRead obtiene cualquier nodo o borde — campañas, conjuntos de anuncios, anuncios, creativos, audiencias, búsqueda de segmentación — y sigue los cursores de paginación.

/04

Escrituras con aprobación

Crea y actualiza campañas, conjuntos de anuncios, anuncios, creativos y presupuestos mediante aprobación por herramienta. Las eliminaciones y archivados usan una herramienta separada y explícita.

/05

Formularios de clientes potenciales y leads

Lista los formularios de clientes potenciales en una página de Facebook y exporta los leads que un formulario recopiló, directamente al chat.

/06

Búsqueda en la Biblioteca de Anuncios

Busca la Biblioteca de Anuncios pública de Meta por palabra clave o ID de página, filtrada por país y estado activo, con un enlace de captura por anuncio.

/07

Herramientas de creativos

Inspecciona el texto, los medios y los enlaces de cualquier creativo, y sube imágenes por URL para obtener el image_hash que necesita un anuncio nuevo.

/08

Seis plataformas, una URL

El mismo endpoint incluye los conjuntos de herramientas de Google Ads, TikTok, GA4, Search Console y Shopify — un solo inicio de sesión en lugar de seis servidores.

Six platforms on one MCP endpoint: Meta Ads (Facebook and Instagram), Google Ads, TikTok Ads, GA4, Google Search Console and Shopify all connect through the single Ryze AI server URL, 150+ tools in total, instead of six separate MCP servers.

Seis plataformas, un endpoint

02 — Referencia de herramientas

Las 12 herramientas de Meta Ads

Las herramientas de cuenta toman adAccountId en el formulario act_1234567890. Las lecturas y herramientas de leads con ámbito de página toman pageId, y el servidor intercambia el token de acceso de página que Meta requiere. Las herramientas de escritura están sujetas a aprobación.

HerramientaAccesoQué haceParámetros clave
getAccountSummarylecturaGasto, impresiones, CPM, CTR, conversiones y ROAS para un rango de fechas en la ventana de atribución predeterminada de Meta.adAccountId · period { startDate, endDate }
listAdAccountslecturaCada cuenta de anuncios de Meta a la que el usuario conectado puede acceder, con id (act_…), nombre y moneda. Llama a esta primero.ninguno
getCreativelecturaUn creativo por id: texto, medios, enlaces, object_story_spec y estado.creativeId
listCreativeslecturaCreativos en una cuenta, paginados para evitar banderas de límite de velocidad en cuentas grandes.adAccountId · limit (predeterminado 100, máximo 1,000)
listLeadFormslecturaFormularios de generación de leads en una página de Facebook, con estado y preguntas.pageId
listLeadslecturaLeads recopilados por un formulario. El servidor intercambia un token de acceso de página desde pageId.formId · pageId
runRawInsightslecturaCualquier consulta de Insights API: nivel, rango de fechas, campos, desgloses, filtros, ventanas de atribución e incrementos de tiempo.adAccountId · request { level, timeRange, fields, breakdowns, filtering, actionAttributionWindows, timeIncrement, limit }
runGraphReadlecturaGET de cualquier nodo o borde de Graph API, incluida la búsqueda de segmentación y lecturas con ámbito de página. Sigue paging.next hasta que esté ausente.path · fields · adAccountId · pageId
runGraphWriteescrituraPOST para crear o actualizar campañas, conjuntos de anuncios, anuncios, creativos, presupuestos, audiencias y videos. El estado ACTIVE/PAUSED vive aquí.path · params · adAccountId · pageId
runGraphDeleteescrituraEliminar o archivar. Campañas, conjuntos de anuncios y anuncios usan POST con estado DELETED o ARCHIVED; los bordes usan HTTP DELETE. Solo lista explícita aprobada.path · method (POST | DELETE) · params · adAccountId
searchAdLibrarylecturaBúsqueda en la Biblioteca de Anuncios pública por palabra clave o IDs de página: cuerpos de creativos, títulos, fechas de entrega, plataformas, URL de captura.searchTerms | pageIds · countries · adActiveStatus · fields · limit (≤ 100) · after
uploadImageFromUrlescrituraObtiene una URL de imagen, la sube a act_<id>/adimages y devuelve el image_hash para un creativo de anuncio.adAccountId · imageUrl

El mismo endpoint expone los conjuntos de herramientas de Google Ads, TikTok, GA4, Search Console y Shopify. La lista multiplataforma está en la referencia de API publicitaria y herramientas MCP; el lado de Google tiene su propia página en Google Ads MCP server.

03 — Requisitos previos

Qué necesitas antes de empezar

Necesitas

  • Un inicio de sesión de Facebook con acceso de administrador o anunciante a la cuenta de anuncios, normalmente a través de Business Manager. (Cómo otorgar acceso.)
  • Una cuenta gratuita de Ryze AI — creada durante el paso de OAuth si no tienes una.
  • Un cliente MCP: Claude Pro, Team o Max (los conectores personalizados no están en el plan gratuito), ChatGPT Plus, Pro o Business con modo Desarrollador, o Claude Code, Cursor, Windsurf, VS Code en cualquier plan.

No necesitas

  • Una app de desarrollador de Meta, revisión de app o un token de acceso de Marketing API. (Qué implica la ruta de API.)
  • Un usuario de sistema, un token de larga duración que rotar, o el permiso ads_management en tu propia app.
  • Python, Node, un entorno virtual, un archivo .env o un proceso que mantener en ejecución.

04 — Configuración

Instalación en cada cliente MCP

Todas las rutas terminan en la misma pantalla de OAuth: inicia sesión con Facebook, elige tu espacio de trabajo de Ryze, haz clic en Permitir. Una conexión se asigna a un espacio de trabajo, por lo que las agencias con varios espacios de trabajo de clientes se reconectan por espacio de trabajo. Las capturas de pantalla para la ruta de Claude están en cómo conectar Claude a Google y Meta Ads.

Claude (web y escritorio)

  1. 01En claude.ai, haz clic en tu avatar (abajo a la izquierda) → Configuración.
  2. 02Abre la pestaña Conectores y haz clic en Personalizar, luego en el + junto a Conectores.
  3. 03Nombre: Ryze AI. URL del servidor MCP remoto: https://connector.get-ryze.ai/mcp. Haz clic en Añadir.
  4. 04Haz clic en Conectar en el nuevo conector, inicia sesión con Facebook, elige tu espacio de trabajo y haz clic en Permitir que Claude se conecte.
  5. 05Una confirmación verde lista las herramientas disponibles. Inicia un nuevo chat y haz tu primera pregunta.

Requiere Claude Pro, Team o Max. La app de escritorio de Claude usa el mismo flujo de Configuración → Conectores; si prefieres el archivo de configuración, usa la entrada mcp-remote en "Archivo de configuración de Claude Desktop" más abajo.

ChatGPT

  1. 01 Configuración → Apps. En Configuración avanzada, activa Modo Desarrollador.
  2. 02Haz clic en Crear app. Nombre: Ryze AI. URL del servidor MCP: https://connector.get-ryze.ai/mcp — elige URL del servidor, no Tunnel.
  3. 03Autenticación: OAuth. Marca el reconocimiento y haz clic en Crear.
  4. 04En la página de autorización elige Iniciar sesión con Ryze AI, selecciona tu espacio de trabajo y haz clic en Permitir.
  5. 05Inicia un nuevo chat: "Trae los últimos 7 días de gasto y ROAS de Meta por campaña."

Requiere un plan de ChatGPT que admita apps y conectores (Plus, Pro o Business).

Claude Code

claude mcp add --transport http ryze https://connector.get-ryze.ai/mcp

Luego ejecuta /mcp dentro de Claude Code para completar el inicio de sesión OAuth. Añade --scope user para que esté disponible en todos los proyectos.

Cursor, Windsurf y cualquier cliente con mcp.json

mcp.json (Cursor:.cursor/mcp.json · Windsurf: mcp_config.json)json

{
  "mcpServers": {
    "ryze": {
      "url": "https://connector.get-ryze.ai/mcp"
    }
  }
}

Guarda y luego aprueba la solicitud OAuth que abre el cliente. Windsurf usa la clave serverUrl en lugar de url.

VS Code (modo agente de GitHub Copilot)

{
  "servers": {
    "ryze": {
      "type": "http",
      "url": "https://connector.get-ryze.ai/mcp"
    }
  }
}

Archivo de configuración de Claude Desktop (opcional)

{
  "mcpServers": {
    "ryze": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://connector.get-ryze.ai/mcp"]
    }
  }
}

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json. Reinicia Claude Desktop; la primera llamada abre el navegador para OAuth. La mayoría de las personas no necesitarán esto — Configuración → Conectores hace lo mismo sin Node.

05 — Uso

Qué preguntar una vez conectado

Informes

  • >"Trae los últimos 7 días de gasto, CPM, CTR y ROAS de Meta por campaña."
  • >"Crea mi informe de Meta del lunes: gasto, ROAS, top 5 de anuncios y qué corregir."
  • >"Desglosa el gasto del mes pasado por ubicación — ¿dónde está Instagram Reels vs Feed?"

CPM y fatiga creativa

  • >"¿Por qué subió mi CPM esta semana? Revisa la frecuencia y la caída de CTR por conjunto de anuncios."
  • >"¿Qué creativos están fatigados? Clasifica los anuncios por frecuencia y tendencia de CTR en 4 semanas."
  • >"Compara Advantage+ shopping vs mis campañas manuales en ROAS, últimos 30 días."

Leads y competidores

  • >"Exporta los leads de mi formulario 'Auditoría gratuita' de esta semana y marca los duplicados."
  • >"Muéstrame los anuncios activos que la Marca X está ejecutando en EE. UU. ahora mismo, con sus ganchos."
  • >"Lista cada creativo en la cuenta que haya estado activo más de 60 días."

Cambios (con aprobación)

  • >"Mueve el 20% del presupuesto de los dos peores conjuntos de anuncios al mejor — muéstrame el plan primero."
  • >"Pausa cada anuncio con frecuencia superior a 4 y CTR inferior a 0.8% este mes."
  • >"Duplica el anuncio ganador en el conjunto de anuncios de retargeting con la nueva imagen."

Flujos de trabajo listos: optimización de presupuesto de Meta vía MCP, optimización de ubicaciones, investigación en la Biblioteca de Anuncios desde Claude, depuración de Pixel y la guía del comprador de medios para Claude.

06 — Ejemplos de solicitudes

Llamadas de Insights y Graph que puedes describir en el chat

Rara vez necesitas escribir estas — el asistente las construye. Cuando quieras control exacto, describe la solicitud y el servidor la ejecuta a través de runRawInsights o runGraphRead. Tres que surgen a diario:

Insights: rendimiento de campaña, últimos 30 días

{
  "level": "campaign",
  "timeRange": { "startDate": "2026-08-04", "endDate": "2026-09-02" },
  "fields": ["campaign_name", "spend", "impressions", "cpm", "ctr",
             "frequency", "actions", "purchase_roas"],
  "filtering": [{ "field": "spend", "operator": "GREATER_THAN", "value": 50 }],
  "limit": 50
}

Los valores de gasto y acción de Insights llegan en unidades de moneda enteras. purchase_roas es el campo de ROAS; no existe un campo llamado roas.

Insights: desglose por ubicación con la ventana de atribución de un cliente

{
  "level": "adset",
  "timeRange": { "startDate": "2026-08-27", "endDate": "2026-09-02" },
  "fields": ["adset_name", "spend", "cpm", "ctr", "actions"],
  "breakdowns": ["publisher_platform", "platform_position"],
  "actionAttributionWindows": ["7d_click", "1d_view"]
}

Cada ventana solicitada llega como una clave adicional en cada acción (p. ej. '7d_click'); el valor simple permanece en la ventana predeterminada.

Lectura del grafo y luego un cambio de presupuesto sujeto a aprobación

// runGraphRead
{ "path": "act_1234567890/adsets",
  "fields": "name,status,daily_budget,optimization_goal" }

// runGraphWrite  (approval-gated)
{ "path": "23851234567890123",
  "params": { "daily_budget": 5000 } }

Los campos de dinero del grafo están en unidades menores: daily_budget 5000 = $50.00 (JPY y KRW son unidades enteras). Las actualizaciones requieren aprobación antes de ejecutarse.

07 — Comparación

Alojado vs. oficial vs. autoalojado

Qué operasServidor alojado de Ryze AIMCP oficial de MetaCódigo abierto (p. ej. GoMarble)
Tiempo de ejecuciónNinguno — HTTP remotoProceso local que tú ejecutasPython local que tú ejecutas
Credenciales que gestionasSolo inicio de sesión con FacebookApp de Meta + token de acceso a la API de MarketingApp de Meta + token de acceso en .env
Permisos y revisión de la appGestionado por RyzeAlcances ads_read / ads_management de tu appAlcances de tu app
Límites de tasaGestionados por la app de RyzeLímites de Gestión de Anuncios de tu appLímites de Gestión de Anuncios de tu app
Cuando cambia la versión de la APIRyze actualiza el servidorTú actualizas el servidorEsperas una actualización del repositorio
PlataformasMeta + Google Ads, TikTok, GA4, Search Console, ShopifySolo MetaSolo Meta
Controles de aprobación de escrituraPor herramienta, activados por defectoLo que permita tu tokenVaría según el proyecto

Autoalojar es la decisión correcta cuando los datos nunca deben salir de tu máquina o estás construyendo tu propio agente sobre la API sin procesar. Para esa ruta: El MCP oficial de Meta explicado, el servidor MCP del SDK de Negocios de Meta, lo que cambiaron el MCP oficial y el lanzamiento de CLI y los mejores servidores MCP para Meta Ads clasificados.

08 — Seguridad y permisos

Seguro por defecto

Approval flow of the Meta Ads MCP server: read tools such as runRawInsights and runGraphRead run automatically; write tools such as runGraphWrite, runGraphDelete and uploadImageFromUrl stop at a 'Needs approval' step in the chat, and the change reaches the Meta ad account only after you approve it.

Las lecturas se ejecutan automáticamente, las escrituras esperan por ti

Solo OAuth 2.0

Inicias sesión en la página de Facebook. Tu contraseña nunca toca Ryze, y los tokens se intercambian y actualizan en el lado del servidor.

Un espacio de trabajo por conexión

Cada conexión está autorizada contra un único espacio de trabajo de Ryze, elegido en la pantalla de consentimiento. Cambiar de espacio de trabajo significa reconectar y comenzar un nuevo chat.

Escrituras sujetas a aprobación

Las herramientas de lectura son automáticas. En Claude, abre Configuración → Conectores → Ryze AI y mantén runGraphWrite, runGraphDelete y uploadImageFromUrl en 'Necesita aprobación' — el valor predeterminado recomendado para cuentas en vivo.

Las eliminaciones son separadas y explícitas

Los archivos de Meta se eliminan en cascada — archiva el último anuncio y el conjunto de anuncios lo sigue — y no se pueden deshacer, por lo que runGraphDelete solo se ejecuta en una lista aprobada elemento por elemento. Pausar mediante runGraphWrite es la vía reversible.

Revoca en cualquier momento

Elimina el acceso desde Configuración de Facebook → Integraciones empresariales, o desde Configuración del espacio de trabajo → Integraciones en Ryze.

09 — Cuotas y límites

Qué saber antes de una sesión intensiva

App y token de desarrolladorNo es tuya para gestionar — el servidor alojado se ejecuta en la app y los permisos de Meta de Ryze AI.
Límites de tasaLos límites de Gestión de Anuncios de Meta se aplican por cuenta publicitaria y aparecen como error 80004. listCreatives pagina en 100 por defecto (máx. 1,000); extrae cuentas grandes en páginas.
Solicitudes de InsightsLos campos y desgloses deben ser nombres válidos de Insights. Rangos de fechas muy amplios pueden agotar el tiempo (error 100, subcódigo 1504018) — reduce el rango o añade timeIncrement.
Campos de dineroEl gasto de Insights y los valores de acción son unidades de moneda enteras. Los campos del grafo — daily_budget, lifetime_budget, bid_amount, amount_spent, spend_cap — están en unidades menores: 5000 = $50.00 (JPY y KRW son unidades enteras).
AtribuciónSe usa por defecto la configuración de atribución de cada conjunto de anuncios, como en Ads Manager. Pasa actionAttributionWindows (1d_click, 7d_click, 28d_click, 1d_view) para reflejar la ventana de un cliente y lee esa clave.
PaginaciónUna lectura del grafo con paging.next está incompleta. Pasa la URL completa de paging.next como la siguiente ruta hasta que esté ausente.
LeadslistLeadForms y listLeads necesitan el ID de la página; el servidor intercambia un token de acceso de la página. Requiere los alcances leads_retrieval y pages_read_engagement en la conexión.
Biblioteca de anunciosArchivo público, hasta 100 anuncios por página y 10 países por consulta. Sin métricas de gasto o rendimiento excepto anuncios políticos y de la UE.
MediosLas imágenes se suben desde una URL mediante uploadImageFromUrl y devuelven un image_hash. Los videos se publican en act_<id>/advideos con un file_url y se procesan de forma asíncrona — consulta el estado antes de construir el creativo.
Planes de clienteConectores personalizados de Claude: Pro, Team o Max. Conectores de ChatGPT: Plus, Pro o Business con modo Desarrollador.

10 — Solución de problemas

Errores comunes y la solución

SíntomaCausaSolución
Las herramientas no aparecen en el chatEl chat se abrió antes de que existiera el conector.Inicia un nuevo chat — Claude y ChatGPT vinculan conectores cuando comienza una conversación.
Sin opción de 'conector personalizado' en ClaudePlan gratuito de Claude.Los conectores personalizados necesitan Claude Pro, Team o Max. ChatGPT necesita Plus, Pro o Business con modo Desarrollador activado.
"adAccountId es obligatorio" o la cuenta incorrectaAún no se ha elegido ninguna cuenta.Pide primero tus cuentas publicitarias (listAdAccounts) y nombra una. Los ID se ven como act_1234567890.
Error 80004: demasiadas llamadas a esta cuenta publicitariaLímite de tasa de Gestión de Anuncios de Meta para esa cuenta.Espera y luego pagina con límites más pequeños — extraer miles de creativos en una sola llamada activa la alerta.
Error 190 en una llamada de leadsLa recuperación de leads necesita un token de acceso de la página, o falta el alcance leads_retrieval.Pasa pageId (la página que posee el formulario). Si persiste, reconecta Meta y concede los permisos de leads.
Error 100: parámetro no válido en InsightsEl campo o desglose no es un campo de Insights.status, placement y creative son atributos de objeto (usa runGraphRead); roas es purchase_roas.
Los números no coinciden con Ads ManagerVentana de atribución diferente, o conversiones a nivel de anuncio vs. a nivel de cuenta.Pasa actionAttributionWindows para reflejar la ventana del cliente y lee esa clave. Las filas de cuenta incluyen conversiones modeladas que las filas de anuncio no incluyen.
Los presupuestos se ven 100× desviadosLos campos de dinero del grafo están en unidades menores.daily_budget 5000 = $50.00; amount_spent '25468' = $254.68. El gasto de Insights ya está en unidades enteras.
"No se pueden añadir conjuntos de anuncios a campañas archivadas"Cascada de archivo: archivar el último hijo archivó el padre.Lee effective_status antes de eliminar el último hijo activo. Pausa con runGraphWrite en lugar de archivar; actualiza los creativos en su lugar.
Datos de la cuenta de cliente equivocadaLa conexión está autorizada a otro espacio de trabajo.Cada conexión es un espacio de trabajo de Ryze. Reconecta, elige el espacio de trabajo correcto e inicia un nuevo chat.

¿Aún atascado? Envía un correo a support@get-ryze.ai. Más soluciones del lado de Meta: solución de problemas de la conexión Meta Ads MCP. Agencias que gestionan muchas cuentas: configuración de MCP para múltiples cuentas publicitarias.

11 — Preguntas frecuentes

Preguntas sobre el servidor Meta Ads MCP

¿Qué es el servidor Meta Ads MCP?

Es un servidor MCP (Protocolo de Contexto de Modelo) que expone una cuenta publicitaria de Meta — campañas de Facebook e Instagram — como herramientas que un asistente de IA puede llamar. El servidor Meta Ads MCP de Ryze AI está alojado y es remoto: añades una URL a Claude, ChatGPT, Cursor o Claude Code, inicias sesión con Facebook mediante OAuth, y el asistente puede ejecutar informes de Insights, leer cualquier objeto de la API del grafo, buscar en la Biblioteca de anuncios y hacer cambios sujetos a aprobación.

¿Cuál es la URL del servidor Meta Ads MCP?

La URL del servidor es https://connector.get-ryze.ai/mcp. Es un servidor MCP remoto sobre HTTP Streamable con OAuth 2.0. El mismo endpoint sirve los conjuntos de herramientas de Meta Ads, Google Ads, TikTok, GA4, Search Console y Shopify, por lo que un conector cubre toda la pila publicitaria. Cada conexión está autorizada contra un espacio de trabajo de Ryze.

¿Necesito una app de desarrollador de Meta o un token de acceso a la API de Marketing?

No. El servidor alojado se ejecuta en la propia app y permisos de Meta de Ryze AI. Inicias sesión con una cuenta de Facebook que tenga acceso de administrador o anunciante a la cuenta publicitaria y listo. Los servidores autoalojados como el MCP oficial de Meta o el servidor GoMarble de código abierto requieren tu propia app de Meta, un token de acceso de larga duración y un tiempo de ejecución de Python local.

¿Qué clientes MCP funcionan con el servidor Meta Ads MCP?

Cualquier cliente que admita MCP remoto sobre HTTP con OAuth: Claude web y de escritorio (plan Pro, Team o Max), ChatGPT (Plus, Pro o Business con modo Desarrollador), Claude Code, Cursor, Windsurf, VS Code y Gemini CLI, además de marcos de agentes como el SDK de Agente de Claude, SDK de Agentes de OpenAI, LangChain, CrewAI y n8n.

¿Cuántas herramientas de Meta Ads expone el servidor?

12 herramientas de Meta Ads: 9 herramientas de lectura (resumen de cuenta, cuentas publicitarias, detalle de creativo, lista de creativos, formularios de leads, leads, Insights sin procesar, lecturas del grafo sin procesar y búsqueda en la Biblioteca de anuncios) y 3 herramientas de escritura (escrituras del grafo, eliminaciones del grafo y subida de imágenes), cada una sujeta a aprobación. El endpoint completo lleva más de 150 herramientas en seis plataformas.

¿Puede el servidor MCP cambiar mis campañas de Facebook, o solo leerlas?

Ambas. Las herramientas de lectura funcionan en cuanto se completa OAuth. runGraphWrite crea y actualiza campañas, conjuntos de anuncios, anuncios, creativos y presupuestos, y está sujeto a aprobación: en Claude lo configuras en 'Necesita aprobación' en Configuración → Conectores → Ryze AI. Las eliminaciones y archivos viven en una herramienta separada, runGraphDelete, porque los archivos de Meta se eliminan en cascada y no se pueden deshacer; solo se ejecuta en una lista explícita elemento por elemento.

¿Cómo ejecuto una consulta de Insights a través del servidor MCP?

Pregunta en inglés sencillo o describe la solicitud exacta. runRawInsights toma un nivel (account, campaign, adset o ad), un rango de fechas, cualquier campo válido de Insights, desgloses como age, gender, country, publisher_platform o platform_position, filtros y ventanas de atribución. El gasto regresa en unidades de moneda enteras, mientras que los campos de presupuesto del grafo están en unidades menores.

¿Por qué los números no coinciden con mi Ads Manager?

Casi siempre es la ventana de atribución. Por defecto el servidor sigue la configuración de atribución de cada conjunto de anuncios, como hace Ads Manager, pero un cliente puede ver una ventana diferente. Pasa actionAttributionWindows como ['7d_click','1d_view'] y lee el valor bajo esa clave de ventana. Las conversiones a nivel de cuenta también incluyen conversiones modeladas que las filas a nivel de anuncio no incluyen, por lo que las sumas a nivel de anuncio son unos pocos puntos porcentuales más bajas.

¿Puedo exportar leads de formularios de leads con el servidor MCP?

Sí. listLeadForms devuelve los formularios en una página de Facebook, y listLeads exporta los leads recopilados por un formulario. Ambos necesitan el ID de la página, porque Meta requiere un token de acceso de la página para la recuperación de leads; el servidor lo intercambia automáticamente. Si ves el error 190 del grafo en una llamada de leads, a la conexión le falta el alcance leads_retrieval — reconecta Meta y concédelo.

¿El servidor Meta Ads MCP incluye investigación de competidores en la Biblioteca de anuncios?

Sí. searchAdLibrary consulta la Biblioteca de anuncios pública de Meta por palabra clave o ID de página exacto, filtrada por país y estado activo, y devuelve cuerpos de creativos, títulos de enlaces, fechas de entrega, plataformas y una URL de instantánea por anuncio. Usa una credencial a nivel de plataforma, por lo que no se limita a tus propias cuentas. El gasto y el rendimiento no se exponen excepto para anuncios políticos y de la UE.

¿Cuánto cuesta el servidor Meta Ads MCP?

Conectarse es gratis — crear una cuenta de Ryze AI no cuesta nada y el conector no tiene tarifa por llamada. El Autopilot de anuncios de pago es de $89/mes fijo con una prueba gratuita de 7 días si quieres que Ryze AI ejecute las optimizaciones por ti. En el lado del cliente necesitas un plan de Claude que permita conectores personalizados (Pro, Team o Max) o un plan de ChatGPT con conectores (Plus, Pro o Business).

¿Es seguro el servidor Meta Ads MCP?

El acceso es solo OAuth 2.0, por lo que tu contraseña de Facebook nunca toca Ryze. Cada conexión está limitada a un espacio de trabajo de Ryze, las herramientas de escritura y eliminación están sujetas a aprobación por defecto, y puedes revocar el acceso en cualquier momento desde Configuración de Facebook → Integraciones empresariales o desde Configuración del espacio de trabajo → Integraciones en Ryze. La política de privacidad de MCP, los términos de MCP y la política de seguridad están enlazados en esta página.

¿Por qué Claude no ve las herramientas de Meta Ads después de conectarme?

Inicia un chat nuevo. Claude y ChatGPT vinculan los conectores cuando comienza una conversación, por lo que un chat existente conserva su conjunto de herramientas original. Si la opción de conector no aparece por completo, estás en un plan gratuito de Claude: los conectores personalizados requieren Pro, Team o Max. Finalmente, confirma que el conector aparece como Conectado en Configuración → Conectores.

¿En qué se diferencia esto del servidor MCP oficial de Meta?

El MCP oficial de Meta está diseñado para desarrolladores: creas una app de Meta, gestionas tokens de acceso y permisos de la Marketing API, ejecutas el servidor tú mismo y obtienes solo Meta. El servidor de Ryze AI está alojado, no requiere nada más que un inicio de sesión de Facebook, añade Google Ads, TikTok, GA4, Search Console y Shopify en el mismo endpoint, e incluye controles de aprobación para cada escritura.

12 — Compatibilidad

Funciona en todos los clientes MCP

Claude (web y escritorio)01

Claude Code02

Claude Agent SDK03

ChatGPT04

OpenAI Agents SDK05

Cursor06

Windsurf07

VS Code08

Gemini CLI09

LangChain10

CrewAI11

n8n12

13 — Relacionado

Sigue leyendo

Un inicio de sesión OAuth · 12 herramientas de Meta Ads · Activo en ~60 segundos

Añade Meta Ads a tu IA hoy.

Conéctalo gratis. Mejora a Paid Ads Autopilot ($89/mes fijo, prueba gratuita de 7 días) cuando quieras que Ryze AI ejecute las optimizaciones por ti, 24/7.

Más de 2,000 clientes · Más de 700 agencias · Más de $500M gestionados · Sin app de desarrollador · Sin servidor que ejecutar