AdsAgent Meta MCP

https://adsagent.md/docs/mcp-onboarding

Documentación

Complemento de Tres Canales de AdsAgent

Complemento público de Claude + paquete de habilidades para el MCP alojado de tres canales de AdsAgent: Meta, Google Ads y TikTok.

División de distribución (importante):

Superficie	Qué es	¿Este repositorio?
Complemento de Claude (marketplace autoalojado)	Habilidades + URLs MCP HTTP raíz `.mcp.json` (OAuth)	Sí
Directorio de Conectores de Anthropic	Solo listado de servidores MCP alojados	No — envío separado en servicios `adsagent.md`

Repositorio oficial de GitHub: github.com/adsagents/adsagent-ai-skills

Sitio web: adsagent.md
Centro de enlaces oficiales: adsagent.md/connect
Página de destino del paquete de habilidades: adsagent.md/skills
Soporte: support@adsagent.md

Versión de contrato actual: 0.7.64. El slug del complemento es adsagent (clave de marketplace adsagent). Las nuevas conexiones de Meta usan por defecto el perfil de producto v2; los tres endpoints alojados negocian el descubrimiento sin estado MCP moderno 2026-07-28 mientras conservan los clientes legacy de initialize compatibles.

El historial de versiones se encuentra en CHANGELOG.md.

El asistente local scripts/update_reminder.py compara versiones semánticas estrictas y almacena solo estado acotado de versión/marca de tiempo en $XDG_CACHE_HOME/adsagent-ai-skills/update-reminder-v1.json (o ~/.cache/...). Un fallo de caché nunca bloquea el trabajo MCP.

Qué Es Esto

Un paquete público de marketplace de complementos de Claude: habilidades de comportamiento más URLs MCP alojadas vía .mcp.json.
Una guía de comportamiento para Claude Code, Cursor, Codex y otros clientes compatibles con MCP.
Una capa de confiabilidad y seguridad que indica a los agentes cuándo reintentar, cuándo esperar y cuándo detenerse.
Una distribución versionada de GitHub para la incorporación de usuarios de AdsAgent y la guía de comportamiento de agentes.
Un contrato de minimización de datos para agentes de IA que no deben escanear AdsAgent como una base de datos cruda.

Qué No Es Esto

No es el listado MCP del Directorio de Conectores de Anthropic (eso se registra por separado en los servidores alojados).
No es una referencia completa de herramientas MCP.
No es un SDK.
No es un relevo de transporte local.
No es una divulgación de rutas de backend, esquemas, tablas de base de datos o diagnósticos internos de AdsAgent.

Para instalaciones del complemento de Claude Code, la configuración MCP OAuth proviene del .mcp.json de este repositorio. Para clientes sin soporte de complementos, el mensaje de instalación del panel de AdsAgent sigue siendo el respaldo manual:

AdsAgent dashboard -> Settings -> MCP Access -> Copy install prompt

Usa ese mensaje copiado solo cuando no estés instalando el paquete de complementos de Claude. Este repositorio enseña el comportamiento del agente después de que exista la conexión MCP.

Habilidades Incluidas

Habilidad	Propósito
`adsagent-router`	Enrutar solicitudes de AdsAgent a flujos de trabajo de configuración, confiabilidad, información o copia.
`adsagent-setup`	Conectar mediante el mensaje de instalación del panel de AdsAgent y verificar la preparación de Meta, Google Ads o TikTok.
`adsagent-notifications`	Inspeccionar y configurar de forma segura los canales de notificación y los Webhooks de Meta Ads.
`adsagent-reliability`	Respetar los límites de reintento, retroceso, renovación de sesión y concurrencia.
`agent-scheduled-tasks`	Diseñar, crear, verificar, actualizar, pausar y eliminar tareas programadas propiedad del agente sin confundir recordatorios con prueba de ejecución.
`meta-insights`	Hacer preguntas de rendimiento y MMP sin sobrecargar el servidor.
`meta-copy`	Copiar o comparar anuncios de Meta con confirmación y seguridad de revisión del operador.
`google-ads-insights`	Hacer preguntas sobre clientes de Google Ads, MCC, Search, PMax y rendimiento a través de Google Ads MCP.
`tiktok-insights`	Leer el rendimiento de TikTok y preparar de forma segura flujos de trabajo nativos de creación, campaña y grupo de anuncios.

