Cheerful AI MCP

Cheerful executa um servidor MCP remoto. Adicione-o como conector no Claude, ChatGPT, Cursor ou qualquer outro cliente MCP, faça login com sua conta Cheerful, e o assistente poderá ler suas campanhas, verificar quem respondeu, relatar desempenho, ver quais criadores publicaram para suas campanhas, consultar suas listas de criadores e pesquisar criadores — usando sua própria conta e suas próprias permissões. Quatorze das vinte ferramentas apenas leem dados; a pesquisa de criadores gasta créditos e, para YouTube, salva resultados em uma nova lista na sua conta, save_creators_to_list salva criadores nas suas próprias listas gratuitamente, e as ferramentas de campanha podem criar e editar rascunhos. Uma campanha é enviada somente quando você clica em Confirmar e enviar no cartão de lançamento.

Cheerful executa um servidor MCP remoto em mcp.cheerful.ai/mcp que permite que Claude, ChatGPT ou qualquer cliente MCP leia suas campanhas de influenciadores, respostas e listas de criadores por meio da sua própria conta Cheerful.

Como configurar

1. 1

   Copie a URL do servidor

   É https://mcp.cheerful.ai/mcp. Não há nada para instalar e nenhuma chave para gerar.
2. 2

   Adicione como conector personalizado

   No Claude: Configurações → Conectores → Adicionar conector personalizado e cole a URL. No ChatGPT, adicione-o em conectores nas configurações. No Cursor, VS Code ou Windsurf, adicione-o ao arquivo de configuração MCP do editor como servidor remoto. Em um workspace Claude Team ou Enterprise, apenas um proprietário da organização pode adicionar um conector — se a opção estiver ausente, é por isso, e é o motivo mais comum para esta etapa falhar.
3. 3

A URL do servidor

Servidor MCP remoto (HTTP streamable)

https://mcp.cheerful.ai/mcp

Autenticado com OAuth 2.1. Não há chave de API e nada para instalar.

É um servidor remoto, portanto não há processo local, wrapper npx ou arquivo de configuração para manter sincronizado entre máquinas. Faça login uma vez por cliente. https://mcp.cheerful.ai/mcp/healthz responde sem token se você precisar provar que o endpoint está acessível antes de culpar seu cliente.

Como parece

Claude · Conector CheerfulSomente leitura

Demonstração ilustrativa. Os nomes das ferramentas e as marcações de somente leitura são reais; os números de campanha são inventados para o exemplo e não são um benchmark.

Os chips de ferramentas são a parte que vale a pena observar. Cada chamada que o assistente faz é uma das vinte ferramentas nomeadas, quatorze delas marcadas como somente leitura, e seu cliente mostra quais foram executadas. Nada neste intercâmbio escreve qualquer coisa: o assistente leu duas campanhas e seu desempenho, e a resposta é montada a partir do que encontrou.

O que você pode perguntar

Pergunte em inglês simples. O servidor inclui um mapa de instruções que informa ao assistente qual ferramenta é responsável por qual pergunta, então você não precisa nomear as ferramentas.

Você pergunta	Ele chama
Qual das minhas campanhas tem a pior taxa de resposta este mês?	campaign_report
Quem me respondeu ontem e o que disseram?	inbox_read
Elabore um resumo de cada criador ainda aguardando resposta.	inbox_read
De qual caixa de entrada a campanha de presentes de primavera está realmente enviando?	campaign_read
Quantos criadores optaram por participar em todas as minhas campanhas neste trimestre?	campaign_report
Quais criadores publicaram para minhas campanhas? Mostre as principais publicações por visualizações.	campaign_content
Estou conectado ao Shopify e a conexão está saudável?	integration_status
O que está na minha lista "fitness UK"?	list_read
Por que minha última pesquisa foi bloqueada?	billing_usage
Encontre criadores veganos de preparo de refeições no Canadá com 10 mil a 50 mil seguidores.	creator_search
Fale sobre @mayamoves no TikTok.	creator_profile

