Para desarrolladores · compatible con Claude y Cursor

Guía de integración MCP

Usa el Model Context Protocol para que Claude, Cursor o tu propio agente de IA consulten tus datos de DEXUN AdWhiz: cuentas publicitarias conectadas de las tres plataformas, recomendaciones de la IA y actividad reciente. Solo lectura.

¿Qué es MCP?

MCP (Model Context Protocol) es el estándar abierto que Anthropic lanzó en 2024 para definir cómo las aplicaciones de IA acceden de forma segura a datos y herramientas externas. Piensa en él como "el USB-C de la IA": una sola interfaz para que cualquier cliente MCP (Claude Desktop, Cursor, tu propio agente) pueda llamar a cualquier servidor MCP (DEXUN AdWhiz, Notion, GitHub, etc.).

El servidor MCP de DEXUN AdWhiz expone 5 herramientas de solo lectura: tus cuentas publicitarias conectadas, las recomendaciones abiertas de la IA, tu resumen de ahorro, la actividad reciente de la cuenta y tu cuota de API. No puede cambiar, pausar ni crear nada en tus cuentas publicitarias. Cada llamada se autentica con tu API key y cuenta para los mismos límites por plan que nuestra API REST.

Inicio rápido

Tres pasos. Unos cinco minutos para poder preguntarle a tu asistente de IA por tus cuentas publicitarias.

1

Configura Claude Desktop

Edita claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\) y añade:

# Claude Desktop config: ~/.../claude_desktop_config.json
{
  "mcpServers": {
    "dexun-adwhiz": {
      "command": "npx",
      "args": ["-y", "@dexun/adwhiz-mcp@latest"],
      "env": {
        "ADWHIZ_API_KEY": "dxk_live_..."
      }
    }
  }
}
2

Configura Cursor

Mediante .cursor/mcp.json a nivel de proyecto o la configuración global:

# Cursor: ~/.cursor/mcp.json (or Project → Settings → MCP)
{
  "mcpServers": {
    "dexun-adwhiz": {
      "command": "npx",
      "args": ["-y", "@dexun/adwhiz-mcp@latest"],
      "env": { "ADWHIZ_API_KEY": "dxk_live_..." }
    }
  }
}
3

Verifica

Reinicia Claude o Cursor y prueba este prompt. Si ves que la IA llama a list_ad_accounts o list_recommendations y devuelve tus datos reales, ya estás conectado.

Pregúntale a Claude:

“Enumera mis cuentas publicitarias conectadas y resume las recomendaciones abiertas de la IA: ¿qué campañas sugiere cambiar y por qué?”

Catálogo de herramientas

El servidor MCP expone 5 herramientas, todas de solo lectura. Cada una tiene un JSON Schema completo, así que la IA decide sola cuándo llamar a cuál.

list_ad_accounts

Solo lectura

Tus cuentas conectadas de Google Ads, Meta Ads y TikTok Ads y su estado de conexión.

list_recommendations

Solo lectura

Las recomendaciones de optimización abiertas de la IA (subir presupuesto, bajarlo, pausar), cada una con motivo, impacto esperado y nivel de confianza.

get_savings_summary

Solo lectura

Tu resumen de ahorro: remite a las cifras de ahorro de tu panel, junto con tu plan.

get_recent_activity

Solo lectura

Actividad reciente de la cuenta: inicios de sesión, cambios de API keys, conexiones de cuentas publicitarias y cambios de suscripción.

get_quota

Solo lectura

Tu límite de API actual: solicitudes por minuto, cuántas quedan y cuándo se reinicia la ventana.

Tu cliente de IA muestra estas mismas herramientas, con sus parámetros, mediante la solicitud estándar tools/list de MCP.

Sesión de ejemplo

Una conversación de ejemplo (datos ficticios) que muestra cómo es el acceso de solo lectura:

¿Qué cuentas publicitarias tengo conectadas a AdWhiz?

Tienes tres cuentas conectadas: una de Google Ads, una de Meta Ads y una de TikTok Ads. Las tres aparecen como conectadas.

list_ad_accounts

¿Qué recomienda la IA ahora mismo?

Hay 2 recomendaciones abiertas: ① bajar el presupuesto diario de la campaña de Meta “Lookalike 1%”, cuyo ROAS lleva una semana por debajo de la media de la cuenta; ② subir el presupuesto de una campaña de TikTok Spark Ads. Cada una incluye su motivo y un nivel de confianza. Si quieres aplicarlas, hazlo en tu plataforma publicitaria; desde aquí no puedo cambiar nada.

list_recommendations

¿Ha cambiado algo en mi cuenta últimamente?

En los últimos 7 días: 2 inicios de sesión, 1 API key nueva y la reconexión de tu cuenta de TikTok Ads. No hay nada más registrado.

get_recent_activity

Seguridad y permisos

  • Las 5 herramientas son de solo lectura: la IA puede consultar tus datos, pero no cambiar presupuestos, pausar anuncios ni crear campañas
  • El servidor MCP se ejecuta localmente: tu API key dxk_ nunca sale de tu equipo hacia terceros
  • Las llamadas se autentican con tu API key y comparten los límites de la API REST de tu plan (consúltalos con get_quota)
  • Los cambios en tus campañas los haces tú, no a través de MCP
  • Revoca el acceso MCP cuando quieras en panel → Configuración → API Keys