Divulgación Progresiva

Los clientes de agentes cargan cada descripción de Habilidad para descubrimiento, pero deben cargar solo el cuerpo SKILL.md seleccionado. Cada punto de entrada es intencionalmente pequeño y enlaza a archivos de referencia locales que se leen solo cuando el flujo de trabajo seleccionado necesita esos detalles.

Los archivos bajo docs/ son documentación de producto y operador orientada a humanos. No son contexto automático de agentes y no forman parte del recorrido de referencia de Habilidades. Los contratos de comportamiento de agentes viven bajo skills/ y se alcanzan desde el SKILL.md seleccionado.

Contrato de Salida del Agente

Los agentes que usan AdsAgent deben responder en Markdown por defecto:

## Answer
One-sentence answer.

## Scope
- Date:
- Entity:
- Grouping:
- Attribution / channel:

## Results
| Metric | Value |
| --- | ---: |

## Notes
- Data freshness:
- Limits or missing fields:
- Next safe action:

No vuelques JSON, CSV, diagnósticos ocultos, filas crudas o cada campo devuelto en el chat. Limpia la respuesta en tablas orientadas al operador y viñetas cortas. Si se necesita inspección cruda forense, crea una entrega al operador en lugar de hacer que las filas crudas sean la respuesta del agente.

Política de Caja Semi-Negra

Este repositorio documenta intencionalmente resultados y comportamiento de agentes, no la interfaz interna completa. Los agentes deben:

Leer la guía MCP de AdsAgent en vivo después de conectarse.
Usar las herramientas disponibles a través de la sesión MCP autenticada.
Evitar adivinar campos de payload ocultos.
Evitar sondear solicitudes rechazadas.
Detenerse en respuestas de revisión del operador y pedir al operador de AdsAgent que inspeccione los diagnósticos internos.
Usar el plan de datos seguro más pequeño antes de hacer llamadas.
Preferir resúmenes agrupados y desgloses limpios sobre filas crudas.

El contrato externo del agente es: hacer preguntas claras, respetar límites, confirmar antes de escribir y usar la incorporación proporcionada por el panel.

Fuente Oficial y Derechos

Este repositorio contiene solo el paquete de comportamiento legible por el cliente. El código fuente del servidor de AdsAgent, credenciales, esquemas, lógica de enrutamiento y diagnósticos operativos no se distribuyen aquí.

El paquete es propietario y todos los derechos están reservados por adsagents LLC. El alojamiento público de GitHub permite a las personas ver y bifurcar el repositorio bajo los Términos de Servicio de GitHub, pero una bifurcación o copia local no otorga ninguna licencia adicional de propiedad intelectual excepto los derechos limitados de duplicación del directorio de complementos de Anthropic Claude en LICENSE.md. No se otorga ningún otro permiso para redistribuir, duplicar, vender, sublicenciar, publicar versiones modificadas, crear trabajos derivados, entrenar un producto competidor a partir del paquete o representar una bifurcación como oficial. Consulta LICENSE.md y NOTICE.md.

Ejemplos de Mensajes

Use AdsAgent to list my connected Meta products, Google Ads customers, or TikTok advertisers, then ask which scope's today data I want to inspect.

For Google Ads, inspect agent_method_profile, pick an enabled non-manager customer, and use one cached insights_query_consistent request when the profile is advertised.

For TikTok, inspect agent_method_profile and use one insights_query_consistent scopes request when advertised; otherwise use the native batch overview fallback.

Prepare a copy of this winning Meta ad into the target account, but ask me for confirmation before creating anything.

