> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wassist.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect Claude or ChatGPT

> Search your WhatsApp conversations, chart how often a topic comes up, and reply to customers from your AI assistant

The Wassist MCP server connects your organization to AI assistants like Claude and ChatGPT, or any app that supports remote [MCP](https://modelcontextprotocol.io) servers. Once connected, you can ask things like:

* "How often have customers mentioned late deliveries this month?"
* "Show me the conversations about the rain jacket sizing and open the most recent one."
* "Which chats need review today?"
* "Reply to Ada that her parcel ships tomorrow, and pause the agent for an hour."

In apps that support interactive widgets (Claude and ChatGPT do), results show up as an inbox you can click through: a chart of the search over time, the matching conversations, the full chat, and a reply box. Elsewhere you get the same information as text.

## Connect

The server URL is:

```
https://mcp.wassist.app/mcp
```

> [tab] Claude
>
> 1. In Claude, open **Settings** → **Connectors** and choose **Add custom connector**.
> 2. Name it "Wassist", paste the URL above, and click **Add**.
> 3. Click **Connect** and sign in to Wassist (see [Sign in and pick an organization](#sign-in-and-pick-an-organization)).
>
> On Team and Enterprise plans, an owner may need to add the connector for the workspace first.

> [tab] ChatGPT
>
> 1. In ChatGPT, open **Plugins**, search for **Wassist**, and add it.
> 2. Sign in to Wassist when ChatGPT asks.
> 3. ChatGPT offers to run setup: it checks your WhatsApp numbers, tries a first search, and shows you around.
>
> You can also add the server as a custom connector: open **Settings** → **Apps & Connectors**, create a connector named "Wassist" with the URL above and **OAuth** authentication. On some plans this needs developer mode switched on under **Advanced settings**.

> [tab] Claude Code
>
> ```bash theme={null}
> claude mcp add --transport http wassist https://mcp.wassist.app/mcp
> ```
>
> Then run `/mcp` in Claude Code and choose **wassist** to sign in.

> [tab] Cursor and others
>
> Add the server to your MCP configuration (for Cursor, `~/.cursor/mcp.json`):
>
> ```json theme={null}
> {
>   "mcpServers": {
>     "wassist": { "url": "https://mcp.wassist.app/mcp" }
>   }
> }
> ```
>
> The app opens a browser window to sign in the first time it connects. Interactive widgets only appear in apps that support MCP Apps; everything else works as text.

### Sign in and pick an organization

Connecting opens a Wassist page in your browser:

1. Sign in with your phone number, if you aren't already.
2. Pick the organization the assistant can use. A connection only ever reaches one organization; connect again to use another.
3. Check what the app is asking for and click **Allow**.

You're sent back to the assistant and can start asking. The assistant acts as you: it sees what you can see in the organization, and replies it sends come from your business's WhatsApp number, just like replies from the dashboard.

## What you can do

### Search conversations

Ask about a product, problem or question in a few words, and the assistant searches by meaning rather than exact wording, so "late delivery" also finds "my parcel still hasn't arrived".

The chart shows matching conversations over the date range:

* **Direct**: conversations where the customer asked about it.
* **Related**: conversations where it came up alongside something else.
* **Estimated**: the line shows roughly how many matches there are once uncertain conversations are counted in.

Click a bar to filter the list to that period, and click a conversation to open it. You can search the last 7 days, 30 days, 90 days or 12 months, or any date range you name.

> [!WARNING]
>
> Search only covers WhatsApp numbers with **Conversation Analytics** switched on. Turn it on from the number's page in the dashboard, under **Conversation Analytics**. It uses credits based on AI usage. Each search covers the most recent 500 analysed conversations in the range.

### Read a conversation

Open any conversation to see the full chat, oldest message at the top, along with whether the 24-hour reply window is open and whether the agent is paused. Long chats load the newest 50 messages first; click **Load older** (or ask) to go further back.

You can also list conversations that need attention: flagged for review, with unread messages, or with the agent paused, optionally filtered by WhatsApp number, customer name or phone number, or date.

### Reply

While the customer's 24-hour window is open, you can send a text reply from the widget or ask the assistant to send one. Tick **Pause the agent** (for an hour, unless you've changed it in [settings](#settings)), or ask the assistant to pause it for a set time, so your agent doesn't reply over you.

Once the window has closed, WhatsApp only allows approved templates. Say what you want to tell the customer, and Wassist suggests the templates on that number that fit, with their variables filled in. Check the preview, edit the variables if needed, and send. In ChatGPT, the assistant can show you the suggestions as a form instead: pick a template from the previews, check each variable, and submit to send it.

> [!NOTE]
>
> The assistant is told to show you the exact message and get your go-ahead before sending anything, and most apps also ask you to approve each send. Messages can't be unsent once they've gone to WhatsApp.

## In ChatGPT

ChatGPT has a few extras on top of the chat. They need a recent ChatGPT app; the inbox says so if yours needs updating.

### The inbox in the sidebar

Open **Wassist** from ChatGPT's sidebar for an inbox that stays open next to your chat. It shows recent conversations and tabs for the ones that need review, have unread messages, or have the agent paused, plus a search box with the same date ranges as above. In a chat, you can also open Wassist as a side panel.

The inbox remembers the last list it showed, without message text, so it appears straight away next time while the latest loads.

### Bring conversations into the chat

* **@-mention a conversation:** type **@**, choose Wassist, and search by customer name or number. With nothing typed, it suggests the conversations that need review, then the most recent.
* **Add to chat:** in an open conversation, a search result, or on a single message, choose **Add to chat** so the assistant can read it with your next message. Click again to take it out.
* **Ask about it:** **Summarise** and **Draft a reply** on a conversation, or **Ask about this trend** on a search, write the question into your chat box for you to send.

The assistant also knows which conversation or search you're looking at in the inbox, so you can ask "what does this customer want?" without explaining.

### Settings

Open Wassist's settings page in ChatGPT to set defaults for this connection:

| Setting | What it does |
| - | - |
| **Default number** | Searches look at this WhatsApp number unless you ask for another, or every number. |
| **Default search range** | How far back searches go when you don't say: 7 days, 30 days (the default), 90 days or 12 months. |
| **Pause the agent on reply** | **Always** pauses the agent when you reply, **Never** leaves it replying, and **Ask each time** (the default) lets ChatGPT ask you with a quick form. |
| **Pause for** | How long a pause lasts, from 15 minutes to 24 hours. |

The **Connection** section shows which organization and account the connection uses and when it was made. Settings are saved for this ChatGPT connection only; other apps you've connected, like Claude, keep the defaults.

Where ChatGPT can't show forms (on some platforms), **Ask each time** leaves the agent replying unless you ask the assistant to pause it.

### Open in ChatGPT

Once Wassist is installed in ChatGPT, conversations in the dashboard have an **Open in ChatGPT** link that opens the same conversation in the Wassist inbox in ChatGPT. Links like this can also go straight to a search or to the conversations that need review.

## Tools

These are the tools the server gives the assistant. You don't need to call them by name; the assistant picks them from what you ask.

| Tool | What it does |
| - | - |
| `search_conversations` | Searches conversations for a topic and charts how often it came up. |
| `get_conversation` | Opens a conversation: its messages, the reply window, and whether the agent is paused. |
| `list_conversations` | Lists recent conversations, optionally only those flagged for review, unread, or with the agent paused. |
| `list_whatsapp_numbers` | Lists the organization's WhatsApp numbers, their agents, and whether analytics (needed for search) is on. |
| `send_reply` | Sends a text reply while the 24-hour window is open, optionally pausing the agent first. |
| `suggest_template_reply` | Finds approved templates that can carry a message once the window has closed. Sends nothing. |
| `send_template_reply` | Sends an approved template with its variables. In ChatGPT it can instead let you pick the template and fill it in with a form. |
| `give_feedback` | Lets the assistant tell us when a tool behaved unexpectedly. Reports must be generic: anything with conversation content, names, numbers or what you asked about is rejected. Accepted reports are kept for 90 days. |

ChatGPT also uses a few tools the assistant itself never sees: `open_inbox` and `inbox_panel` (the sidebar inbox and side panel), `search_mentions` (@-mentions), and `settings_read`, `settings_update` and `connection_status` (the settings page).

## Manage connections

See every connected app under **Settings** → **Connected AI apps** in the [dashboard](https://wassist.app/settings/connected-apps). It shows who connected each app and when it was last used.

* Anyone can disconnect the apps they connected.
* Organization owners and admins can disconnect anyone's.
* Removing someone from the organization cuts off their connections straight away.

A disconnected app loses access immediately and has to sign in again to reconnect.

## Troubleshooting

> [accordion] Search finds nothing
>
> Check that Conversation Analytics is on for your numbers; ask the assistant to list your WhatsApp numbers to see which have it. Then try a longer date range or a broader search term.

> [accordion] The reply wasn't sent because the window is closed
>
> The customer hasn't messaged in the last 24 hours, so WhatsApp only accepts templates. Ask the assistant to find a template reply instead.

> [accordion] The assistant says to reconnect Wassist
>
> The connection was removed from **Connected AI apps**, or you're no longer a member of the organization. Disconnect and reconnect Wassist in your assistant's settings, then sign in again.

> [accordion] I don't see the chart or inbox
>
> Widgets only show in apps that support MCP Apps, such as Claude and ChatGPT. Other apps get the same results as text.

> [accordion] Wassist isn't in ChatGPT's sidebar, or @-mentions don't find conversations
>
> These need a recent ChatGPT app: update the desktop app, or use chatgpt.com. They also aren't available on every ChatGPT plan or platform yet; everything else still works from the chat.

> [accordion] ChatGPT keeps asking whether to pause the agent
>
> That's the **Ask each time** setting. Choose **Always** or **Never** under **Pause the agent on reply** in Wassist's settings in ChatGPT.

> [accordion] I connected the wrong organization
>
> Disconnect Wassist in your assistant, connect again, and pick the right organization on the sign-in page.

## What's next

> [card] [Analytics](https://docs.wassist.app/guides/analytics.md)
>
> Track how your agent is performing in the dashboard.

> [card] [Connect WhatsApp](https://docs.wassist.app/guides/connect-whatsapp.md)
>
> Add a WhatsApp number to your organization.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.