Pular para o conteúdo principal
O servidor MCP da Unite deixa um agente de IA usar o Ad Score:
  • consultar o catálogo e a cota;
  • enviar uma peça;
  • criar e acompanhar pré-testes;
  • ler o resultado e baixar o PDF.
Ele segue as mesmas permissões, os mesmos limites e os mesmos códigos de erro da API. Para obter o conector e as skills da Unite juntos, instale o plugin da Unite.

Claude

Abre o Claude com o conector da Unite já preenchido. Clique em Continuar, Adicionar e Vincular.

ChatGPT

Abre os Plugins do ChatGPT. Clique em Adicionar › Adicionar servidor MCP personalizado e cole o endereço.

Claude Code

Um comando no terminal e o login no navegador.
Endereço para colar:
Na página da Unite que abrir, entre com o seu login de sempre e clique em Autorizar. O workspace você escolhe na conversa. Depois de conectar, faça um teste no Claude: a conversa abre com o pedido escrito, e você só envia.

Instalar o plugin da Unite

O plugin, na versão 1.3.0, instala o conector e duas skills juntos. O conector busca os resultados. A skill unite:ad-score ajuda a rodar, ler e apresentar os pré-testes no formato que você pedir. A skill unite:brand-guidelines ajuda a salvar a marca do workspace. São os mesmos guias da Unite que o conector entrega.
  • Claude. Em um plano pago com instalação permitida pelo workspace, baixe o plugin para Claude. Abra Personalizar › Plugins, escolha a opção de carregar um plugin personalizado e selecione unite.plugin.
  • ChatGPT na web. Baixe o plugin para ChatGPT. Um administrador com permissão de upload escolhe o workspace no Admin console, abre Plugins › Add › Upload plugin e envia o ZIP. Se o administrador escolher Available, cada pessoa abre o plugin e clica em Install plugin. Com Installed, ele já fica instalado para as pessoas selecionadas.
Depois de instalar no seu aplicativo, abra a conexão com a Unite e entre na sua conta. O workspace dos pré-testes você escolhe na conversa. Se o workspace do ChatGPT já usa um conector personalizado da Unite e uma opção nova ainda não aparece, o administrador pode atualizar as ferramentas nas configurações do aplicativo e publicar as alterações revisadas. Como atualizar uma conexão existente no ChatGPT Experimente pedir “Qual foi a nota do último pré-teste concluído? Só o número.” Para uma apresentação, peça “Use os mapas e as cores do guia de marca deste projeto para montar três slides.” Consultar um pré-teste concluído e seus mapas não consome a cota de novas análises. Guia do Claude · Guia do ChatGPT · Guía en español

Conectar

O jeito mais simples é entrar com a sua conta da Unite: o aplicativo abre uma página da Unite, você entra e autoriza, e o workspace você escolhe na conversa. Não precisa de chave.
No claude.ai, na web ou no app:
Atalho: o botão Claude no topo desta página abre a janela já preenchida com o nome e o endereço. Clique em Continuar e siga do passo 3.
1

Abra os conectores

Vá em Configurações › Conectores (Settings › Connectors).
2

Adicione o conector

Clique em Adicionar › Adicionar conector personalizado (Add › Add custom connector). Use o nome Unite, a URL do servidor MCP https://mcp.myunite.ai/mcp e clique em Continuar.
3

Deixe a autenticação como veio

O Claude detecta sozinho Entrar agora e Usar a identidade publicada do Claude. Não preencha cabeçalho nem chave. Clique em Adicionar (Add).
4

Vincule

Clique em Vincular (Connect). A página da Unite abre: entre e clique em Autorizar. O workspace você escolhe na conversa. Você volta ao Claude com “Conectado à Unite”.
5

Use

Numa conversa, peça, por exemplo: “Use a Unite e me diga quanto de cota de pré-teste o workspace tem.” Na primeira vez, o Claude pede permissão para usar a ferramenta.
Nos planos Team e Enterprise, um Owner adiciona o conector em Configurações da organização › Conectores (Organization settings › Connectors). Depois, cada pessoa clica em Vincular e autoriza com a própria conta.

Com a sua conta

Um login vale para todos os seus workspaces. Na página de autorização, você só entra e clica em Autorizar. O workspace você escolhe na conversa, com duas ferramentas: unite_list_workspaces mostra os seus workspaces e qual está ativo, e unite_select_workspace troca o ativo. Por exemplo, peça “usa o workspace Marca X”. O agente age só no workspace ativo e com as permissões do seu papel nele:
  • A conexão pede brands:write junto com as permissões do Ad Score. A permissão vem com o papel: Editor e Administrador recebem brands:write junto com o resto, sem opção extra na autorização. O Visualizador nunca recebe essa permissão. Marcas
  • O workspace ativo aparece em toda resposta do agente e no cartão do Ad Score. Confira antes de criar um pré-teste: ele usa a cota ou os créditos do workspace ativo.
  • Se você tem um só workspace, ele já vem ativo. Com vários, o agente pergunta qual usar na primeira vez.
  • A escolha vale para cada aplicativo conectado. Trocar de workspace no ChatGPT não muda o do Claude.
  • Se você sair do workspace ou passar a Financeiro, o acesso a ele cai na chamada seguinte. A Unite não troca de workspace sozinha: a resposta é workspace_unavailable, e você escolhe outro.
  • No painel do workspace, a aba Aplicativos conectados mostra as suas conexões e deixa revogar cada uma. O administrador vê e revoga as de todo o workspace. A revogação vale só para aquele workspace, na chamada seguinte, e o aplicativo não volta sozinho: só uma nova autorização no navegador libera.
  • O login vale no endereço https://mcp.myunite.ai/mcp. O recorte /mcp/adscore aceita só chave de API.
