Conectar Adhook con asistentes de IA (MCP)

Descubre cómo conectar tu cuenta de Adhook con Claude, Claude Code u otros asistentes de IA a través del servidor MCP. Además, aprenderás a usar en tus publicaciones imágenes y vídeos guardados en tu ordenador.

¿Qué es el MCP de Adhook?

El servidor MCP de Adhook conecta asistentes de IA como Claude o ChatGPT directamente con tu cuenta de Adhook. Después, en el chat puedes, entre otras cosas:

crear, programar y editar publicaciones en redes sociales
configurar y gestionar promociones de publicaciones y campañas publicitarias
gestionar temas, tareas y entradas del calendario
responder y moderar comentarios, mensajes y reseñas
analizar el social listening y las publicaciones de influencers
consultar, crear y analizar informes
crear informes ad hoc (más de 10 fuentes de datos, más de 100 segmentos, más de 250 métricas)

Para ello no necesitas abrir la interfaz de Adhook.

MCP significa Model Context Protocol. Se trata de un estándar abierto que permite a los asistentes de IA comunicarse con servicios externos.

Para los administradores de agencias existe además el MCP Adhook Management para el onboarding de nuevos clientes. Se describe al final de este artículo. Para el trabajo diario solo necesitas el MCP de Adhook.

Requisitos

Una cuenta de Adhook con los permisos necesarios
Un cliente que admita conectores MCP remotos, por ejemplo:
- Claude en el navegador
- Claude Desktop
- Claude Code
- ChatGPT
- otro asistente de IA compatible con MCP

Instalación y conexión

URL del servidor:

https://mcp.adhook.io/mcp

La primera vez que te conectes, iniciarás sesión mediante OAuth con tus credenciales de Adhook. El acceso se limita a tus permisos personales de Adhook.

Tu contraseña no se comparte con el asistente de IA. Puedes revocar la conexión en cualquier momento en Adhook o en el asistente correspondiente.

Claude en el navegador o Claude Desktop

Abre Configuración → Conectores.
Selecciona Añadir conector personalizado.
Introduce la siguiente URL: https://mcp.adhook.io/mcp
Guarda el conector.
Haz clic en Conectar e inicia sesión con tu cuenta de Adhook.

A continuación aparece el conector Adhook con las herramientas disponibles.

Claude Code en la terminal

claude mcp add --transport http adhook https://mcp.adhook.io/mcp

La primera vez que lo uses, se abrirá el inicio de sesión de Adhook en el navegador.

Con --scope user puedes hacer que el conector esté disponible en todos los proyectos del usuario:

claude mcp add --transport http --scope user adhook https://mcp.adhook.io/mcp

ChatGPT en el navegador

Abre Configuración → Plugins → Avanzado.
Activa el modo desarrollador.
Selecciona Crear plugin.
Introduce la siguiente URL: https://mcp.adhook.io/mcp
Guarda el plugin.
Haz clic en Conectar e inicia sesión con tu cuenta de Adhook.

A continuación, el plugin Adhook estará disponible en ChatGPT con las herramientas disponibles.

Otros asistentes de IA

Cualquier cliente que admita conectores MCP remotos puede añadir la siguiente URL como conector personalizado:

https://mcp.adhook.io/mcp

Esto también es posible, por ejemplo, con ChatGPT en modo desarrollador o de conectores. Los pasos exactos varían según el cliente.

Herramientas disponibles en el MCP de Adhook

El asistente elige por sí mismo las herramientas adecuadas. No necesitas conocer los nombres de las herramientas: simplemente describe lo que quieres conseguir. El resumen muestra lo que es posible.

Cuenta, marcas y equipo

Herramienta	Función
`get_current_user`	Muestra el usuario de Adhook conectado actualmente.
`get_subtenants`	Muestra tus marcas.
`find_subtenant_by_name`	Busca una marca por su nombre.
`get_users`	Muestra los usuarios de tu cuenta con nombre y correo electrónico.
`get_teams`	Muestra los equipos, por ejemplo para asignar mensajes o tareas a un equipo.
`get_tags`	Muestra las etiquetas disponibles, opcionalmente filtradas por nombre.

Publicaciones

