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.
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.
Turn on Developer Mode
Custom connectors require Developer Mode and a paid plan (Plus and up). They aren't available on Free.
Recover from a 401
A 401 response means the token has expired. Trigger the tool again to open the authentication flow.