Revup

npx add-mcp 'https://revup.com/mcp'

Documentação do MCP da Revup

Conecte seu assistente de IA à Revup para criar pesquisas, formulários e outras promoções, personalizá-los e explorar o desempenho a partir de uma conversa.

URL do servidor

MCPhttps://revup.com/mcp

A Revup fornece um servidor hospedado do Model Context Protocol (MCP). Use um cliente que suporte conexões remotas Streamable HTTP e login OAuth.

Comece conectando sua conta, verificando seus recursos e pedindo ao seu assistente para encontrar uma promoção.

Criar ou editar uma promoção pode afetar sua página pública imediatamente. O cronograma controla quando as inscrições são aceitas. Não há uma etapa separada de aprovação de publicação.

Construindo uma integração direta com chaves de API? Consulte a referência da API.

What can I do in my connected Revup account?

Find my giveaways and show their current schedules.

Conecte seu assistente

1. Nas configurações de conexão MCP do seu assistente, adicione um servidor remoto chamado Revup usando a URL do servidor acima.
2. Inicie o login OAuth e faça login na Revup.
3. Escolha a conta que deseja conectar e revise as permissões solicitadas.
4. Selecione Conectar, volte ao seu assistente e atualize as ferramentas dele, se necessário.

As configurações de conexão disponíveis dependem do seu cliente. Ele deve suportar MCP remoto e código de autorização OAuth com S256 PKCE. As chaves de API da Revup são para a API REST; esta conexão usa OAuth.

Você pode adicionar a Revup manualmente sem uma listagem em diretório publicado. Escolha as instruções para ChatGPT, Claude ou Codex abaixo. O plano do seu assistente e as configurações da organização podem limitar conexões personalizadas.

Confirme a conexão

Peça ao assistente para chamar get_account_capabilities primeiro. Verifique a conta antes de fazer alterações. As ferramentas disponíveis dependem dos escopos consentidos, das permissões da conta e das operações suportadas.

Desconectar

Abra Conta › Integrações, encontre Conexões MCP e exclua a conexão. Reconecte-se pelo seu assistente para autorizá-la novamente.

Name: Revup
URL: https://revup.com/mcp
Transport: Streamable HTTP
Authentication: OAuth

Conectar o ChatGPT

1. No ChatGPT, abra Configurações › Segurança e login e ative o Modo desenvolvedor. A disponibilidade depende da sua conta e da política do workspace.
2. Abra Plugins, selecione o botão + e insira Revup como nome com uma breve descrição.
3. Em Conexão, insira a URL do servidor da Revup mostrada nesta página e crie a conexão. Use autenticação OAuth.
4. Faça login na Revup, escolha sua conta, revise as permissões e selecione Conectar.
5. Inicie uma nova conversa e selecione a conexão da Revup no menu de ferramentas. Pergunte qual conta da Revup está conectada antes de fazer alterações.

Se o Modo desenvolvedor ou a criação de conexão não estiverem disponíveis, verifique com o administrador do seu workspace. Estas etapas usam uma conexão personalizada; elas não exigem que a Revup apareça no diretório público.

Consulte as instruções de conexão atuais da OpenAI para disponibilidade do cliente e mudanças na interface.

Conectar o Claude

1. No Claude, abra Personalizar › Conectores, selecione + e depois Adicionar conector personalizado.
2. Nomeie o conector como Revup e cole a URL do servidor mostrada nesta página. A Revup suporta registro automático de cliente OAuth; você não precisa fornecer um ID ou segredo de cliente.
3. Adicione o conector e inicie a conexão ou o fluxo de login.
4. Faça login na Revup, escolha sua conta, revise as permissões e selecione Conectar.
5. Em uma conversa, use + › Conectores para ativar a Revup e depois pergunte qual conta da Revup está conectada.

Para workspaces Team e Enterprise, um proprietário da organização pode precisar adicionar o conector nas configurações da organização antes que os membros possam conectar suas próprias contas da Revup.

Consulte as instruções de conector personalizado do Claude para requisitos atuais de plano e workspace.

Conectar o Codex

1. Com a CLI do Codex instalada, execute os comandos mostrados aqui para adicionar a Revup e iniciar o login OAuth.
2. No navegador, faça login na Revup, escolha sua conta, revise as permissões e selecione Conectar.
3. Volte ao Codex e inicie uma nova sessão. Pergunte qual conta da Revup está conectada e o que ela pode fazer.