Group these distinct Meta Ads by language into the requested Campaign and AdSet layout. Prepare one grouped_plan, show every settings_source_ad_id and geography override, and wait for my approval before confirming once.

Más ejemplos están en docs/examples.md.

Validación

Ejecuta el contrato de lanzamiento local y las pruebas:

python scripts/validate_tri_channel_pack.py
python -m pytest -q

La validación de lanzamiento es de cierre ante fallos contra las tres instantáneas confirmadas en contracts/manifests/. Cada instantánea se copia byte por byte de un artefacto de servicio confirmado y se bloquea a su canal, revisión de fuente, ruta de artefacto público, metadatos y SHA-256 en contracts/manifests/provenance.json. CI no hace solicitudes de red en vivo.

python scripts/validate_public_tool_manifests.py

Un operador puede actualizar de forma determinista las tres instantáneas después de que el manifiesto del servicio cambie. El comando rechaza fuentes no confirmadas, sucias, faltantes o incompatibles con el contrato y nunca obtiene de la red:

python scripts/sync_public_tool_manifests.py \
  --source meta=/path/to/meta-tools.json \
  --source google=/path/to/google-tools.json \
  --source tiktok=/path/to/tiktok-tools.json

Las tres fuentes son obligatorias. Una herramienta referenciada faltante, una capacidad o puerta requerida no probada, un resumen de procedencia obsoleto o un canal ausente falla la validación de lanzamiento. --allow-missing existe solo para diagnósticos locales explícitos y no lo usa CI de lanzamiento.

Instalación

Este repositorio se distribuye como el complemento de Claude adsagent (habilidades + URLs MCP .mcp.json). El nombre del repositorio de GitHub permanece adsagent-ai-skills.

Claude Code (recomendado)

claude plugin marketplace add adsagents/adsagent-ai-skills
claude plugin install adsagent@adsagent

Actualiza una instalación existente de ámbito de usuario:

claude plugin update --scope user adsagent@adsagent

Si claude plugin list muestra instalaciones locales y de usuario duplicadas, conserva el ámbito de usuario:

claude plugin uninstall --scope local adsagent@adsagent

Inicia una nueva sesión de Claude Code después de instalar o actualizar.

Preinstalación en Cloud / Cowork (fragmento de configuración)

{
  "extraKnownMarketplaces": {
    "adsagent": {
      "source": {
        "source": "github",
        "repo": "adsagents/adsagent-ai-skills"
      }
    }
  },
  "enabledPlugins": ["adsagent@adsagent"]
}

Después de la instalación, autentica cada servidor MCP mostrado en /mcp (Meta, Google, TikTok). No agregues headers.Authorization a .mcp.json; OAuth debe seguir siendo la ruta de autenticación.

Migración desde slugs de complementos legacy

Las instalaciones antiguas usaban adsagent-ai-skills@adsagent-ai-skills o adsagent-meta-ai-skills@adsagent-meta-ai-skills. El marketplace declara un cambio de nombre a adsagent@adsagent. Después de migrar, elimina los duplicados legacy:

claude plugin uninstall --scope user adsagent-ai-skills@adsagent-ai-skills
claude plugin uninstall --scope user adsagent-meta-ai-skills@adsagent-meta-ai-skills

Codex CLI

codex plugin marketplace add adsagents/adsagent-ai-skills
codex plugin add adsagent@adsagent

Actualiza:

codex plugin marketplace upgrade adsagent

Inicia una nueva sesión de Codex después de instalar o actualizar.

Respaldo de Git y otros clientes compatibles con Agent-Skills

Las habilidades en skills/ usan el diseño estándar de Agent Skills (skills/<name>/SKILL.md con frontmatter YAML). Los clientes que solo consumen habilidades (sin el paquete MCP de complementos) pueden clonar manualmente:

git clone https://github.com/adsagents/adsagent-ai-skills.git ~/.codex/skills/adsagent-ai-skills

