MCP-сервер: подключение ИИ-ассистента

MCP-сервер WbizTool позволяет ИИ-ассистенту работать с вашим рабочим пространством. Его можно спросить, например: «какие сообщения сегодня не отправились и почему?», «поставь напоминание об аренде на паузу» или «отправь наши новые часы работы этим пяти клиентам», и он выполнит это через ваш аккаунт WbizTool.

Он работает по протоколу Model Context Protocol (MCP), который понимают Claude Code, Cursor, VS Code и другие ИИ-инструменты. За кулисами каждое действие — это вызов API v2 с вашим собственным ключом API v2, поэтому именно ключ определяет, что ассистент может видеть и делать.

Что умеет ассистент#

Ассистент видит только те инструменты, которые разрешает ключ (см. области доступа):

Также есть три готовых промпта: daily summary (сводка за день), failed messages (неотправленные сообщения) и draft an announcement (черновик объявления).

Он не может подключить новый номер (это делается только в панели управления), загружать файлы, управлять вебхуками или читать входящие Unibox.

1. Создайте ключ для ассистента#

1. Откройте карточку «API-ключи v2»

   В WbizTool перейдите в Настройки → API-ключи и найдите карточку API-ключи v2.

2. Выберите готовый вариант для ИИ-ассистента

   Нажмите Создать ключ v2, затем Для ИИ-ассистента. Будет создан ключ Только чтение, который может читать сообщения и номера и действует 90 дней, — безопасный способ начать: ассистент может смотреть, но не может ничего отправить или изменить.

3. Разрешайте отправку, только если она нужна

   Если ассистент должен отправлять сообщения или управлять напоминаниями, снимите флажок Только чтение и отметьте Отправка сообщений (и при необходимости Напоминания). Ключ также можно ограничить некоторыми вашими номерами.

4. Скопируйте ключ

   Ключ (wbz_live_…) показывается один раз. Храните его в переменной окружения на своём компьютере, например WBIZTOOL_API_KEY, — никогда не вставляйте его в файл, которым вы делитесь или который коммитите.

export WBIZTOOL_API_KEY=wbz_live_…

2. Добавьте сервер в свой ИИ-инструмент#

claude mcp add --transport http wbiztool https://mcp.wbiztool.com/mcp \
  --header "Authorization: Bearer ${WBIZTOOL_API_KEY}"

{
  "mcpServers": {
    "wbiztool": {
      "type": "http",
      "url": "https://mcp.wbiztool.com/mcp",
      "headers": { "Authorization": "Bearer ${WBIZTOOL_API_KEY}" }
    }
  }
}

{
  "mcpServers": {
    "wbiztool": {
      "url": "https://mcp.wbiztool.com/mcp",
      "headers": { "Authorization": "Bearer ${env:WBIZTOOL_API_KEY}" }
    }
  }
}

{
  "inputs": [
    { "type": "promptString", "id": "wbiztool-key", "description": "WbizTool API v2 key (wbz_live_…)", "password": true }
  ],
  "servers": {
    "wbiztool": {
      "type": "http",
      "url": "https://mcp.wbiztool.com/mcp",
      "headers": { "Authorization": "Bearer ${input:wbiztool-key}" }
    }
  }
}

• Claude Code: выполните команду один раз (добавьте --scope project, чтобы поделиться сервером с проектом через .mcp.json; в файле хранится ${WBIZTOOL_API_KEY}, а не сам ключ).
• Cursor: поместите конфигурацию в ~/.cursor/mcp.json или в .cursor/mcp.json внутри проекта.
• VS Code: поместите конфигурацию в .vscode/mcp.json. VS Code один раз запросит ключ и сохранит его в своём хранилище секретов.

Затем спросите ассистента что-нибудь вроде «Какой у меня аккаунт WbizTool?» — он должен ответить названием и тарифом вашего рабочего пространства.

3. Как отправка остаётся безопасной#

• Каждая отправка сначала проходит предпросмотр. Когда вы просите отправить сообщение, ассистент сначала получает от WbizTool предпросмотр — с какого номера оно уйдёт, кому, точный текст, файл, если он есть, и когда, — и при этом ещё ничего не отправлено. Ассистенту предписано показать вам этот предпросмотр и дождаться вашего «да». Только после этого он отправляет ровно то, что вы видели.
• Повтор никогда не отправляет дважды. Если ассистент повторит подтверждённую отправку (например, после тайм-аута), WbizTool ответит уже отправленным сообщением.
• Ключ — жёсткое ограничение. Ключ «только чтение» вообще не может отправлять. Ключ без Отправка сообщений даже не видит инструменты отправки, а ключ, ограниченный некоторыми номерами, не может использовать остальные. Действуют и собственные лимиты WbizTool: 60 запросов в минуту на ключ и не более 1 000 сообщений в день с одного номера.
• Текст от других людей помечается как данные. Сообщения, имена и файлы, пришедшие извне, попадают к ассистенту с пометкой «ненадёжные», и ему предписано никогда не выполнять инструкции внутри них.
• Никаких секретов в ответах. QR-коды и коды привязки никогда не показываются, а списки не содержат ссылок на файлы.
• Отзыв в любой момент. Если отозвать ключ в разделе «Настройки → API-ключи», ассистент сразу перестанет работать.

Конфиденциальность#

Когда вы подключаете ассистента, то, что он читает из WbizTool (сообщения, имена и номера, которые вы разрешили видеть ключу), передаётся поставщику этого ассистента — например, Anthropic для Claude или OpenAI для ChatGPT — и обрабатывается по его условиям. Сам MCP-сервер WbizTool ничего не хранит: он передаёт каждый запрос в API v2 и записывает, какой инструмент был использован, но никогда не записывает текст сообщений или ваш ключ. Давайте ключу только тот доступ, который нужен ассистенту.

Решение проблем#

Связанные материалы#

• Обзор API v2
• API-ключи
• API v2: сообщения
• Приложения и интеграции