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.
Add this to ~/.codex/config.toml, then run codex mcp login hello-retail to complete the OAuth sign-in.
Tips & tricks
Claude Code caches the token after the first browser login. Re-run the add command only to update the URL.
On Claude Cowork, add the server as a custom connector under Settings → Connectors — no config file or restart needed.
ChatGPT custom connectors require Developer Mode and a paid plan (Plus and up). They are not available on Free.
If a tool call returns 401, the token has expired. Trigger any tool again to re-authenticate.