Herramienta	Función
`get_posts`	Muestra o busca publicaciones. Se puede filtrar, entre otros, por texto, estado, marca, periodo y canales.
`get_post_by_id`	Obtiene todos los detalles de una publicación.
`create_post`	Crea una publicación con texto, canales, imágenes o vídeos, fecha de publicación, temas, etiquetas y responsables. Se pueden usar textos, medios y enlaces distintos por canal. Opcionalmente se puede configurar directamente una promoción.
`update_post`	Edita una publicación existente, por ejemplo el texto, los canales, la fecha, los medios o la promoción.
`update_post_tags`	Añade o elimina etiquetas en una o varias publicaciones sin modificar las demás etiquetas.
`submit_post`	Envía una publicación para su aprobación o la activa.
`delete_post`	Elimina una publicación. Solo es posible con publicaciones creadas a través del MCP.

Los canales compatibles incluyen Facebook, Instagram, LinkedIn, TikTok, X, Pinterest, YouTube y Google Business Profile. Los canales sin una cuenta conectada de la marca se deseleccionan automáticamente.

Medios

Herramienta	Función
`upload_media`	Importa en Adhook una imagen o un vídeo accesible públicamente a partir de su URL.
`create_media_upload_url`	Crea una URL de subida temporal para un archivo local. La utiliza la extensión Local Media (ver más abajo).
`get_pinterest_boards`	Muestra los tableros de Pinterest de una marca. Es necesario para crear publicaciones en Pinterest.

Campañas publicitarias y promociones

Herramienta	Función
`get_campaigns`	Muestra o busca campañas publicitarias.
`get_campaign_by_id`	Obtiene todos los detalles de una campaña, incluidos grupos de anuncios, presupuesto, ubicaciones y creatividades.
`create_campaign`	Crea una campaña publicitaria con creatividades, segmentación, presupuesto, duración y canales, por ejemplo Meta, LinkedIn, Google Ads, TikTok y Pinterest. Un presupuesto total se reparte entre los canales seleccionados.
`update_campaign`	Edita una campaña existente, por ejemplo el nombre, la duración, las creatividades, la segmentación, el presupuesto, los canales o los temas.
`submit_campaign`	Revisa una campaña y la envía para su aprobación o la activa, según el proceso de aprobación configurado.
`change_campaign_status`	Pausa, reanuda o finaliza una campaña.
`update_campaign_tags`	Añade o elimina etiquetas en una o varias campañas.
`delete_campaign`	Elimina una campaña en Adhook. Solo se elimina también en las plataformas publicitarias si lo pides expresamente.
`get_targeting_templates`	Muestra las plantillas de segmentación activas de una marca. La plantilla se usa para las promociones mediante `create_post` o `update_post`.

Una promoción se configura directamente al crear o actualizar una publicación. Puedes definir, entre otros, el presupuesto, el canal, la duración, las ubicaciones y la plantilla de segmentación.

Temas, tareas y calendario

Herramienta	Función
`get_topics`, `get_topic_by_id`	Muestra los temas u obtiene los detalles de un tema.
`create_topic`, `update_topic`	Crea o edita un tema para la planificación editorial.
`delete_topic`	Elimina un tema. Se elimina el vínculo con publicaciones, campañas y entradas del calendario, y se eliminan las tareas vinculadas.
`get_tasks`, `get_task_by_id`	Busca tareas por texto, tema, responsable, estado, marca o fecha de vencimiento, u obtiene una tarea.
`create_task`, `update_task`	Crea una tarea o la edita, la reprograma, la asigna o la completa.
`delete_task`	Elimina una tarea.
`get_custom_events`, `get_custom_event_by_id`	Muestra tus propias entradas del calendario, como newsletters, campañas impresas, notas de prensa o eventos, u obtiene una entrada.
`create_custom_event`, `update_custom_event`	Crea o edita una entrada del calendario con fecha, tipo, descripción, temas, presupuesto y responsable. No se envía ni se publica nada.
`delete_custom_event`	Elimina una entrada del calendario.

Community management

Herramienta	Función
`get_threads`, `get_thread_by_id`	Muestra las conversaciones de la bandeja de entrada u obtiene una conversación.
`update_thread`, `assign_thread`	Cambia el estado, las etiquetas o la marca de una conversación, o la asigna a una persona o un equipo.
`get_messages`, `get_message_by_id`	Muestra comentarios, mensajes, menciones y reseñas, u obtiene un mensaje concreto.
`get_message_post_details`	Muestra la publicación original a la que pertenece un comentario.
`get_moderation_activity`	Muestra el historial y las notas internas de una conversación o un mensaje.
`update_message_status`, `assign_message`	Establece el estado de un mensaje (abierto, en curso, terminado) o lo asigna.
`update_message`, `update_message_tags`	Cambia las etiquetas, la marca o el sentimiento de uno o varios mensajes.
`reply_message`	Responde directamente en la plataforma a un comentario, un mensaje o una mención.
`add_discussion_note`	Añade una nota interna, con notificación opcional a miembros del equipo o por correo electrónico.
`moderate_message_action`	Da me gusta, oculta, vuelve a mostrar o elimina un comentario en la plataforma. Las acciones disponibles dependen de la red. Por ejemplo, en TikTok no se pueden eliminar comentarios de terceros.

