ADS Beast para asistentes de IA
Conecta Claude Code a ADS Beast
Un comando añade el servidor. El plugin de nuestro repositorio público añade el mismo servidor y una skill breve de conexión.
Primero, crea una clave de API
- 1Inicia sesión en ADS Beast y abre Claves de API en el menú. Para crear una clave hace falta el rol de administrador.
- 2Crea una clave solo con los permisos que necesita el asistente. Con
read:*basta para consultar datos. Añadewrite:proposalspara que pueda proponer cambios y montar borradores de campañas, ywrite:leadspara que pueda actualizar leads. - 3Copia la clave que empieza por
absk_. Se muestra una sola vez. Se revoca en la misma pantalla, y una clave revocada deja de funcionar al instante.
Añade el servidor con una clave
- 1Ejecuta el comando en una terminal con tu clave en lugar de
absk_your_key. - 2Por defecto el servidor se guarda para ti en el proyecto actual. Añade
--scope userpara tenerlo en todos los proyectos. - 3Abre Claude Code y ejecuta
/mcp. El servidoradsbeastaparece como conectado.
claude mcp add --transport http adsbeast https://adsbeast.pro/api/mcp/workspace --header "Authorization: Bearer absk_your_key"O compártelo con el equipo
- 1Pon el fragmento en
.mcp.json, en la raíz del repositorio. La clave se queda en la variable de entornoADSBEAST_API_KEYde cada persona, no en el archivo. Claude Code pide a cada persona que apruebe el servidor la primera vez que lo inicia en ese repositorio.
Archivo:
.mcp.json{
"mcpServers": {
"adsbeast": {
"type": "http",
"url": "https://adsbeast.pro/api/mcp/workspace",
"headers": {
"Authorization": "Bearer ${ADSBEAST_API_KEY}"
}
}
}
}O instala el plugin
- 1Ejecuta los dos comandos dentro de Claude Code. A continuación pide la clave. Si no la pide, ejecuta
/plugin configure adsbeast@adsbeast-plugins.
/plugin marketplace add notformal/adsbeast-plugins
/plugin install adsbeast@adsbeast-pluginsEl inicio de sesión sin clave (OAuth) está hecho, pero todavía no está activado en producción. Los pasos que lo necesitan aparecerán aquí cuando se active.
Primeros prompts para probar
- Llama a whoami en ADS Beast y dime qué organización y qué permisos tiene esta conexión.
- Muestra el resumen del panel de campañas y las alertas sin leer.
- Comprueba este titular de Google Ads con los límites de la plataforma: "Plumber in Bratislava, same day".
Si no funciona
- Una respuesta 401 significa que la clave falta, está mal escrita o ha sido revocada. El handshake y la lista de herramientas responden sin clave, así que un cliente puede mostrar las herramientas y aun así fallar en la primera llamada.
- Un 403 en la respuesta significa que a la clave le falta el permiso que necesita esa herramienta. La herramienta
whoamilista los permisos que lleva la clave. - Si no aparecen herramientas después de editar un archivo de configuración, reinicia el cliente o recarga sus servidores MCP.
Ejecutamos nosotros mismos los comandos de esta página el 18 de noviembre de 2026, en una configuración limpia, con una clave con permisos y contra producción. Documentación del proveedor