Esos clientes aún necesitan una conexión MCP separada (mensaje de instalación del panel o Directorio de Conectores). La ruta del complemento es el paquete combinado de habilidades + MCP en un solo paso.

Luego abre AdsAgent solo si necesitas configuración de OAuth/token del panel para clientes sin complementos:

Settings -> MCP Access -> Copy install prompt

Pega el mensaje copiado en un chat nuevo cuando no se use el paquete de complementos. El mensaje proporciona URLs MCP HTTP alojadas para:

Meta default: https://adsagent.md/mcp/v2
Meta legacy fallback: https://adsagent.md/mcp
Google Ads: https://google.adsagent.md/mcp
TikTok: https://tiktok.adsagent.md/mcp

Reglas de Ejecución Importantes

Solo MCP HTTP alojado.
Usa https://adsagent.md/mcp/v2 para nuevas conexiones de Meta; /mcp es el respaldo legacy.
No ejecutes código MCP de AdsAgent localmente.
No uses un relevo local a menos que el panel de AdsAgent lo indique explícitamente.
Almacena en caché la configuración de conexión donde el cliente lo admita.
Mantén acotada la concurrencia MCP por token.
Respeta Retry-After.
Analiza Retry-After del encabezado HTTP, data de nivel superior o error.data de JSON-RPC.
Honra mcp_concurrency_limited con espera más fluctuación.
Honra mcp_fanout_detected cambiando a la herramienta de descripción general de lotes de la plataforma en lugar de reintentar la solicitud bloqueada de ámbito único.
Cuando agent_method_profile.profile_id=adsagent_agent_methods_v1 y su lectura consistente estén presentes en el catálogo local del cliente, usa una solicitud insights_query_consistent con scope o scopes ordenado para las tres plataformas.
Sin ese perfil, o cuando su lectura anunciada falte solo en el catálogo local del cliente, usa el respaldo nativo nombrado del perfil o las herramientas documentadas del lado del servidor: Meta/TikTok insights_query_batch_overview, Google google_ads_insights_overview_batch. No informes un fallo de registro del servidor por una falta de selección local.
Consulta primero datos agregados y nunca infieras paridad de capacidades entre plataformas a partir de un nombre de herramienta compartido.
Informa totales calculados por el servidor desde la respuesta; no sumes filas actualmente visibles.
Confía en los totales solo cuando meta.complete=true; los ámbitos faltantes son desconocidos, nunca cero.
Sondea tareas en cola hasta terminal=true y devuelve el enlace del artefacto en lugar de CSV crudo.
Sondea trabajo en cola directamente con tasks_get_status(task_ref=...) cuando el servidor anuncie referencias de tareas directas.
Los tokens de confirmación de QuickCreate son de un solo uso y expiran después de 15 minutos. Verifica expires_at; después de confirm_token_invalid, prepara de nuevo, muestra el nuevo resumen y obtén aprobación explícita nueva.
Sondea tareas de creación de Meta con tasks_get_status(task_ref=..., response_mode=compact). En no_create_permission, dirige al usuario a /dashboard/assets/fb-users; nunca cambies permisos de clientes ni reproduzcas la creación fallida automáticamente.
Evita lecturas de filas crudas en conversaciones normales de usuario.
Usa tablas de Markdown para números.
Confirma antes de la creación o modificación de anuncios.
Usa grouped_plan para múltiples anuncios fuente distintos; nunca lo emules a través de una serie de mutaciones de copia del lado del cliente.
Detente en errores de revisión del operador.
Cuando un error incluya support_ref, consérvalo y muéstralo textualmente para soporte. No es autorización; nunca inventes, modifiques, enumeres ni lo reemplaces con tokens, cuerpos de solicitud o registros.

Enlaces

Sitio web oficial: https://adsagent.md
Repositorio oficial: https://github.com/adsagents/adsagent-ai-skills
Soporte: support@adsagent.md
Ruta de incorporación pública: https://adsagent.md/docs/mcp-onboarding