As permissões solicitadas permitem edição de promoções e relatórios agregados. offline_access permite que o Codex atualize a conexão. Revise essas permissões durante o login.

Use a URL do ambiente da Revup onde sua conta existe. Uma conexão de staging acessa contas e promoções de staging.

Consulte as instruções MCP do Codex para outras opções de configuração.

codex mcp add revup --url https://revup.com/mcp
codex mcp login revup --scopes account:read,promotions:read,promotions:write,analytics:read,offline_access

Permissões e acesso

Cada nova conexão se aplica a todas as promoções em uma conta da Revup, dentro das permissões que você permitir. As ferramentas respeitam sua associação e função atuais na conta. Conexões existentes com restrições de promoção mantêm essas restrições.

Escopo	Acesso
account:read	Ler recursos da conta e operações permitidas.
promotions:read	Encontrar promoções, descobrir configurações, inspecionar imagens, verificar operações, validar e visualizar.
promotions:write	Criar, editar e duplicar promoções suportadas; importar imagens fornecidas.
analytics:read	Ler relatórios agregados de promoções.
offline_access	Permitir que o cliente atualize sua conexão sem fazer login para cada token de acesso.

Para acesso somente leitura à conta, permita os escopos de leitura necessários e omita promotions:write. offline_access controla apenas a atualização da conexão.

Os rótulos das ferramentas identificam leituras, gravações e gravações sensíveis. Gravações sensíveis podem afetar o conteúdo público da promoção ou enviar informações para fora da conta conectada. Revise os detalhes antes de aprová-los no seu assistente; os controles de aprovação dependem do cliente.

Criar ou duplicar uma promoção exige consentimento de promoção em toda a conta. Uma conexão restrita a promoções específicas não pode criar novas.

O MCP não expõe identidades de participantes ou exportações, seleção de vencedores, mensagens para participantes, pagamentos, assinaturas ou criação de compras por inscrição.

Show the connected account and my permissions.

Which operations can I use for this promotion?

Descubra promoções e configurações

get_account_capabilities

Leitura · Sensível: Não

Lê a conta conectada e os recursos disponíveis. Não aceita argumentos.

list_promotions

Leitura · Sensível: Não

Encontra promoções acessíveis. Suporta query, limit (1–50, padrão 20) e um cursor retornado para a próxima página.

get_promotion

Leitura · Sensível: Não

Lê detalhes salvos usando promotion_id. Solicite um section específico para conteúdo, regras, segurança, design, campos, prêmios, ações de bônus ou ativos. Use a revisão retornada ao editar.

get_promotion_schema

Leitura · Sensível: Não

Descubra configurações suportadas antes de gravar. Passe a seção que deseja editar, como content, fields, colors, assets ou schedule. Use os valores permitidos e catálogos retornados.

{
  "name": "get_promotion_schema",
  "arguments": {
    "section": "content"
  }
}

Criar, editar e duplicar

create_promotion

Gravação · Sensível: Sim

Cria uma promoção com name, schedule e idempotency_key. Opcionalmente, forneça operations estruturado descoberto no schema. Cria uma promoção com disponibilidade pública normal; o cronograma controla quando as inscrições são aceitas.

Defina type como giveaway, contest, form, instant_win, purchase ou survey. Um tipo explícito é obrigatório; sweepstakes e purchase_rewards são aliases aceitos. Os recursos da conta listam os tipos atualmente disponíveis.

Se o seu conector ainda mostrar a ferramenta antiga somente de sorteios sem o parâmetro type, adicione esta como a primeira operação de criação. A entrada operations existente suporta isso:

[{"section":"content","action":"set","values":{"type":"survey"}}]

Substitua survey pelo tipo disponível pretendido. Se ambas as formas de seleção de tipo forem enviadas, elas devem concordar. Tipos ausentes ou conflitantes falham sem criar uma promoção. Esta operação se aplica apenas durante a criação; ela não pode alterar o tipo de uma promoção existente. A reautorização sozinha pode não atualizar as definições de ferramentas salvas do conector.

Pesquisas começam com uma pergunta e CAPTCHA, sem e-mail ou outro identificador de contato. Os campos de contato são opcionais e podem ser removidos antes da primeira resposta real; depois disso, as perguntas ficam bloqueadas. Formulários mantêm seu requisito de identificador existente. A integração de compra e a alocação de vitória instantânea exigem configuração no painel e não são copiadas pela duplicação via MCP.

