# Onswer MCP server: how to connect Claude, Codex and Cursor

Through MCP an AI assistant creates a bot from a website link, updates settings, grows the knowledge base, connects Telegram and shows analytics. Setup for Claude Code, Codex and Cursor.

Updated: November 5, 2026 · https://onswer.ai/docs/en/developers/mcp · Onswer

MCP (Model Context Protocol) is an open way to give an AI assistant access to outside programs. With the Onswer MCP server you can tell the assistant: "Create a bot for my coffee shop from the website link and connect Telegram", and it does it itself.

## What you need

- an [API key](/docs/en/developers/api-keys) like `wv_sk_…` from "Profile → AI assistants" in the dashboard;
- the server address: `https://api.onswer.ai/mcp`. It works over the Streamable HTTP protocol;
- one of the clients: Claude Code, Codex or Cursor.

## What the server does in version one

- create a bot from a website, Instagram or 2GIS link;
- update a bot's settings;
- add materials to the knowledge base and list its entries;
- send a test message to the bot;
- connect Telegram by token;
- give a dashboard link where the WhatsApp QR is scanned;
- show the status of channels;
- show an analytics summary and recent chats;
- show recent voice-agent calls (who called, how it ended, booking, transcript tail) and a calls summary for 7, 30 or 90 days.

There are **no tools for deleting**: the assistant cannot delete your bots or data. OAuth sign-in for the claude.ai and ChatGPT web versions will come later; for now only key sign-in is available.

## Connecting: Claude Code

One command in the terminal (use your own key):

```
claude mcp add --transport http salesbot https://api.onswer.ai/mcp --header "Authorization: Bearer wv_sk_YOUR_KEY"
```

To check: `claude mcp list`, or the `/mcp` command inside Claude Code.

## Connecting: Codex

Open `~/.codex/config.toml` and add a section. It is better to pass the key through an environment variable:

```
[mcp_servers.salesbot]
url = "https://api.onswer.ai/mcp"
bearer_token_env_var = "SALESBOT_API_KEY"
```

Before starting Codex, put the key in that variable, for example `export SALESBOT_API_KEY="wv_sk_..."`. You can pick any variable name as long as it matches.

## Connecting: Cursor

Open `~/.cursor/mcp.json` (for all projects) or `.cursor/mcp.json` in a project and add:

```
{
  "mcpServers": {
    "salesbot": {
      "url": "https://api.onswer.ai/mcp",
      "headers": {
        "Authorization": "Bearer ${env:SALESBOT_API_KEY}"
      }
    }
  }
}
```

Cursor takes the key from the `SALESBOT_API_KEY` environment variable.

> **Note:** The server name (`salesbot`) and the variable name are chosen as examples. The commands and settings formats are taken from the Claude Code, Codex and Cursor documentation as of November 2026; clients may change them, so check their documentation.

## Connecting through claude.ai and ChatGPT (soon)

> **Note:** Soon: the connector is not in the claude.ai and ChatGPT directories yet.

Once it is listed, no key is needed. In claude.ai or ChatGPT you press "Connect" next to the Onswer connector, sign in or create an account on our page, and press "Allow" on the consent screen. After that you are back in the chat, and the assistant manages your bots. A new account is a normal one: the Free plan and the Pro trial with the first bot.

- Only the company owner or co-owner can allow a connection.
- The connected apps are listed in "Profile → AI assistants → Connected apps". "Disconnect" there takes the app's access away at once.
- The assistant's access is the same as with a key: it cannot delete bots or change your plan and payment.

## Limits

- On the Free plan, MCP can create no more than **3 bots from a link per day**.
- On all plans, reading links (website, Instagram, 2GIS) is capped at **10 links per hour**.

When a limit is reached, the assistant tells you, and you can try again later.

## Security

The key gives the assistant access to your company within what the server offers. Connect it only to clients you trust, and do not publish settings files with the key inside.
