Adako

Adako conecta tu IA con tus cuentas de Google Ads, Meta Ads, Linkedin Ads y ChatGPT Ads. Consulta el rendimiento de las campañas, lanza nuevas y elimina lo que desperdicia dinero.

GitHub

Prueba este MCPPatrocinado

Servidor MCP alojado

npx add-mcp 'https://adako.ai/mcp'

Se instala en Claude Code, Codex, Cursor y más

Documentación

Adako: operaciones publicitarias para asistentes de IA

アダコ · adako.ai

Adako es un servidor MCP y una API REST que conecta a Claude, ChatGPT, Cursor y otros asistentes con Google Ads, Meta Ads, ChatGPT Ads, TikTok Ads y LinkedIn Ads.

https://adako.ai/mcp

Pregunta "¿cómo les fue a mis campañas el mes pasado?" y obtén una respuesta desde la cuenta en vivo, en la moneda propia de la cuenta. Pregunta "sube ese presupuesto a 40 al día" y obtén una propuesta que apruebas antes de que algo se mueva. Las campañas creadas siempre se inician en pausa.

Este repositorio contiene las piezas públicas: las Agent Skills, la configuración por cliente, los instaladores de un solo archivo, un plugin para Claude Code y la entrada del MCP Registry. El servidor en sí está alojado.

Lo que puede hacer

233 herramientas en cinco plataformas, más las propias de Adako.

Plataforma	Herramientas	Qué cubren
Google Ads	70	Búsqueda y Performance Max, palabras clave y términos de búsqueda, presupuestos y estrategias de oferta, activos y extensiones, acciones de conversión, etiquetas, horarios, geo, informes por hora y por dispositivo
Meta Ads	44	Campañas, conjuntos de anuncios y anuncios, lanzamientos de imagen, video, carrusel e instalación de apps, audiencias y ubicaciones, píxeles, formularios de clientes potenciales, fatiga creativa
LinkedIn Ads	34	Grupos de campañas y campañas, anuncios de imagen, video, carrusel y texto, segmentación B2B, pronósticos de audiencia, reglas de conversión, métricas de interacción
TikTok Ads	30	Campañas, grupos de anuncios y anuncios de video in-feed, Spark Ads, métricas de video, identidades, píxeles, fatiga creativa
ChatGPT Ads	23	Campañas de chat card de principio a fin, límites de cuenta, píxeles, veredictos de revisión
Adako	32	Conexiones y uso, descubrimiento de herramientas, propuestas, diagnósticos, monitores, briefs e informes

Tu cliente no ve 233 entradas. Ve 16 herramientas invocables por nombre más 13 enrutadores. Cada plataforma tiene un enrutador de lectura (google_ads, meta_ads, chatgpt_ads, tiktok_ads, linkedin_ads) y un enrutador de escritura junto a él (google_ads_write, meta_ads_write, chatgpt_ads_write, tiktok_ads_write, linkedin_ads_write). Los monitores tienen monitoring y monitoring_write, y diagnostics solo lee. Una lectura se ve como google_ads(action="execute", tool_name="google_list_campaigns", arguments={...}), un cambio como google_ads_write(action="execute", tool_name="google_pause_campaign", arguments={...}).

Consultar información nunca cambia una cuenta, por lo que un asistente que pide permiso por herramienta puede permitir las lecturas una sola vez. Cada cambio pasa por una herramienta _write, que pregunta cada vez y crea una propuesta. search_tools encuentra la herramienta correcta a partir de tu propio texto y devuelve su línea de llamada exacta, y es gratuita. Consulta adako.ai/docs/routers.

Las lecturas de LinkedIn Ads están abiertas para todos: conecta al miembro que administra la cuenta publicitaria y todas las herramientas de informes, estructura y pronósticos funcionan. Un cambio requiere que esa cuenta publicitaria se agregue primero a la aplicación de LinkedIn de Adako: envía el id de nueve dígitos a support@adako.ai. Las herramientas de TikTok Ads están en la superficie, pero las cuentas de TikTok no se pueden conectar hasta que TikTok apruebe la aplicación de desarrollador de Adako.

El modelo de seguridad

Adako está diseñado para que un asistente pueda ser útil sin ser peligroso.

