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.

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