Create a customer feedback survey with no email field.

update_promotion

Gravação · Sensível: Sim

Aplica alterações ordenadas com promotion_id, expected_revision, operations e idempotency_key. Configurações omitidas são preservadas. Aplicar um tema substitui todas as cores. As alterações podem afetar a página pública imediatamente.

duplicate_promotion

Gravação · Sensível: Sim

Copia a configuração suportada com um novo nome e cronograma. Forneça o promotion_id de origem, seu expected_revision e um idempotency_key. Participantes, resultados, integrações, variantes de idioma e envios não são copiados. A cópia concluída tem disponibilidade pública normal sob seu novo cronograma.

get_operation_status

Leitura · Sensível: Não

A duplicação é executada de forma assíncrona. Faça polling usando o job_id retornado antes de trabalhar com a nova promoção.

Criação e edições usam disponibilidade normal de promoção. As alterações podem afetar o conteúdo público imediatamente; não há etapa separada de rascunho ou aprovação de publicação.

Resultados e prontidão

Create e update aceitam response_mode: summary (padrão), minimal ou full. Todo resultado bem-sucedido inclui o ID e a revisão da promoção salvos, informações de nova tentativa, IDs de filhos criados ou removidos e prontidão consultiva. Summary retorna alterações salvas; full também retorna a configuração salva dentro dos limites de paginação e resposta.

Os schemas de design documentam seletores, unidades, intervalos e comportamento responsivo suportados. Prefira os controles de cor, fonte, layout e tema. O CSS personalizado é sanitizado e isolado; leia o valor salvo após uma atualização porque declarações não suportadas podem ser removidas.

Cronogramas e novas tentativas

Use datas locais no formato YYYY-MM-DD HH:MM:00 com um fuso horário IANA. A Revup inclui o minuto final completo do horário de término. Escolha datas apropriadas para sua promoção; o exemplo é ilustrativo.

Leia a revisão mais recente da promoção antes de editar. Para uma nova tentativa após um timeout, mantenha a mesma chave de idempotência e argumentos idênticos. Use uma nova chave para uma nova operação. Se a revisão salva mudou, leia a promoção novamente e revise as alterações antes de tentar novamente.

Solicitações bem-sucedidas podem ser repetidas por sete dias na mesma conexão, ou até que essa conexão expire, o que ocorrer primeiro. As respostas de gravação incluem retry.expires_at_utc. Após essa janela, a chave antiga é rejeitada mesmo após a limpeza. As chaves de nova tentativa não são transferidas ao reconectar: leia a promoção atual, o estado da operação ou do ativo antes de enviar outra gravação para evitar repetir uma ação concluída.

{
  "name": "create_promotion",
  "arguments": {
    "type": "giveaway",
    "name": "Autumn giveaway",
    "schedule": {
      "start": "2026-10-01 09:00:00",
      "end": "2026-10-31 17:00:00",
      "timezone": "America/Los_Angeles"
    },
    "idempotency_key": "autumn-giveaway-001"
  }
}

Use suas imagens

list_assets

Leitura · Sensível: Não

Encontra imagens prontas na biblioteca da conta conectada. Use os IDs de ativos estáveis com configurações de imagem suportadas descobertas por meio de get_promotion_schema.

import_image

Gravação · Sensível: Não

Importa uma imagem fornecida pelo usuário ou gerada pelo cliente usando um descritor file contendo download_url e file_id, além de um idempotency_key. Campos opcionais do descritor são mime_type e file_name. Um caminho de arquivo local ou de sandbox não é um descritor de arquivo baixável. Armazena a imagem na biblioteca da sua conta; anexá-la a uma promoção exige uma edição separada.

Os formatos suportados são PNG, JPEG, WebP e GIF, até 5 MiB e 40 milhões de pixels. A Revup importa imagens fornecidas; ela não as gera.

get_asset_status

Leitura · Sensível: Não

Faça polling usando asset_id até que a imagem tenha concluído o processamento antes de anexá-la a uma promoção. Se o seu cliente não puder fornecer um arquivo baixável, faça upload pela biblioteca da conta da Revup e use list_assets.

Find ready images in my Revup account library.

Show me the supported image slots for my giveaway
and use the image I select.