Regla	Qué significa
Las lecturas se ejecutan de inmediato	Rendimiento, estructura, términos de búsqueda, audiencias. Nada que aprobar.
Cada escritura se convierte en una propuesta	Ves el objeto, los valores antes y después, y el costo diario antes de que se envíe algo.
La aprobación es tuya	Confirma en el chat, o deja las propuestas en una bandeja de entrada y aprueba en adako.ai/approvals. Las propuestas caducan después de 48 horas.
Los objetos creados se inician en pausa	Cada campaña, conjunto de anuncios y anuncio que Adako crea comienza en pausa. Tú lo habilitas.
Casi nada se elimina	Ocho herramientas eliminan algo y cada una necesita un indicador de confirmación explícito. Pausar nunca deriva a una eliminación.
Se ejecuta una sola vez	Cada propuesta aprobada lleva una clave de idempotencia. Aprobar dos veces informa el primer resultado y no repite nada.
Verificación posterior en cada escritura	El cambio se confirma leyendo el objeto de vuelta desde la plataforma, no confiando en la respuesta.
Los tokens permanecen en el servidor	Tus tokens de plataforma se guardan cifrados por Adako y nunca se reenvían al cliente de IA.

Detalles: adako.ai/docs/safety.

Instalación — cinco minutos

Dos formas de autenticarse:

OAuth — el cliente abre un navegador, inicias sesión en Adako una vez. Preferido dondequiera que funcione.
Clave API — crea una en adako.ai/keys, envíala como Authorization: Bearer ak_live_your_key, donde ak_live_your_key se reemplaza por la clave completa que copiaste, con el prefijo incluido y nada alrededor. Úsala para clientes que leen un archivo de configuración estático.

Elige tu cliente.

Claude.ai (conector personalizado)

Pro y Max: Configuración → Conectores → Agregar conector personalizado. Pega la URL, haz clic en Agregar, luego Conectar e inicia sesión.

Team y Enterprise: un propietario lo agrega primero en Configuración de organización → Conectores → Agregar, pasa el cursor sobre Personalizado, elige Web y pega la URL. Los miembros luego lo conectan desde su propio Configuración → Conectores.

https://adako.ai/mcp

La cantidad de conectores personalizados que puedes agregar depende de tu plan de Claude.

Claude Desktop

Misma configuración de Conectores que Claude.ai: agrega el conector personalizado con la URL anterior y luego inicia sesión cuando se te solicite. Desktop comparte tu cuenta de Claude, por lo que un conector agregado en la web está disponible aquí también. Guía completa: clients/claude-desktop.md.

Claude Code

claude mcp add --transport http adako https://adako.ai/mcp

Luego ejecuta /mcp dentro de una sesión y elige adako para iniciar sesión a través del navegador.

Agrégalo una vez para cada proyecto con --scope user:

claude mcp add --transport http adako https://adako.ai/mcp --scope user

Variante con clave API, sin paso de navegador:

claude mcp add --transport http adako https://adako.ai/mcp \
  --header "Authorization: Bearer ak_live_your_key"

También hay un plugin que instala el servidor, las skills, un comando de configuración y un agente operador en un solo paso:

/plugin marketplace add ruslan2027/adako-mcp
/plugin install adako@adako
/adako-setup

Consulta clients/claude-code.md y plugin/.

ChatGPT (modo desarrollador)

Activa el Modo desarrollador en Configuración → Seguridad e inicio de sesión, luego abre ChatGPT Plugins.
Haz clic en +. Ingresa Adako como nombre de la conexión y https://adako.ai/mcp como URL del servidor MCP. Agrega una descripción breve, elige la opción de conexión de endpoint público y haz clic en Crear.
Completa la autorización si se te solicita.
Inicia una nueva conversación, abre el menú de herramientas y selecciona Adako.

Guía completa: clients/chatgpt.md.

Cursor

Un comando, idempotente, y deja tus otros servidores intactos:

node install/cursor.mjs            # the home-folder .cursor/mcp.json
node install/cursor.mjs --project  # .cursor/mcp.json in this repository

O escribe el archivo tú mismo:

{
  "mcpServers": {
    "adako": {
      "url": "https://adako.ai/mcp"
    }
  }
}

Archivo completo: clients/cursor/mcp.json. Guía: clients/cursor.md.

Este repositorio también es un plugin de Cursor, para el Cursor Marketplace: .cursor-plugin/plugin.json agrega el servidor y las skills en skills/.

Codex CLI

codex mcp add adako --url https://adako.ai/mcp
codex mcp login adako

O ejecuta el instalador, que reescribe una tabla en la configuración de Codex (C:\Users\<you>\.codex\config.toml en Windows o /Users/<you>/.codex/config.toml en macOS) y deja el resto del archivo intacto:

