MCP
Two ways round. Connect Claude to your inbox, so it reads conversations and prepares notes and drafts for your team. And connect your app's own MCP server to the AI agent, so it can look up what only your app knows about a merchant.
Your inbox in Claude
The inbox is an MCP server at https://app.whoa.chat/mcp (Streamable HTTP). It signs you in with OAuth: you connect once, pick the workspace, and Claude acts as you, with your name on what it posts.
| Tool | What it does |
|---|---|
conversations_list | The inbox, newest first, by status, who has it, who wrote last, or words to find. |
conversation_get | One conversation with its messages; private notes, store events and drafts are marked team only. |
attachment_get | A file shared in the conversation: an image comes back as the image, anything else as a five minute link. |
note_post | A private note for the team. The merchant never sees it. |
draft_post | A draft reply with a note on what to check. It is never sent: a teammate sends, edits or discards it. |
Nothing Claude does through this server reaches a merchant. Sending stays with your team.
claude.ai and Claude Desktop
- Open Settings, Connectors, and add a custom connector.
- Give it the address
https://app.whoa.chat/mcp. - Claude opens Whoa Chat: sign in, pick the workspace and press Allow.
Claude Code
Make a personal token in the inbox (Settings, Connectors, Personal token for Claude Code) and run the command it shows:
claude mcp add --transport http whoa https://app.whoa.chat/mcp --header "Authorization: Bearer wcp_..."
Claude Code can also connect with OAuth like claude.ai: claude mcp add --transport http whoa https://app.whoa.chat/mcp, then sign in when it asks.
Disconnecting
Settings, Connectors lists what you connected and your personal tokens; Disconnect ends them at once. Someone who leaves the team loses access on their next call. Access tokens last an hour and refresh for up to 30 days; personal tokens last a year unless you disconnect them.
Your app's MCP server for the AI agent
An admin adds the server in Settings, Connectors: a name, its https:// address and how it signs in (a bearer token, a header of its own, or none). Whoa Chat calls initialize and tools/list to test it and lists every tool. You switch each tool on or off; a tool your server adds later starts off.
- The AI only sees and calls the tools that are on. A tool with a
shopargument always gets the store of the conversation, whatever the model asked for. - Tokens are kept as secrets per workspace and never shown again.
- The address must be public: private, loopback and link-local addresses are refused, checked again before every call.
- Up to five servers per workspace. Every call counts against your AI limits.
- A tool name used by two servers is shown as
server__tool.
Protocol details
OAuth 2.1 with PKCE (S256) and dynamic client registration. Discovery: /.well-known/oauth-protected-resource and /.well-known/oauth-authorization-server. Redirects must be https://, or http://localhost and http://127.0.0.1 for apps on your computer. The server is stateless and answers JSON; it supports protocol versions 2025-06-18, 2025-03-26 and 2024-11-05.