Social listening

Herramienta	Función
`get_social_listening_items`	Obtiene contenido de social listening con métricas de interacción: publicaciones de perfiles monitorizados (por ejemplo, competidores), coincidencias de hashtags y palabras clave, noticias, sitios web, menciones, comentarios y reseñas. También es útil para encontrar ideas de contenido comparándolas con tus propias publicaciones.

Influencers

Herramienta	Función
`get_influencers`, `get_influencer_by_id`	Muestra los influencers u obtiene un perfil con cuentas en redes sociales, número de seguidores, marcas y etiquetas.
`get_influencer_posts`	Muestra las publicaciones de influencers registradas.
`get_influencer_results`	Muestra los resultados agregados de un influencer en un periodo, por ejemplo publicaciones, interacción, visualizaciones y alcance.
`log_influencer_post_by_url`	Registra una publicación o un reel de Instagram a partir de su URL. La fecha, el texto y las métricas públicas se cargan automáticamente. Requiere una cuenta profesional o de creador pública.
`create_influencer_post`	Registra manualmente una publicación de influencer con fecha, canal y métricas, por ejemplo para canales distintos de Instagram.

Informes

Herramienta	Función
`get_reports`, `get_report_by_id`	Muestra los informes existentes u obtiene la configuración de un informe.
`create_report`, `update_report`	Crea un nuevo informe o cambia el nombre, el periodo, el alcance de los datos, los filtros y el diseño.
`delete_report`	Elimina un informe.
`get_report_widgets`	Muestra los widgets y métricas de un informe.
`get_report_widget_data`	Obtiene los datos de un widget concreto.
`create_report_widget`, `update_report_widget`	Añade a un informe gráficos, tablas, resúmenes de KPI, textos, imágenes o saltos de página, o los modifica, incluidos fuente de datos, métricas, segmentos, filtros y orden.
`delete_report_widget`	Elimina un widget de un informe.
`run_headless_report`	Ejecuta un análisis ad hoc para un periodo sin guardar un informe. Accede a más de 10 fuentes de datos, más de 100 segmentos y más de 250 métricas, por ejemplo anuncios de pago, publicaciones orgánicas, analítica web, community management, newsletters y SEO.

Ejemplos de solicitudes

«Muéstrame todas las publicaciones programadas de la marca Ejemplo SA para la próxima semana.»
«Crea para Ejemplo SA una publicación de LinkedIn e Instagram para el próximo viernes a las 10:00.»
«Usa para la publicación el siguiente texto y las imágenes producto-1.jpg y producto-2.jpg.»
«Promociona esta publicación con 150 CHF durante siete días. Usa el objetivo Interacción y la plantilla de segmentación DACH Amplia.»
«¿Qué comentarios de ayer siguen sin respuesta? Propónme respuestas.»
«¿Qué informes hay para Ejemplo SA?»
«¿Cómo evolucionó el alcance de la marca el mes pasado?»
«Muéstrame el tráfico web procedente del correo electrónico, desglosado por campaña.»

Usar imágenes y vídeos locales

Un conector remoto como el MCP de Adhook no puede acceder directamente a los archivos de tu ordenador. Tampoco una imagen arrastrada al chat se transmite al MCP de Adhook a través del asistente de IA.

Por ello, para los archivos que solo están disponibles localmente hay una extensión adicional. Se ejecuta en tu ordenador y sube el archivo seleccionado a Adhook.

Importante: esta función solo está disponible con Claude Desktop y Claude Code. No funciona en claude.ai en el navegador ni en otros clientes puramente web. En esos casos, utiliza URL de acceso público para los medios de tus publicaciones, o sube primero los archivos a la Media Library de Adhook y usa las URL de los medios.

1. Actualizar el conector de Adhook

Para que la herramienta create_media_upload_url esté disponible para el asistente, desconecta una vez el conector de Adhook y vuelve a conectarlo.

También puedes reiniciar Claude Desktop.

2. Crear una carpeta de medios

Crea una carpeta desde la que el asistente pueda usar archivos.

Ejemplos:

macOS: ~/AdhookMedia
Windows: C:\Users\<Nombre>\AdhookMedia

3. Instalar la extensión

Claude Desktop

