- consultar o catálogo e a cota;
- enviar uma peça;
- criar e acompanhar pré-testes;
- ler o resultado e baixar o PDF.
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.
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 skillunite: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.
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.- Claude
- ChatGPT
- Claude Code
- Cursor e outros
No claude.ai, na web ou no app: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.
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.
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:writejunto com as permissões do Ad Score. A permissão vem com o papel: Editor e Administrador recebembrands:writejunto 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/adscoreaceita só chave de API.
Com uma chave de API
Envie a chave no cabeçalhoAuthorization, como na API: Authorization: Bearer <chave>. Veja Autenticação.
A lista de ferramentas depende das permissões da chave:
adscore:readmostra as ferramentas de leitura;adscore:writeacrescenta criar e excluir pré-testes e enviar arquivos.
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.
Endereço
O transporte é HTTP (Streamable HTTP), sem sessão.
Em código
- API da Anthropic
- API da OpenAI
O conector MCP da API da Anthropic recebe a chave em
authorization_token, sem o Bearer: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 comunite_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.
- Passe a skill em
name. Semfile, a resposta traz oSKILL.mde a lista dos arquivos da skill. Comfile, traz aquele arquivo, por exemploreferences/presenting-results.md. - Cada resposta traz a versão da skill e o
digestdo 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_pretesttraz uma linha que aponta o guia de apresentação: o arquivoreferences/presenting-results.mdda skillad-score. - O plugin da Unite 1.3.0 traz as mesmas skills, como
unite:ad-scoreeunite:brand-guidelines.
Como o agente trabalha
- Mídia:
- No ChatGPT, um arquivo anexado na conversa vai direto para
adscore_create_pretestno campofile, com os mesmos limites damediaUrl. 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.
- No ChatGPT, um arquivo anexado na conversa vai direto para
- Tempo:
- A análise leva alguns minutos.
adscore_create_pretestresponde na hora, com o statusqueuedepollAfterSeconds. - Em seguida,
adscore_get_pretestcomwaitSeconds(até 40) espera no servidor e responde assim que a análise termina.
- A análise leva alguns minutos.
- 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
mediaUrlfor um link assinado que muda a cada tentativa, a chave derivada muda junto e a repetição cria outro pré-teste. Nesse caso, envie umaidempotencyKeysua e repita com ela. - Para analisar a mesma peça outra vez, envie uma
idempotencyKeynova. - Reusar a mesma
idempotencyKeycom umamediaUrldiferente devolve o pré-teste original. - Depois que um pré-teste é excluído, a mesma chamada responde
idempotency_key_retired. Envie umaidempotencyKeynova para analisar a peça outra vez. - Veja Idempotência.
- Sem
- Resultado:
adscore_get_pretesttraz por padrão os 3 primeiros achados e recomendações, com o total de cada lista emtruncated.- 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. UsemapImages: "none"para receber dados e URLs sem prévias. - Para obter o PDF diretamente, chame
adscore_get_reportem um pré-teste concluído. Se estiver em geração, aguardepollAfterSecondse 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,docUrle, 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.
- Uma ferramenta que falha responde com
- Suporte: ao escrever para support@myunite.ai, informe o
requestId.