Whoa Chat
Docs

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.

ToolWhat it does
conversations_listThe inbox, newest first, by status, who has it, who wrote last, or words to find.
conversation_getOne conversation with its messages; private notes, store events and drafts are marked team only.
attachment_getA file shared in the conversation: an image comes back as the image, anything else as a five minute link.
note_postA private note for the team. The merchant never sees it.
draft_postA 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

  1. Open Settings, Connectors, and add a custom connector.
  2. Give it the address https://app.whoa.chat/mcp.
  3. 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 shop argument 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.