Os seis primeiros são os que valem a pena tentar primeiro. São perguntas sobre trabalho já em andamento, e respondê-las manualmente significa abrir uma campanha, uma caixa de entrada e uma página de cobrança em três abas.

As treze ferramentas

Ferramenta	Responde	Custo
creator_search	Encontrar ou descobrir criadores.	Créditos
creator_search_status	Minha pesquisa no YouTube terminou?	Grátis
creator_profile	Fale sobre @handle.	Grátis
list_read	O que salvei.	Grátis
campaign_read	Quais campanhas tenho e quem as está enviando.	Grátis
campaign_report	Como está o desempenho.	Grátis
campaign_content	Quem publicou e quais publicações foram melhores.	Grátis
inbox_read	O que voltou e quem respondeu.	Grátis
integration_status	Estou conectado a X.	Grátis
account_read	Quem sou eu e o que posso fazer.	Grátis
billing_usage	Créditos e por que algo foi bloqueado.	Grátis
get_profile	Qual perfil Cheerful é esta conexão?	Grátis
save_creators_to_list	Salvar estes criadores em uma lista.	Grátis

Argumentos, formatos de resposta e as armadilhas de cada um estão na página de ferramentas. Pesquisas consomem créditos na mesma taxa que o aplicativo web; todas as outras ferramentas são gratuitas.

As coisas que, de outra forma, custarão uma tarde

Estas foram retiradas das próprias instruções do servidor, ou seja, são o que o conector informa ao modelo antes de você digitar qualquer coisa. Estão aqui porque uma página de documentação que as esconde é uma página que você descobre estar errada depois.

• Uma pesquisa de criadores filtrada ou inteligente leva 90–155 segundos, e um perfil frio de criador cerca de 60. Essa é a forma normal, não um travamento. Tentar novamente por cima de uma chamada em execução gasta créditos duas vezes e não acelera.
• A pesquisa inteligente só vincula uma localização para quinze países. Uma menção breve em qualquer outro lugar tem sua localização silenciosamente descartada e volta global — use uma pesquisa por palavra-chave com um nome de país explícito.
• A maioria dos criadores não tem e-mail público. Esse é o caso comum, não uma falha, e não é motivo para pesquisar novamente — e-mails são enriquecidos quando um criador é adicionado a uma campanha.
• Um total em um resultado de pesquisa é o pool de pré-filtragem do provedor, muitas vezes dezenas de milhares. Não é o que você recebeu, e um assistente que relata como "encontrou 40.000 criadores" está lendo errado.
• Campanhas podem pertencer a um colega de equipe. As leituras abrangem seu próprio trabalho mais tudo o que suas equipes compartilham, e cada campanha carrega o team_id e o owner_email que dizem de quem é.
• Os remetentes pertencem à campanha, não a você. Uma caixa de entrada que você pode ler não é necessariamente uma da qual você pode enviar.
• Um 404 e "não é seu" são deliberadamente a mesma resposta, então um 404 não é prova de que algo não existe.
• Um 402 significa que você ficou sem créditos, em vez de algo ter quebrado.

Login, permissões e dados

O conector usa OAuth 2.1. Seu cliente descobre onde fazer login a partir dos metadados de recursos protegidos do servidor, envia você para Cheerful e recebe um token emitido para aquele cliente para sua conta. Nunca vemos a conversa do seu assistente, e seu assistente nunca vê uma senha Cheerful.

Um token de conector carrega exatamente suas próprias permissões. Ele lê suas campanhas e as que suas equipes compartilham com você, as caixas de entrada que lhe foram concedidas e nada mais. Revogar o conector no seu cliente encerra seu acesso; uma sessão Cheerful que foi revogada para de funcionar pelo conector no mesmo momento em que para de funcionar no aplicativo.

O que armazenamos sobre o uso do conector é o que armazenamos sobre qualquer uso da sua conta. A política de privacidade cobre isso, e vale a pena ler antes de conectar uma conta de trabalho a um assistente.

Como isso difere dos outros servidores MCP de marketing de influenciadores