node install/codex.mjs            # API key from $ADAKO_API_KEY
node install/codex.mjs --oauth    # sign in with codex mcp login instead

Archivo completo: clients/codex/config.toml. Guía: clients/codex.md.

Windsurf

node install/windsurf.mjs

O agrega el bloque manualmente a C:\Users\<you>\.codeium\windsurf\mcp_config.json en Windows o /Users/<you>/.codeium/windsurf/mcp_config.json en macOS:

{
  "mcpServers": {
    "adako": {
      "serverUrl": "https://adako.ai/mcp"
    }
  }
}

Archivo completo: clients/windsurf/mcp_config.json. Guía: clients/windsurf.md.

Gemini (aplicación personalizada)

En una computadora, abre gemini.google.com/apps, o Configuración → Aplicaciones conectadas, luego desplázate hasta Aplicaciones personalizadas al final, elige Agregar una aplicación personalizada y pega la URL:

https://adako.ai/mcp

Haz clic en Siguiente e inicia sesión. Deja los campos de credenciales en Funciones avanzadas vacíos: Adako se registra solo. En un chat, escribe @ y elige Adako.

Guía: clients/gemini.md. Las aplicaciones personalizadas aún se están implementando, con condiciones que Google enumera: una cuenta personal de Google, inglés, Estados Unidos, 18 años o más.

Antigravity (app, IDE y CLI agy)

Los tres leen un solo archivo, por lo que Adako se agrega una vez. En la app de escritorio: Configuración → Personalizaciones, luego Abrir configuración de MCP. En el IDE: el panel lateral del agente, … → Servidores MCP. En la CLI: /mcp, o el archivo en sí: C:\Users\<you>\.gemini\config\mcp_config.json en Windows o /Users/<you>/.gemini/config/mcp_config.json en macOS (Linux: /home/<you>/.gemini/config/mcp_config.json). Usa .agents/mcp_config.json para un proyecto. Después de guardar, presiona actualizar junto a Servidores MCP instalados y haz clic en Adako para iniciar sesión.

{
  "mcpServers": {
    "adako": {
      "serverUrl": "https://adako.ai/mcp"
    }
  }
}

Antigravity inicia sesión a través del navegador en la primera llamada. Guía: clients/antigravity.md.

Gemini CLI dejó de servir cuentas gratuitas y Pro el 18 de junio de 2026 y ahora solo funciona con claves API de pago de Gemini y Gemini Enterprise. Si aún lo usas, la ortografía anterior funciona: httpUrl en .gemini/settings.json en tu carpeta de inicio, con los manifiestos de extensiones gemini-extension.json y clients/gemini-cli/gemini-extension.json. Por separado, agy plugin import gemini lleva una configuración existente a Antigravity.

VS Code (Copilot)

.vscode/mcp.json en un espacio de trabajo, o tu mcp.json de usuario:

{
  "servers": {
    "adako": {
      "type": "http",
      "url": "https://adako.ai/mcp"
    }
  }
}

VS Code maneja el flujo de OAuth. Archivo completo con la variante de clave API: clients/vscode/mcp.json. Guía: clients/vscode.md.

Perplexity

Agrega Adako como conector personalizado: en la web en perplexity.ai/computer/connectors, o Configuración → Conectores en la app de escritorio, luego la URL anterior con OAuth. Los conectores personalizados vienen con Pro, Max y Enterprise. Guía: clients/perplexity.md.

Agrega las skills

skills/ contiene once Agent Skills. adako es el procedimiento operativo: el contrato de seguridad, el contrato de llamadas de herramientas, el mapa de herramientas y los flujos de trabajo. Las demás están enfocadas: una por plataforma, una por tarea.

Habilidad	Para
`adako`	El procedimiento operativo. Empieza aquí.
`google-ads`, `meta-ads`, `tiktok-ads`, `linkedin-ads`, `chatgpt-ads`	Una plataforma cada uno: herramientas por trabajo, reglas, orden de lanzamiento
`launch`	Crear una campaña de forma segura en cualquier plataforma
`performance-review`	Responder "¿cómo vamos?" con números que se sostienen
`optimize`	Qué cambiar después de la revisión, y en qué orden
`creative`	Límites de copys y especificaciones de assets por plataforma, y el manual de fatiga
`monitoring`	Monitores, alertas, briefs e informes

