Connect with OAuth (Claude, ChatGPT)
claude.ai (web) and ChatGPT connect custom MCP servers through OAuth — you don't paste an API key, you click Connect and sign in. This is the easiest way for a restaurant owner to let an AI assistant build and manage their menu.
Prefer an API key (Claude Code, Cursor, the API)? See Connect via MCP — both methods work on the same endpoint and can be used side by side.
Add the connector#
Use this URL wherever the client asks for a custom MCP / connector server:
https://mcp.duck-hub.com/mcp- claude.ai (web): Settings → Connectors → Add custom connector → paste the URL → Connect.
- ChatGPT: add it as a custom MCP connector with the same URL.
The client discovers that the server needs OAuth and opens the DuckHub sign-in.
What happens when you connect#
- You're taken to DuckHub to sign in (Google or email — your normal login).
- You see a short consent screen — the app wants to view and manage your menu for the venue you pick. If your account has more than one restaurant, you choose which one.
- Click Allow access. The client is connected and can now use the 39 menu tools — build the menu, set images, translate, publish, and (on paid plans) read orders.
The connection is bound to the venue you picked and to your account. It respects the same plan limits, rate limits and audit log as the API.
One connection per account. DuckHub keeps a single OAuth connection per
account, so every AI app you connect shares the same chosen venue. If you
connect another app (or reconnect) and pick a different venue, the connection
switches to that venue for all connected apps — the consent screen tells you
when this will happen. To manage two venues separately from AI apps, use a
dk_live_ API key per venue instead.
If you click Deny, nothing is connected — no access is granted and you can close the window.
Disconnect#
Revoke a connector anytime from the DuckHub app:
DuckHub → Integrations → Connected apps → Disconnect.
Disconnecting takes effect immediately — the connector stops working on its very next request. You can reconnect later by adding the connector again.
OAuth vs API key#
| OAuth connector | dk_live_ API key | |
|---|---|---|
| Best for | claude.ai web, ChatGPT | Claude Code, Cursor, the API, scripts |
| Setup | Click Connect → sign in | Generate a key and paste it |
| Scope | Manage your menu (full) | Full key or a read-only key |
| Revoke | Integrations → Connected apps | Integrations → revoke the key |
Both hit the same https://mcp.duck-hub.com/mcp endpoint and can be used at the
same time.