Skip to content

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.

https://core.helloretail.com/mcp

Run this in your terminal. On first use it opens a browser for OAuth login; the token is cached automatically.

claude mcp add --transport http hello-retail https://core.helloretail.com/mcp

Open a Project → Settings → Integrations → Add MCP server. Paste this URL and sign in when prompted.

https://core.helloretail.com/mcp

Run these two commands. The first registers the server, the second opens a browser for OAuth sign-in.

codex mcp add hello-retail --url https://core.helloretail.com/mcp
codex mcp login hello-retail

If you'd rather edit the config file, add this to ~/.codex/config.toml and then run the login command.

[mcp_servers.hello-retail]
url = "https://core.helloretail.com/mcp"

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.

  1. Open Plugins in ChatGPT, click Add and choose Add custom MCP server.

    The Add menu in ChatGPT Plugins

  2. 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.
    https://core.helloretail.com/mcp
    

    The Add custom MCP server form in ChatGPT

  3. Click Connect Hello Retail and sign in with your Hello Retail account.

    The Connect Hello Retail dialog in ChatGPT

  4. Keep mcp ticked and click Submit Consent.

    The Hello Retail consent page

  5. 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.

  1. Open Copilot Studio, go to Agents and click New agent. Give the agent a name, for example Hello Retail.

    The Agents page in Copilot Studio

  2. On the Build tab, click + next to Tools in the panel on the right.

    The Tools section of the agent panel

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

    The Add menu in the Add a tool dialog

  4. 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).
    https://core.helloretail.com/mcp
    
    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.
    

    The Add MCP server form

  5. Back in Add a tool, search for Hello Retail under MCP and click Hello Retail. Copilot Studio sets up the connection. Sign in with your Hello Retail account when the login opens.

    Hello Retail in the Add a tool search

  6. Hello Retail now shows under Tools. Click Publish in the top right, then Publish agent.

    Hello Retail listed under Tools

    The Publish dialog

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

    The agent is published dialog

Tips & tricks

Pick the card that matches your client or connection problem. Each prompt is ready to paste into your assistant.

Claude Code

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.

Re-add the Hello Retail MCP server in Claude Code using an updated server URL.
Codex CLI

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.

List my configured Codex MCP servers and confirm hello-retail is signed in.
Claude Cowork

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.

Walk me through adding the Hello Retail MCP server as a custom connector in Claude Cowork.
ChatGPT

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.

How do I add a custom MCP server as a plugin in ChatGPT?
Copilot Studio

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.

List the Hello Retail websites you can access and what you can do for each of them.
Any client

Recover from a 401

A 401 response means the token has expired. Trigger the tool again to open the authentication flow.

A Hello Retail tool returned 401. Run it again so I can re-authenticate.