Descarga la extensión: https://media.adhook.io/adhook-local-media-0.1.0.mcpb
Abre el archivo descargado con un doble clic. Claude Desktop mostrará el cuadro de diálogo de instalación.
Si no ocurre nada, abre en Claude Desktop Settings → Extensions → Install Extension y selecciona el archivo descargado.
En el campo Media folder, selecciona la carpeta creada en el paso 2.
Si es necesario, confirma el aviso de que la extensión no está verificada.
Completa la instalación. Adhook Local Media Upload aparecerá como extensión activa en Settings → Extensions.

No es necesario instalar Node.js ni un entorno de ejecución similar por separado. Todos los componentes necesarios están incluidos en el paquete.

Claude Code

Ejecuta el siguiente comando en la terminal:

claude mcp add adhook-media --scope user \   --env ADHOOK_MEDIA_DIR="$HOME/AdhookMedia" \   -- npx -y @adhookio/local-media-mcp

Se necesita Node.js 18 o una versión posterior.

4. Usar medios locales

Coloca la imagen o el vídeo directamente en la carpeta de medios configurada.

Pregunta al asistente, por ejemplo:

«¿Qué imágenes hay en la carpeta de medios?»

Después, crea la publicación:

«Crea una publicación de Adhook con producto.jpg y el siguiente texto: …»

El asistente sube el archivo automáticamente y lo añade a la publicación.

Conviene saber

El archivo debe estar directamente en la carpeta de medios compartida.
Los archivos de subcarpetas no se tienen en cuenta.
Indica en tu solicitud el nombre exacto del archivo.
Una imagen arrastrada a la ventana del chat no se usa automáticamente a través de la extensión.
El tamaño máximo de archivo es de 100 MB.
Para actualizar la extensión, instala la nueva versión .mcpb de la misma manera. Sustituye a la versión anterior.

Solución de problemas

Problema	Solución
El asistente no encuentra herramientas de Adhook	Comprueba la conexión del conector y vuelve a conectar el conector de Adhook. Si es necesario, reinicia Claude Desktop.
Falta `create_media_upload_url`	Desconecta el conector de Adhook y vuelve a conectarlo.
La extensión Local Media muestra «not running»	Reinicia Claude Desktop.
La subida falla	Comprueba en la configuración de la extensión que la ruta de la carpeta de medios sea correcta.
No se encuentran las imágenes o los vídeos	Comprueba que los archivos estén directamente en la carpeta de medios y no en una subcarpeta.
No se puede eliminar una publicación	A través del MCP solo se pueden eliminar publicaciones creadas previamente a través del MCP.

Seguridad y protección de datos

La conexión se realiza mediante OAuth con tus credenciales de Adhook. Tu contraseña no se comparte con el asistente.
El asistente solo puede acceder a los datos y acciones para los que tu usuario de Adhook tiene permisos.
La extensión Local Media se ejecuta exclusivamente en local.
La extensión solo puede acceder a los archivos de la carpeta que hayas seleccionado.
Puedes revocar la conexión en cualquier momento en el asistente o en tu configuración de Adhook.

Para administradores de agencias: MCP Adhook Management

Esta sección solo es relevante si configuras nuevos clientes y cuentas publicitarias para tu agencia. Para el trabajo diario con publicaciones, campañas e informes basta con el MCP de Adhook.

El MCP Management es un servidor independiente que conectas como segundo conector. Con él puedes realizar el onboarding de un nuevo cliente en el chat: crear la marca, crear una cuenta publicitaria, solicitar acceso a la página de Facebook del cliente, definir los permisos de usuario en el Meta Business Manager y asignarlo todo a la marca.

Algunas acciones, como crear marcas y cuentas publicitarias, están reservadas a los administradores. Las cuentas publicitarias no se pueden eliminar a través de la API. Por eso, el asistente te pide confirmación antes de estos pasos, por ejemplo para el nombre, la moneda y la zona horaria de una nueva cuenta publicitaria.

Conexión

Añade un segundo conector como se describe más arriba en Instalación y conexión, pero con esta URL:

https://mcp.adhook.io/mcp/management

Asigna al conector un nombre propio, por ejemplo Adhook Management. En Claude Code:

claude mcp add --transport http --scope user adhook-management https://mcp.adhook.io/mcp/management

Proceso típico de onboarding en Meta

Identificar la página de Facebook del cliente a partir de su URL.
Comprobar si tu Business Manager ya tiene acceso a la página y, si no, solicitar el acceso al cliente.
Esperar a que el cliente haya aceptado la solicitud y, después, asignar la página a personas de tu Business Manager.
Crear la marca en Adhook.
Crear una cuenta publicitaria de Meta y asignarla a la marca. La página del cliente se registra como anunciante.
Asignar más personas a la cuenta publicitaria.
Asignar la página de Facebook y la cuenta de Instagram a la marca y comprobar el resultado.

