# MCP-сервер Onswer: как подключить Claude, Codex и Cursor

Через MCP ИИ-помощник создаёт бота по ссылке на сайт, обновляет настройки, пополняет базу знаний, подключает Telegram и показывает аналитику. Настройка для Claude Code, Codex и Cursor.

Обновлено: 5 ноября 2026 г. · https://onswer.ai/docs/developers/mcp · Onswer

MCP (Model Context Protocol) — открытый способ дать ИИ-помощнику доступ к внешним программам. С MCP-сервером Onswer вы можете сказать помощнику: «Создай бота для моей кофейни по ссылке на сайт и подключи Telegram», а он сделает это сам.

## Что нужно

- [API-ключ](/docs/developers/api-keys) вида `wv_sk_…` из раздела «Профиль → ИИ-помощники» в кабинете;
- адрес сервера: `https://api.onswer.ai/mcp`. Он работает по протоколу Streamable HTTP;
- один из клиентов: Claude Code, Codex или Cursor.

## Что умеет сервер в первой версии

- создать бота по ссылке на сайт, Instagram или 2ГИС;
- обновить настройки бота;
- добавить материалы в базу знаний и показать список записей;
- отправить тестовое сообщение боту;
- подключить Telegram по токену;
- выдать ссылку на кабинет, где сканируется QR для WhatsApp;
- показать статус каналов;
- показать сводку аналитики и последние чаты;
- показать последние звонки голосового агента (кто звонил, чем закончился, запись на приём, конец разговора) и сводку по звонкам за 7, 30 или 90 дней.

Инструментов для **удаления** нет: помощник не сможет удалить ваших ботов или данные. Вход через OAuth для веб-версий claude.ai и ChatGPT появится позже, сейчас доступен только вход по ключу.

## Подключение: Claude Code

Одна команда в терминале (ключ подставьте свой):

```
claude mcp add --transport http salesbot https://api.onswer.ai/mcp --header "Authorization: Bearer wv_sk_ВАШ_КЛЮЧ"
```

Проверить: `claude mcp list` или команда `/mcp` внутри Claude Code.

## Подключение: Codex

Откройте файл `~/.codex/config.toml` и добавьте раздел. Ключ лучше передавать через переменную окружения:

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

Перед запуском Codex положите ключ в эту переменную, например `export SALESBOT_API_KEY="wv_sk_..."`. Название переменной можете выбрать любое, главное, чтобы оно совпадало.

## Подключение: Cursor

Откройте файл `~/.cursor/mcp.json` (для всех проектов) или `.cursor/mcp.json` в проекте и добавьте:

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

Cursor подставит ключ из переменной окружения `SALESBOT_API_KEY`.

> **Важно:** Названия сервера (`salesbot`) и переменной выбраны для примера. Команды и форматы настроек взяты из документации Claude Code, Codex и Cursor на ноябрь 2026 года; у клиентов они могут меняться, поэтому сверяйтесь с их документацией.

## Подключение через claude.ai и ChatGPT (скоро)

> **Важно:** Скоро: коннектора пока нет в каталогах claude.ai и ChatGPT.

Когда коннектор появится в каталоге, ключ не понадобится. В claude.ai или ChatGPT нажимаете «Подключить» у коннектора Onswer, входите или создаёте аккаунт на нашей странице и нажимаете «Разрешить» на экране согласия. После этого вы снова в чате, а помощник управляет вашими ботами. Новый аккаунт обычный: тариф Free и пробный Pro к первому боту.

- Разрешить подключение может только владелец или совладелец компании.
- Подключённые приложения видны в «Профиль → ИИ-помощники → Подключённые приложения». Кнопка «Отключить» сразу лишает приложение доступа.
- Доступ помощника такой же, как по ключу: он не удаляет ботов и не меняет тариф и оплату.

## Ограничения

- На бесплатном тарифе через MCP можно создать не больше **3 ботов по ссылке в день**.
- На всех тарифах чтение ссылок (сайт, Instagram, 2ГИС) ограничено: не больше **10 ссылок в час**.

Если лимит исчерпан, помощник сообщит об этом, и можно повторить позже.

## Безопасность

Ключ даёт помощнику доступ к вашей компании в пределах возможностей сервера. Подключайте его только к тем клиентам, которым доверяете, и не публикуйте файлы настроек с ключом внутри.
