Installation & setup¶
Connect the MCP server to your AI assistant. Access uses an OAuth 2.1 token issued by the Hello Retail authorization server. Supported clients open the login flow automatically on first use.
Open Settings → Connectors → Add custom connector, give it a name (for example Hello Retail), paste the server URL below, and click Add. Sign in when the OAuth login opens.
Run this in your terminal. On first use it opens a browser for OAuth login; the token is cached automatically.
Open a Project → Settings → Integrations → Add MCP server. Paste this URL and sign in when prompted.
Run these two commands. The first registers the server, the second opens a browser for OAuth sign-in.
If you'd rather edit the config file, add this to ~/.codex/config.toml and then run the login command.
Hello Retail is added to ChatGPT as a custom MCP server. On a workspace plan, your admin may need to allow custom MCP servers first.
-
Open Plugins in ChatGPT, click Add and choose Add custom MCP server.

-
Fill in the form, tick I understand and want to continue and click Create as a plugin.
- Name:
Hello Retail - Connection: keep Server URL selected and paste the URL below.
- Authentication: keep OAuth.

- Name:
-
Click Connect Hello Retail and sign in with your Hello Retail account.

-
Keep mcp ticked and click Submit Consent.

-
Start a new chat and type
@to pick Hello Retail.
In Copilot Studio the server is added as a tool on an agent. Create the agent, add Hello Retail as an MCP tool, then publish the agent so your team can talk to it.
-
Open Copilot Studio, go to Agents and click New agent. Give the agent a name, for example
Hello Retail.
-
On the Build tab, click + next to Tools in the panel on the right.

-
In Add a tool, click Add and choose Model Context Protocol (MCP).

-
Fill in the Add MCP server form and click Add.
- Server name:
Hello Retail - Server description: what the server does, for example the text below. Copilot Studio uses it to decide when to call the tools.
- Server URL: the URL below.
- Authentication: keep OAuth 2.0.
- Configuration type: keep Dynamic (with discovery).
Connects to Hello Retail, the search and personalization platform on our webshop. Reads analytics and settings for Search, Recommendations, Pages, Product Agents, Retail Media and Newsletters.
- Server name:
-
Back in Add a tool, search for
Hello Retailunder MCP and click Hello Retail. Copilot Studio sets up the connection. Sign in with your Hello Retail account when the login opens.
-
Hello Retail now shows under Tools. Click Publish in the top right, then Publish agent.


-
Click Add channels to put the agent in Microsoft Teams or Microsoft 365 Copilot, or Done to add a channel later.

Tips & tricks¶
Pick the card that matches your client or connection problem. Each prompt is ready to paste into your assistant.
Keep the cached sign-in
Claude Code caches the token after the first browser login. Re-run the add command only when you need to update the URL.
Check the connection
Codex stores servers in ~/.codex/config.toml. Use codex mcp list to see what's registered and codex mcp login hello-retail to refresh the sign-in.
Add it without a restart
Add the server as a custom connector under Settings → Connectors. You don't need a config file or a restart.
Add it as a plugin
Custom MCP servers live under Plugins → Add → Add custom MCP server, not Settings. You don't need Developer Mode. If Add custom MCP server is missing, your workspace admin hasn't allowed it.
Add it once per environment
Adding the MCP server creates a connector in your environment. In your next agent, search for Hello Retail under Add a tool → MCP instead of filling in the form again. Try a prompt on the Preview tab before you publish.
Recover from a 401
A 401 response means the token has expired. Trigger the tool again to open the authentication flow.