También puedes pedírselo directamente al asistente: «Configura el nuevo cliente Ejemplo SA con la página de Facebook facebook.com/ejemplosa.» El asistente te guiará por estos pasos.

Marcas

Herramienta	Función
`get_subtenants`, `find_subtenant_by_name`	Muestra tus marcas o busca una marca por su nombre.
`get_subtenant_by_id`	Muestra toda la configuración de una marca, incluidas las cuentas de canales asignadas.
`create_subtenant`	Crea una nueva marca, sucursal o un nuevo cliente. Solo para administradores.
`update_subtenant`	Cambia la configuración general de una marca, por ejemplo el nombre, la marca principal, el sitio web, los idiomas, el responsable, el estado, las aprobaciones para publicaciones y publicidad, así como el beneficiario y el pagador de los anuncios de Meta.
`assign_meta_assets_to_subtenant`	Asigna a una marca una cuenta publicitaria de Meta, una página de Facebook y una cuenta de Instagram.

Meta (Facebook e Instagram)

Herramienta	Función
`get_meta_ad_accounts`	Muestra las cuentas publicitarias de Meta conectadas en Adhook.
`sync_meta_ad_accounts`	Importa las cuentas publicitarias a las que has obtenido acceso desde que conectaste Facebook, por ejemplo cuentas creadas manualmente en el Business Manager.
`create_meta_ad_account`	Crea una nueva cuenta publicitaria de Meta en el Business Manager de tu agencia y, opcionalmente, la asigna a una marca. Solo para administradores.
`get_facebook_pages`	Muestra las páginas de Facebook a las que tiene acceso el usuario de Facebook conectado.
`resolve_facebook_page`	Identifica el ID y el nombre de una página de Facebook a partir de su URL, su nombre de usuario o su ID.
`get_facebook_page_access_status`	Indica si tu Business Manager tiene acceso a una página y el estado de las solicitudes de acceso pendientes.
`request_facebook_page_access`	Solicita al cliente acceso de agencia a su página de Facebook para poder publicar anuncios en su nombre.
`get_meta_business_users`	Muestra las personas y los usuarios del sistema del Business Manager de tu agencia.
`assign_user_to_facebook_page`, `remove_user_from_facebook_page`	Asigna una página de Facebook a una persona de tu Business Manager con tareas concretas (por ejemplo, publicar anuncios y ver estadísticas), cambia las tareas o retira a la persona.
`get_meta_ad_account_users`	Muestra las personas asignadas a una cuenta publicitaria, con sus tareas.
`assign_user_to_meta_ad_account`, `remove_user_from_meta_ad_account`	Asigna una cuenta publicitaria a una persona con un rol, cambia el rol o retira a la persona.

Herramienta	Función
`get_linkedin_ad_accounts`	Muestra las cuentas publicitarias de LinkedIn conectadas en Adhook.
`get_linkedin_pages`	Muestra las páginas de empresa de LinkedIn que administra la cuenta de LinkedIn conectada.
`create_linkedin_ad_account`	Crea una nueva cuenta publicitaria de LinkedIn para una página de empresa. La moneda no se puede cambiar después y tendrás que añadir un método de pago en LinkedIn. Solo para administradores.
`sync_linkedin_ad_accounts`	Importa las cuentas publicitarias de LinkedIn a las que has obtenido acceso desde que conectaste LinkedIn.

Usuarios

Herramienta	Función
`get_current_user`	Muestra el usuario de Adhook conectado actualmente.
`get_users`	Muestra los usuarios de tu cuenta, por ejemplo para definir el responsable de una marca.

Ejemplos de solicitudes

«Crea la marca Ejemplo SA y una cuenta publicitaria de Meta en CHF.»
«Solicita acceso a la página de Facebook facebook.com/ejemplosa.»
«¿Quién de nuestro Business Manager tiene acceso a la cuenta publicitaria de Ejemplo SA?»

Conviene saber

Si faltan herramientas como create_subtenant, el conector Management no está conectado.
Solo los administradores pueden crear marcas y cuentas publicitarias.
Si no se encuentra una cuenta publicitaria existente, pide al asistente que sincronice las cuentas publicitarias de Meta o LinkedIn.
El asistente solo realiza acciones de mayor alcance, como crear cuentas publicitarias o cambiar permisos de usuario, después de tu confirmación.