Visualizar e verificar prontidão

validate_promotion

Leitura · Sensível: Não

Passe promotion_id para inspecionar bloqueadores e avisos de configuração salvos. A validação é apenas consultiva: ela não corrige configurações nem impede o acesso público.

render_preview

Leitura · Sensível: Não

Passe promotion_id e viewport (desktop ou mobile) para receber um JPEG vinculado à revisão da promoção salva. O resultado identifica a revisão realmente renderizada, as dimensões da viewport, o tempo de renderização e quaisquer avisos de recursos incompletos. Ele captura a viewport visível, portanto, conteúdo mais abaixo na página pode não aparecer.

preview_promotion

Leitura · Sensível: Não

Passe promotion_id para recuperar os links padrão de pré-visualização, público e de compartilhamento. A pré-visualização mostra a promoção salva mais recente e marca os envios como testes.

Revise o conteúdo salvo, imagens, regras, datas e fuso horário antes de compartilhar o link público. As entradas públicas seguem o cronograma normal e as regras de entrada. Fechar seu assistente não pausa a promoção.

Check this giveaway for readiness warnings.

Render desktop and mobile previews, show its public link, and confirm
when it will accept entries.

Ler relatórios de desempenho

get_promotion_report

Leitura · Sensível: Não

Leia métricas agregadas com promotion_id e um period contendo datas de início e fim. Opcionalmente, adicione um intervalo de datas comparison e um breakdown: device, source, campaign ou landing.

Os relatórios incluem definições de métricas, denominadores, fuso horário, filtros e limites de atualização. Contagens de participantes, chances de entrada ponderadas e conclusões contadas são métricas diferentes. Os relatórios omitem identidades de participantes e caminhos de URL brutos.

Peça ao seu assistente para separar mudanças observadas de possíveis explicações. Uma mudança de conversão ou uma comparação entre fontes não estabelece sua causa.

{
  "name": "get_promotion_report",
  "arguments": {
    "promotion_id": 123,
    "period": {
      "start": "2026-10-01",
      "end": "2026-10-31"
    },
    "breakdown": "source"
  }
}

Solução de problemas

Problema	Próximo passo
Conexão indisponível	Confirme a URL do servidor e que seu cliente suporta Streamable HTTP remoto e OAuth. Se o Revup informar que está indisponível, tente novamente mais tarde ou entre em contato com o suporte.
Ferramentas ausentes ou permissão negada	Verifique os recursos da conta, escopos consentidos, sua função na conta e restrições de promoção. Reconecte-se se precisar de consentimento diferente.
Conexão expirada ou revogada	Deixe o cliente atualizar seu token ou reconectar-se pelo login OAuth.
Conflito de revisão ou estado	Leia a promoção atual e reconcilie a edição pretendida antes de enviar uma nova operação.
Imagem ou duplicata ainda processando	Verifique a ferramenta de status relevante. Não inicie repetidamente uma nova importação ou duplicação.
Limite de taxa atingido	Aguarde antes de tentar novamente. Evite sondagens rápidas e preserve a mesma chave e carga útil ao tentar novamente gravações de promoção ou imagem.

submit_feedback

Escrita · Sensível: Sim

Relate um bug do Revup, comportamento confuso ou uma capacidade ausente de qualquer conexão, incluindo as somente leitura. Passe um category (bug, confusing ou missing_capability) e um note de até 2.000 caracteres descrevendo o que você estava tentando fazer, o que aconteceu e o que você esperava. Opcionalmente, inclua tool_name, promotion_id e o request_id retornado com um erro de ferramenta.

Armazena seu relatório no Revup e pode notificar a equipe do Revup pelo Slack, fora da sua conta conectada. O resultado é um feedback_id; suas promoções permanecem inalteradas. Esta gravação permanece disponível com consentimento de conta somente leitura.

Cada chamada cria um relatório separado, portanto, não tente novamente automaticamente. Cada conexão pode enviar 10 relatórios por hora. Não inclua tokens, senhas ou dados pessoais.

A descoberta de ferramentas é a referência para a versão do servidor à qual seu cliente está conectado. Atualize-a após uma atualização. Para obter ajuda, entre em contato com o Revup com o nome da ferramenta e a mensagem de erro. Não inclua tokens, senhas ou URLs de download privadas.

Read the latest saved promotion and explain
what changed before applying my edit again.