Com escrita, cada pré-teste que o agente cria usa 1 unidade da cota do workspace. Sem cota, usa 5 créditos.

Com uma chave de API

Envie a chave no cabeçalho Authorization, como na API: Authorization: Bearer <chave>. Veja Autenticação. A lista de ferramentas depende das permissões da chave:
  • adscore:read mostra as ferramentas de leitura;
  • adscore:write acrescenta criar e excluir pré-testes e enviar arquivos.
Com brands:write, o conector inclui as ferramentas de marca e de upload. Para conceder o escopo a uma conexão existente, veja Marcas. Uma chave ausente, inválida, revogada ou vencida recebe 401 antes de qualquer ferramenta.
O agente age com a sua chave. Cada pré-teste novo usa 1 unidade da cota do workspace ou, sem cota, 5 créditos. Crie uma chave só para o agente, com as permissões que ele precisa e com validade.

Endereço

O transporte é HTTP (Streamable HTTP), sem sessão.

Em código

O conector MCP da API da Anthropic recebe a chave em authorization_token, sem o Bearer:
O Cursor e as APIs da Anthropic e da OpenAI usam a chave de API.

Ferramentas

Os nomes começam pelo produto: adscore_ para o Ad Score e unite_ para o que vale para todos os produtos.

Guias da Unite

As skills da Unite são guias em Markdown de como fazer uma tarefa com as ferramentas da Unite. O agente lê cada uma com unite_get_skill. A skill ad-score tem também quatro referências:
  • references/presenting-results.md: como apresentar um resultado, na conversa, num relatório ou em slides.
  • references/reading-results.md: o que cada parte do resultado significa.
  • references/channels.md: o que cada canal pede e o que as verificações dele avaliam.
  • references/comparing-pretests.md: como comparar peças, versões ou vários pré-testes.
Como usar:
  • Passe a skill em name. Sem file, a resposta traz o SKILL.md e a lista dos arquivos da skill. Com file, traz aquele arquivo, por exemplo references/presenting-results.md.
  • Cada resposta traz a versão da skill e o digest do arquivo.
  • Ler um guia é grátis e imediato, e funciona com qualquer permissão do servidor.
  • Quando um pré-teste está concluído, o resultado de adscore_get_pretest traz uma linha que aponta o guia de apresentação: o arquivo references/presenting-results.md da skill ad-score.
  • O plugin da Unite 1.3.0 traz as mesmas skills, como unite:ad-score e unite:brand-guidelines.

Como o agente trabalha

  • Mídia:
    • No ChatGPT, um arquivo anexado na conversa vai direto para adscore_create_pretest no campo file, com os mesmos limites da mediaUrl. O próprio ChatGPT preenche esse campo.
    • Em outros clientes de chat, o agente não consegue mandar um arquivo anexado dentro de uma ferramenta.
    • Passe uma URL pública da peça em mediaUrl. A Unite baixa o arquivo com as mesmas regras do envio por URL.
    • Pelo MCP, o download tem até 45 segundos, para caber no tempo de espera dos clientes. Para arquivos grandes ou servidores lentos, use o envio por URL da API, que espera até 120 segundos.
  • Tempo:
    • A análise leva alguns minutos. adscore_create_pretest responde na hora, com o status queued e pollAfterSeconds.
    • Em seguida, adscore_get_pretest com waitSeconds (até 40) espera no servidor e responde assim que a análise termina.
  • Repetição sem cobrança:
    • Sem idempotencyKey, a chave de idempotência vem dos próprios argumentos. A mesma chamada repetida, por exemplo depois de um tempo esgotado, devolve o mesmo pré-teste e não cobra de novo.
    • Se a mediaUrl for um link assinado que muda a cada tentativa, a chave derivada muda junto e a repetição cria outro pré-teste. Nesse caso, envie uma idempotencyKey sua e repita com ela.
    • Para analisar a mesma peça outra vez, envie uma idempotencyKey nova.
    • Reusar a mesma idempotencyKey com uma mediaUrl diferente devolve o pré-teste original.
    • Depois que um pré-teste é excluído, a mesma chamada responde idempotency_key_retired. Envie uma idempotencyKey nova para analisar a peça outra vez.
    • Veja Idempotência.
  • Resultado:
    • adscore_get_pretest traz por padrão os 3 primeiros achados e recomendações, com o total de cada lista em truncated.
    • Com detail: "full", devolve todos os achados e recomendações com as evidências disponíveis. Por padrão, o resumo solicita uma prévia do mapa de calor e o detalhe completo solicita prévias de todos os mapas disponíveis. Use mapImages: "none" para receber dados e URLs sem prévias.
    • Para obter o PDF diretamente, chame adscore_get_report em um pré-teste concluído. Se estiver em geração, aguarde pollAfterSeconds e repita a consulta para receber a URL de download.

Limites e erros

  • Limites:
    • Cada chamada de ferramenta conta no limite por minuto da chave ou da conexão, com as mesmas cotas da API: leitura nas ferramentas de leitura e escrita nas outras.
    • Listar as ferramentas não conta.
    • Veja Limites de uso.
  • Erro de ferramenta:
    • Uma ferramenta que falha responde com isError: true.
    • O texto traz o mesmo JSON de erro da API: code, message, requestId, docUrl e, quando há, param.
    • No limite por minuto e no teto de pré-testes em andamento, o erro traz também retryAfterSeconds.
    • Programe pelo code. Veja Erros.
  • Suporte: ao escrever para support@myunite.ai, informe o requestId.