Existe outro servidor MCP nesta categoria, e ele expõe consultas de criadores: dados de audiência, taxas de engajamento, custos estimados, detalhes de contato. Útil e genuinamente a mesma coisa que nossa pesquisa de criadores faz.

A diferença é tudo ao redor. O conector Cheerful lê campanhas, remetentes, a caixa de entrada, respostas, equipes e créditos — o estado do alcance que já está em andamento. Isso não é um produto de dados; é o registro operacional do trabalho em andamento, e é o que torna "qual campanha está com desempenho ruim e quem está enviando" respondível em uma única etapa em vez de cinco.

O que isso não faz

• Quatorze das vinte ferramentas são somente leitura. creator_search (gasta créditos; para YouTube, salva resultados em uma nova lista), save_creators_to_list (salva criadores nas suas próprias listas, grátis) e quatro ferramentas de campanha são anotadas como não somente leitura. Apenas campaign_send, chamada do cartão de lançamento após o usuário clicar em Confirmar e enviar, envia e-mail. Nenhuma ferramenta faz um pedido.
• Não pode conectar uma integração, reconectar uma quebrada ou alterar qualquer configuração. integration_status relata; o aplicativo web age.
• A pesquisa de criadores leva 90–155 segundos e perfis frios cerca de 60. Um cliente com timeout curto de ferramenta desistirá antes que o servidor responda, e isso parece uma falha, mas não é.
• A pesquisa inteligente vincula uma localização para apenas quinze países. Em qualquer outro lugar, é necessária uma pesquisa por palavra-chave com um nome de país explícito, ou os resultados voltam globais.
• Em um workspace Claude Team ou Enterprise, adicionar um conector personalizado requer um proprietário da organização. Nada que entregamos muda isso.
• O servidor ainda não está listado no Diretório de Conectores do Claude ou no diretório de plugins do ChatGPT, então deve ser adicionado como conector personalizado. Isso funciona em qualquer plano pago.

Perguntas frequentes

https://mcp.cheerful.ai/mcp — um servidor MCP remoto streamable-HTTP autenticado com OAuth 2.1. Cole-o no seu cliente como conector personalizado.

Não. É uma URL colada nas configurações de conector do seu assistente e um login no navegador. Não há nada para instalar e nenhuma chave para gerar.

Não. Leituras são gratuitas e pesquisas de criadores consomem os mesmos créditos que o aplicativo web usa. Não há plano de desenvolvedor.

Não. Quatorze das vinte ferramentas apenas leem dados. A pesquisa de criadores gasta créditos e, para YouTube, salva resultados em uma nova lista na sua conta; save_creators_to_list salva criadores nas suas próprias listas gratuitamente. Ferramentas de campanha criam e editam rascunhos, e uma campanha é enviada somente após o usuário clicar em Confirmar e enviar no cartão de lançamento.

Sim. Qualquer cliente que fale MCP sobre HTTP streamable com OAuth funciona, incluindo ChatGPT, Cursor, VS Code e Windsurf.

Em um workspace Claude Team ou Enterprise, apenas um proprietário da organização pode adicionar um conector personalizado. Esse é o motivo mais comum para a configuração falhar na primeira etapa.

Exatamente o que sua conta Cheerful pode ver: suas próprias campanhas, listas e caixas de entrada, além de qualquer coisa que suas equipes compartilhem com você. Não pode alcançar nada que seu próprio login não pudesse.

Sim, cada um com sua própria conta. Dois colegas conectando o mesmo servidor veem dados diferentes, porque o token é deles, não do workspace.

Remova o conector no seu cliente. Isso encerra seu acesso imediatamente, e revogar sua sessão Cheerful faz o mesmo do nosso lado.

Uma pesquisa filtrada ou inteligente percorre um catálogo indexado de centenas de milhões de criadores e leva 90–155 segundos. É a mesma pesquisa que o aplicativo web executa, e a espera é o trabalho, não uma falha.

Não uma pública hoje. O servidor MCP e a CLI são as duas superfícies suportadas voltadas para máquinas, e ambas autenticam por meio de login no navegador em vez de chave de API.

Esta página foi útil?