Claude Code — instala el plugin, o copia skills/ en la carpeta .claude/skills/ de tu directorio personal (C:\Users\<you>\.claude\skills\ en Windows o /Users/<you>/.claude/skills/ en macOS).
claude.ai — sube SKILL.md (el mismo archivo que skills/adako/SKILL.md) como habilidad en los ajustes.
Cualquier otra cosa — pega el contenido en tu prompt de sistema o en las instrucciones del proyecto.

El servidor también incluye instrucciones breves al conectar, así que las habilidades son opcionales. Hacen que las sesiones largas sean notablemente más estables.

API REST y línea de comandos

Las mismas herramientas se ejecutan por HTTP con una clave de API.

curl -X POST https://adako.ai/api/v1/tools/google_get_campaign_performance/execute \
  -H "Authorization: Bearer ak_live_your_key" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"arguments": {"date_range": "last_30_days"}}'

GET /api/v1/tools lista todas las herramientas invocables. GET /api/v1/openapi.json es el contrato legible por máquina, que n8n, Zapier y Make pueden importar. Referencia completa: adako.ai/docs/api.

La línea de comandos adako envuelve los mismos endpoints para scripts y agentes de código:

npx @adako/cli login
npx @adako/cli google list-campaigns --customer-id 1234567890
npx @adako/cli meta get-campaign-performance --date-range last_30_days --raw

Su código fuente está en cli/: ESM puro, sin dependencias, Node 22 o más reciente. El paquete publicado es @adako/cli en npm.

Conecta tus cuentas

Inicia sesión en adako.ai.
Abre Cuentas y conecta una plataforma. Google Ads y LinkedIn Ads inician sesión a través de la plataforma; Meta Ads requiere un token de acceso de un usuario de sistema en tu propia app de Meta; ChatGPT Ads requiere una clave de API de anunciante. Nunca entregas una contraseña ni un token a tu cliente de IA.
Activa las cuentas en las que Adako puede trabajar y elige la principal para cada plataforma.
De vuelta en tu asistente, di "empieza aquí".

Primeros prompts

Solo lectura, así que nada puede moverse:

"Empieza aquí."
"¿A qué cuentas de anuncios estoy conectado?"
"¿Cómo les fue a mis campañas de Google en los últimos 30 días comparado con los 30 anteriores?"
"Encuentra términos de búsqueda que gastaron dinero y no convirtieron nada el mes pasado."
"¿Qué conjuntos de anuncios de Meta están gastando sin resultados esta semana?"
"Desglosa mi mejor conjunto de anuncios de Meta por ubicación."
"¿Cuáles de mis anuncios de TikTok muestran fatiga creativa?"
"¿Cuál fue el costo por lead de LinkedIn el mes pasado y a qué títulos de puesto llegó?"
"Ejecuta esa verificación de gasto desperdiciado en todas mis cuentas activas."

Luego, cuando quieras un cambio:

"Sugiere diez palabras clave negativas de esa lista y dime qué bloquea cada una."
"Pausa la campaña que más gastó sin conversiones."
"Sube el presupuesto diario de Brand Search a 40."
"Redacta una campaña de Search pausada para {producto} dirigida a {ciudad}, 25 al día."
"Avísame si el CPA supera 80 dos días seguidos, y envíame un brief cada lunes."

Cada uno de esos termina con una propuesta que apruebas o rechazas.

Precios

Gratis incluye 1 cuenta de anuncios y 30 tareas al mes. Pro ($49/mes) cubre 5 cuentas de anuncios y 600 tareas al mes, Agencia ($149/mes) 20 cuentas y 5,000 tareas, y Enterprise se cotiza por contrato. Una cuenta usada en un período de facturación mantiene su lugar hasta que el período se reinicia. Una tarea es un cambio facturado a una cuenta de anuncios; las lecturas y las herramientas de conexión, uso, propuesta, descubrimiento, diagnóstico y resolución son gratuitas. Los monitores, briefs programados e informes generados requieren Pro o superior. Detalles en adako.ai/pricing.

Documentación

adako.ai/docs — guía de inicio rápido, una página por cliente, una página por plataforma, la superficie de herramientas, flujos de trabajo, monitores, la referencia completa de herramientas y la API REST.

Soporte

support@adako.ai · informes de seguridad: consulta SECURITY.md · cambios: consulta CHANGELOG.md

Licencia

Las habilidades y las configuraciones de cliente en este repositorio son MIT — consulta LICENSE. El servicio alojado de Adako es propietario.