- check the catalog and the quota;
- upload a creative;
- create and follow pre-tests;
- read the result and download the PDF.
Claude
Opens Claude with the Unite connector already filled in. Click Continue, Add and Connect.
ChatGPT
Opens ChatGPT Plugins. Click Add › Add custom MCP server and paste the address.
Claude Code
One terminal command and a browser login.
Install the Unite plugin
The plugin, version 1.3.0, installs the connector and two skills together. The connector retrieves results. Theunite:ad-score skill helps run, read and present pre-tests in the format you ask for. The unite:brand-guidelines skill helps save the workspace brand. They are the same Unite guides the connector serves.
- Claude. On a paid plan that allows plugin installation in your workspace, download the Claude plugin. Open Customize › Plugins, choose the custom plugin upload option and select
unite.plugin. - ChatGPT on the web. Download the ChatGPT plugin. A workspace administrator with upload access selects the workspace in the Admin console, opens Plugins › Add › Upload plugin, and uploads the ZIP. If the administrator chooses Available, each person opens the plugin and selects Install plugin. With Installed, the selected people get it automatically.
Connect
The simplest way is to sign in with your Unite account: the app opens a Unite page, you sign in and authorize, and you choose the workspace in the conversation. No key needed.- Claude
- ChatGPT
- Claude Code
- Cursor and others
In claude.ai, on the web or in the app:On Team and Enterprise plans, an Owner adds the connector in Organization settings › Connectors. Then each person clicks Connect and authorizes with their own account.
1
Open the connectors
Go to Settings › Connectors.
2
Add the connector
Click Add › Add custom connector. Use the name
Unite and the MCP server URL https://mcp.myunite.ai/mcp, then click Continue.3
Leave authentication as it came
Claude detects the sign-in option on its own. Do not fill in a header or a key. Click Add.
4
Connect
Click Connect. The Unite page opens: sign in and click Autorizar (Authorize). You choose the workspace in the conversation. You return to Claude with “Connected to Unite”.
5
Use it
In a conversation, ask, for example: “Use Unite and tell me how much pre-test quota the workspace has.” The first time, Claude asks for permission to use the tool.
With your account
One login works for all your workspaces. On the authorization page you only sign in and click Autorizar (Authorize). You choose the workspace in the conversation, with two tools:unite_list_workspaces shows your workspaces and which one is active, and unite_select_workspace changes the active one. For example, ask “use the Brand X workspace”.
The agent acts only in the active workspace, with the permissions of your role in it:
- The connection requests
brands:writealong with the Ad Score permissions. The permission comes with the role: Editors and Administrators getbrands:writewith the rest, with no extra option on the consent screen. Viewers never receive this permission. Brands - The active workspace is named in every agent result and on the Ad Score card. Check it before creating a pre-test: it uses the quota or credits of the active workspace.
- If you have one workspace, it is active from the start. With several, the agent asks which one to use the first time.
- The choice applies to each connected app. Switching workspace in ChatGPT does not change the one in Claude.
- If you leave the workspace or become Financial, access to it stops on the next call. Unite never switches workspace on its own: the answer is
workspace_unavailable, and you choose another one. - In the workspace admin panel, the Aplicativos conectados (Connected apps) tab lists your connections and lets you revoke each one. Administrators see and revoke every connection in the workspace. Revocation applies to that workspace only, from the next call, and the app does not come back on its own: only a new authorization in the browser restores it.
- Sign-in works on
https://mcp.myunite.ai/mcp. The/mcp/adscoreslice accepts API keys only.
With an API key
Send the key in theAuthorization header, as with the API: Authorization: Bearer <key>. See Authentication.
The list of tools depends on the key’s scopes:
adscore:readshows the read tools;adscore:writeadds creating and deleting pre-tests and uploading files.
brands:write, the connector adds brand tools and uploads. To add the scope to an existing connection, follow Brands. A missing, invalid, revoked or expired key gets 401 before any tool runs.
Address
The transport is HTTP (Streamable HTTP), with no session.
In code
- Anthropic API
- OpenAI API
The MCP connector of the Anthropic API takes the key in
authorization_token, without Bearer:Tools
Names start with the product:
adscore_ for Ad Score and unite_ for what every product shares.
Unite guides
Unite’s skills are guides, in Markdown, for doing a task with the Unite tools. The agent reads each one withunite_get_skill.
The
ad-score skill also has four references:
references/presenting-results.md: how to present a result, in the chat, in a report or in slides.references/reading-results.md: what each part of the result means.references/channels.md: what each channel needs and what its checks look at.references/comparing-pretests.md: how to compare creatives, versions or a set of pre-tests.
- Pass the skill in
name. Withoutfile, the answer carriesSKILL.mdand the list of the skill’s files. Withfile, it carries that file, such asreferences/presenting-results.md. - Each answer carries the skill version and the file’s
digest. - Reading a guide is free and immediate, and works with any scope of the server.
- When a pre-test is completed, the
adscore_get_pretestresult carries a line pointing to the presentation guide: thereferences/presenting-results.mdfile of thead-scoreskill. - The Unite plugin 1.3.0 ships the same skills, as
unite:ad-scoreandunite:brand-guidelines.
How the agent works
- Media:
- In ChatGPT, a file attached in the chat goes straight to
adscore_create_pretestasfile, with the same limits asmediaUrl. ChatGPT fills in that field itself. - In other chat clients, the agent cannot pass an attached file inside a tool call.
- Pass a public URL of the creative in
mediaUrl. Unite downloads the file with the same rules as uploading from a URL. - Through MCP, the download gets up to 45 seconds, to fit the clients’ request timeout. For large files or slow servers, use the API’s upload from a URL, which waits up to 120 seconds.
- In ChatGPT, a file attached in the chat goes straight to
- Time:
- The analysis takes a few minutes.
adscore_create_pretestanswers at once, with statusqueuedandpollAfterSeconds. - Then
adscore_get_pretestwithwaitSeconds(up to 40) waits on the server and answers as soon as the analysis finishes.
- The analysis takes a few minutes.
- Retrying without being charged again:
- Without
idempotencyKey, the idempotency key comes from the arguments themselves. The same call repeated, for example after a timeout, returns the same pre-test and is not charged again. - If
mediaUrlis a signed link that changes on every attempt, the derived key changes with it and the retry creates another pre-test. In that case, send your ownidempotencyKeyand retry with it. - To analyze the same creative once more, send a new
idempotencyKey. - Reusing the same
idempotencyKeywith a differentmediaUrlreturns the original pre-test. - After a pre-test is deleted, the same call answers
idempotency_key_retired. Send a newidempotencyKeyto analyze the creative again. - See Idempotency.
- Without
- Result:
- By default,
adscore_get_pretestreturns the first 3 findings and recommendations, with each list’s total intruncated. - With
detail: "full", it returns all findings and recommendations with the available supporting evidence. By default, summary requests a heatmap preview and full detail requests all available map previews. SetmapImages: "none"to request data and map URLs without previews. - To get the PDF directly, call
adscore_get_reporton a completed pre-test. If the report is generating, waitpollAfterSecondsand call again for the download URL.
- By default,
Limits and errors
- Limits:
- Each tool call counts toward the per-minute limit of the key or the connection, with the same quotas as the API: read for the read tools, write for the others.
- Listing the tools does not count.
- See Rate limits.
- Tool errors:
- A tool that fails answers with
isError: true. - The text carries the same error JSON as the API:
code,message,requestId,docUrland, when there is one,param. - For the per-minute limit and the cap on running pre-tests, the error also carries
retryAfterSeconds. - Code against
code. See Errors.
- A tool that fails answers with
- Support: when you write to support@myunite.ai, include the
requestId.