Cheerful AI MCP
Gestiona marketing de influencers desde Claude o ChatGPT: busca creadores, lee respuestas de campañas, reporta el rendimiento y consulta qué creadores publicaron. Servidor remoto, OAuth 2.1.
Documentación
Cheerful ejecuta un servidor MCP remoto. Añádelo como conector en Claude, ChatGPT, Cursor o cualquier otro cliente MCP, inicia sesión con tu cuenta de Cheerful, y el asistente podrá leer tus campañas, comprobar quién respondió, informar sobre el rendimiento, ver qué creadores publicaron para tus campañas, consultar tus listas de creadores y buscar creadores, usando tu propia cuenta y tus propios permisos. Catorce de las veinte herramientas solo leen datos; la búsqueda de creadores consume créditos y, para YouTube, guarda los resultados en una nueva lista de tu cuenta, save_creators_to_list guarda creadores en tus propias listas de forma gratuita, y las herramientas de campaña pueden crear y editar borradores. Una campaña solo se envía cuando haces clic en Confirmar y enviar en la tarjeta de lanzamiento.
Cheerful ejecuta un servidor MCP remoto en mcp.cheerful.ai/mcp que permite a Claude, ChatGPT o cualquier cliente MCP leer tus campañas de influencers, respuestas y listas de creadores a través de tu propia cuenta de Cheerful.
Cómo configurarlo
- 1
Copia la URL del servidor
Es https://mcp.cheerful.ai/mcp. No hay nada que instalar ni ninguna clave que generar. - 2
Añádelo como conector personalizado
En Claude: Configuración → Conectores → Añadir conector personalizado, y pega la URL. En ChatGPT, añádelo en conectores dentro de la configuración. En Cursor, VS Code o Windsurf, añádelo al archivo de configuración MCP del editor como servidor remoto. En un espacio de trabajo de Claude Team o Enterprise, solo el propietario de la organización puede añadir un conector; si la opción no aparece, esa es la razón, y es la causa más común de que este paso falle. - 3
La URL del servidor
Servidor MCP remoto (HTTP transmisible)
https://mcp.cheerful.ai/mcp
Autenticado con OAuth 2.1. No hay clave de API ni nada que instalar.
Es un servidor remoto, por lo que no hay proceso local, ni envoltorio npx ni archivo de configuración que mantener sincronizado entre máquinas. Inicia sesión una vez por cliente. https://mcp.cheerful.ai/mcp/healthz responde sin token si necesitas comprobar que el endpoint es accesible antes de culpar a tu cliente.
Cómo se ve
Claude · Conector CheerfulSolo lectura
Demostración ilustrativa. Los nombres de las herramientas y las marcas de solo lectura son reales; los números de campaña están inventados para el ejemplo y no son una referencia.
Los chips de herramientas son la parte que vale la pena observar. Cada llamada que hace el asistente es una de veinte herramientas con nombre, catorce de ellas marcadas como solo lectura, y tu cliente te muestra cuáles se ejecutaron. Nada en este intercambio escribe nada: el asistente leyó dos campañas y su rendimiento, y la respuesta se compone a partir de lo que encontró.
Qué puedes preguntarle
Pregunta en inglés sencillo. El servidor incluye un mapa de instrucciones que le dice al asistente qué herramienta responde a cada pregunta, así no tienes que nombrar las herramientas tú mismo.
| Preguntas | Llama a |
|---|---|
| ¿Cuál de mis campañas tiene la peor tasa de respuesta este mes? | campaign_report |
| ¿Quién me respondió ayer y qué dijeron? | inbox_read |
| Redáctame un resumen de cada creador que sigue esperando una respuesta. | inbox_read |
| ¿Desde qué buzón se envía realmente la campaña de regalos de primavera? | campaign_read |
| ¿Cuántos creadores optaron por participar en todas mis campañas este trimestre? | campaign_report |
| ¿Qué creadores publicaron para mis campañas? Muestra las mejores publicaciones por vistas. | campaign_content |
| ¿Estoy conectado a Shopify y la conexión está en buen estado? | integration_status |
| ¿Qué hay en mi lista "fitness Reino Unido"? | list_read |
| ¿Por qué se bloqueó mi última búsqueda? | billing_usage |
| Encuéntrame creadores de preparación de comidas veganas en Canadá con 10k–50k seguidores. | creator_search |
| Cuéntame sobre @mayamoves en TikTok. | creator_profile |
Las seis primeras son las que vale la pena probar primero. Son preguntas sobre trabajo ya en curso, y responderlas a mano significa abrir una campaña, un buzón y una página de facturación en tres pestañas.
Las trece herramientas
| Herramienta | Responde a | Costo |
|---|---|---|
creator_search | Encontrar o descubrir creadores. | Créditos |
creator_search_status | ¿Ha terminado mi búsqueda en YouTube? | Gratis |
creator_profile | Cuéntame sobre @handle. | Gratis |
list_read | Qué he guardado. | Gratis |
campaign_read | Qué campañas tengo y quién las envía. | Gratis |
campaign_report | Cómo está funcionando. | Gratis |
campaign_content | Quién publicó y qué publicaciones funcionaron mejor. | Gratis |
inbox_read | Qué volvió y quién respondió. | Gratis |
integration_status | ¿Estoy conectado a X? | Gratis |
account_read | Quién soy y qué puedo hacer. | Gratis |
billing_usage | Créditos y por qué algo fue bloqueado. | Gratis |
get_profile | ¿Qué perfil de Cheerful es esta conexión? | Gratis |
save_creators_to_list | Guardar estos creadores en una lista. | Gratis |
Los argumentos, las formas de respuesta y las trampas de cada uno están en la página de herramientas. Las búsquedas consumen créditos a la misma tasa que la aplicación web; todas las demás herramientas son gratuitas.
Las cosas que de otro modo te costarán una tarde
Estas están tomadas de las propias instrucciones del servidor, es decir, son lo que el conector le dice al modelo antes de que escribas nada. Están aquí porque una página de documentación que las oculta es una página de documentación de la que descubres más tarde que estaba equivocada.
- Una búsqueda filtrada o inteligente de creadores tarda 90–155 segundos, y un perfil frío de creador unos 60. Esa es la forma normal, no un cuelgue. Reintentar por encima de una llamada en ejecución gasta créditos dos veces y no lo hace más rápido.
- La búsqueda inteligente solo vincula una ubicación para quince países. Una mención breve en cualquier otro lugar hace que su ubicación se descarte silenciosamente y vuelva global: usa una búsqueda por palabras clave con un nombre de país explícito.
- La mayoría de los creadores no tienen correo electrónico público. Ese es el caso común, no un fallo, y no es motivo para buscar de nuevo: los correos se enriquecen cuando un creador se añade a una campaña.
- Un
totalen un resultado de búsqueda es el grupo de prefiltrado del proveedor, a menudo decenas de miles. No es lo que recibiste, y un asistente que lo informe como "encontró 40,000 creadores" lo está leyendo mal. - Las campañas pueden pertenecer a un compañero de equipo. Las lecturas abarcan tu propio trabajo más todo lo que tus equipos comparten, y cada campaña lleva el
team_idy elowner_emailque indican de quién es. - Los remitentes pertenecen a la campaña, no a ti. Un buzón que puedes leer no es necesariamente uno desde el que puedas enviar.
- Un 404 y "no es tuyo" son deliberadamente la misma respuesta, así que un 404 no es prueba de que algo no exista.
- Un 402 significa que te quedaste sin créditos, no que algo se rompió.
Inicio de sesión, permisos y datos
El conector usa OAuth 2.1. Tu cliente descubre dónde iniciar sesión a partir de los metadatos de recursos protegidos del servidor, te envía a Cheerful y recibe un token emitido para ese cliente para tu cuenta. Nunca vemos la conversación de tu asistente, y tu asistente nunca ve una contraseña de Cheerful.
Un token de conector lleva exactamente tus propios permisos. Lee tus campañas y las que tus equipos comparten contigo, los buzones a los que se te ha concedido acceso, y nada más. Revocar el conector en tu cliente termina su acceso; una sesión de Cheerful que ha sido revocada deja de funcionar a través del conector en el mismo momento en que deja de funcionar en la aplicación.
Lo que almacenamos sobre el uso del conector es lo que almacenamos sobre cualquier uso de tu cuenta. La política de privacidad lo cubre, y vale la pena leerla antes de conectar una cuenta de trabajo a un asistente.
En qué se diferencia de los otros servidores MCP de marketing de influencers
Hay otro servidor MCP en esta categoría, y expone búsquedas de creadores: datos de audiencia, tasas de participación, costos estimados, datos de contacto. Útil, y genuinamente lo mismo que hace nuestra búsqueda de creadores.
La diferencia es todo lo que lo rodea. El conector de Cheerful lee campañas, remitentes, la bandeja de entrada, respuestas, equipos y créditos: el estado del alcance que ya está en marcha. Eso no es un producto de datos; es el registro operativo del trabajo en curso, y es lo que hace que "qué campaña está rindiendo mal y desde quién se envía" se pueda responder en un turno en lugar de cinco.
Lo que esto no hace
- Catorce de las veinte herramientas son de solo lectura.
creator_search(gasta créditos; para YouTube, guarda resultados en una nueva lista),save_creators_to_list(guarda creadores en tus propias listas, gratis) y cuatro herramientas de campaña están anotadas como no solo lectura. Solocampaign_send, llamado desde la tarjeta de lanzamiento después de que el usuario haga clic en Confirmar y enviar, envía correos electrónicos. Ninguna herramienta realiza un pedido. - No puede conectar una integración, reconectar una rota ni cambiar ninguna configuración.
integration_statusinforma; la aplicación web actúa. - La búsqueda de creadores tarda 90–155 segundos y los perfiles fríos unos 60. Un cliente con un tiempo de espera corto de herramienta se rendirá antes de que el servidor responda, y eso parece un fallo pero no lo es.
- La búsqueda inteligente vincula una ubicación solo para quince países. En cualquier otro lugar se necesita una búsqueda por palabras clave con un nombre de país explícito, o los resultados vuelven globales.
- En un espacio de trabajo de Claude Team o Enterprise, añadir un conector personalizado requiere un propietario de la organización. Nada de lo que enviamos cambia eso.
- El servidor aún no está listado en el Directorio de Conectores de Claude ni en el directorio de plugins de ChatGPT, por lo que debe añadirse como conector personalizado. Eso funciona en cualquier plan de pago.
Preguntas frecuentes
https://mcp.cheerful.ai/mcp — un servidor MCP remoto de HTTP transmisible autenticado con OAuth 2.1. Pégalo en tu cliente como conector personalizado.
No. Es una URL pegada en la configuración de conectores de tu asistente y un inicio de sesión en el navegador. No hay nada que instalar ni ninguna clave que generar.
No. Las lecturas son gratuitas y las búsquedas de creadores consumen los mismos créditos que usa la aplicación web. No hay plan de desarrollador.
No. Catorce de las veinte herramientas solo leen datos. La búsqueda de creadores gasta créditos y, para YouTube, guarda resultados en una nueva lista de tu cuenta; save_creators_to_list guarda creadores en tus propias listas de forma gratuita. Las herramientas de campaña crean y editan borradores, y una campaña solo se envía después de que el usuario haga clic en Confirmar y enviar en la tarjeta de lanzamiento.
Sí. Cualquier cliente que hable MCP sobre HTTP transmisible con OAuth funciona, incluidos ChatGPT, Cursor, VS Code y Windsurf.
En un espacio de trabajo de Claude Team o Enterprise, solo el propietario de la organización puede añadir un conector personalizado. Esa es la razón más común por la que la configuración falla en el primer paso.
Exactamente lo que tu cuenta de Cheerful puede ver: tus propias campañas, listas y buzones, más cualquier cosa que tus equipos compartan contigo. No puede acceder a nada que tu propio inicio de sesión no pudiera.
Sí, cada uno con su propia cuenta. Dos compañeros de equipo que conectan el mismo servidor ven datos diferentes, porque el token es suyo en lugar del espacio de trabajo.
Elimina el conector en tu cliente. Eso termina su acceso inmediatamente, y revocar tu sesión de Cheerful hace lo mismo desde nuestro lado.
Una búsqueda filtrada o inteligente se ejecuta sobre un catálogo indexado de cientos de millones de creadores y tarda 90–155 segundos. Es la misma búsqueda que ejecuta la aplicación web, y la espera es el trabajo en lugar de un fallo.
No una pública hoy. El servidor MCP y la CLI son las dos superficies orientadas a máquina compatibles, y ambas se autentican mediante un inicio de sesión en el navegador en lugar de una clave de API.
¿Te resultó útil esta página?