Klavis MCP — Установка & Живое демо

Зачем использовать

Ключевые функции

Hosted MCP для Slack, Salesforce, Notion, Jira, Gmail, Drive, Calendar, HubSpot, Asana и др.
OAuth 2.0 от начала до конца — не нужно управлять токенами для каждого пользователя
Единая MCP-точка входа вне зависимости от числа подключённых приложений
Журнал аудита каждого вызова инструмента на тенанта
Опция self-host через Docker для сред с жёсткими требованиями к соответствию

Живое демо

Как выглядит на практике

klavis.replay ▶ готово

0/0

Установка

Выберите клиент

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "klavis": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.klavis.ai/mcp/{server}?auth_token=YOUR_TOKEN"
      ]
    }
  }
}

Откройте Claude Desktop → Settings → Developer → Edit Config. Перезапустите после сохранения.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "klavis": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.klavis.ai/mcp/{server}?auth_token=YOUR_TOKEN"
      ]
    }
  }
}

Cursor использует ту же схему mcpServers, что и Claude Desktop. Конфиг проекта приоритетнее глобального.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "klavis": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.klavis.ai/mcp/{server}?auth_token=YOUR_TOKEN"
      ]
    }
  }
}

Щёлкните значок MCP Servers на боковой панели Cline, затем "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "klavis": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.klavis.ai/mcp/{server}?auth_token=YOUR_TOKEN"
      ]
    }
  }
}

Тот же формат, что и Claude Desktop. Перезапустите Windsurf для применения.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "klavis",
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.klavis.ai/mcp/{server}?auth_token=YOUR_TOKEN"
      ]
    }
  ]
}

Continue использует массив объектов серверов, а не map.

~/.config/zed/settings.json

{
  "context_servers": {
    "klavis": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "mcp-remote",
          "https://api.klavis.ai/mcp/{server}?auth_token=YOUR_TOKEN"
        ]
      }
    }
  }
}

Добавьте в context_servers. Zed перезагружается автоматически.

claude mcp add klavis -- npx -y mcp-remote https://api.klavis.ai/mcp/{server}?auth_token=YOUR_TOKEN

Однострочная команда. Проверить: claude mcp list. Удалить: claude mcp remove.

Сценарии использования

Реальные сценарии: Klavis

Запустить агента, работающего с 5 SaaS-инструментами без 5 отдельных авторизаций

👤 Разработчики продуктов, встраивающие Claude в своё приложение ⏱ ~45 min intermediate

Когда использовать: Пользователи хотят, чтобы Claude читал Gmail, обновлял HubSpot, комментировал в Jira — и вы не хотите писать OAuth-обвязку для каждого.

Предварительные требования

Аккаунт Klavis + API-ключ — Зарегистрируйтесь на klavis.ai и возьмите ключ из дашборда
Нужные серверы включены — Активируйте Gmail, HubSpot, Jira в UI Klavis

Поток

Подключить шлюз

Add Klavis as an MCP server with my token. List which tools are now available.✓ Скопировано

→ Список инструментов содержит конечные точки Gmail, HubSpot, Jira
Авторизация пользователя

Generate the Connect-Gmail URL for user_id=xyz. When they return, confirm auth succeeded.✓ Скопировано

→ Возвращён OAuth URL; после callback показывается connected:true
Кросс-приложное действие

For the latest Gmail from acme.com, create a HubSpot contact and a Jira ticket summarizing the thread.✓ Скопировано

→ Все три API задействованы в одном потоке с журналом аудита

Итог: Работающий мульти-SaaS агент с авторизацией на уровне пользователя и единым URL конфига.

Подводные камни

Токены пользователей истекают незаметно — Подпишитесь на вебхук auth_expired и попросите пользователя переподключиться

Сочетать с: gmail · slack

Внутренний ops-бот — создавать тикеты, обновлять CRM, постить в Slack из одного чата

👤 Команды внутренних инструментов ⏱ ~30 min intermediate

Когда использовать: Вы хотите один чат с Claude, который умеет «разобраться с бумагами» по всему SaaS-стеку.

Предварительные требования

Одноразовая OAuth-авторизация всех приложений от admin — Подключите каждое приложение от командного аккаунта, не от каждого пользователя

Поток

Подключить стек

Add Klavis. Confirm Salesforce, Jira, Slack are all connected.✓ Скопировано

→ Все три показывают статус connected
Обработать обращение

For the customer complaint in the last Slack #support message: create a Salesforce case, a Jira bug, and reply-in-thread with the ticket links.✓ Скопировано

→ Кейс + баг созданы; в Slack-треде появилась ссылка

Итог: Кросс-инструментовое действие завершено в одном чате с квитанциями в каждой системе.

Подводные камни

Ограничения по запросам в Slack — Дашборд Klavis показывает квоту по приложениям; по возможности группируйте операции

Сочетать с: slack · linear

Комбинации

Сочетайте с другими MCP — эффект x10

klavis + gmail

Локальный Gmail MCP для личного использования, Klavis — для мультипользовательских сценариев

Use my local Gmail MCP for me, Klavis for customer data.✓ Скопировано

klavis + slack

Отправлять статусные обновления из ops-потоков

After creating the Salesforce case, post a summary in #customers via Klavis.✓ Скопировано

Инструменты

Что предоставляет этот MCP

Инструмент	Входные данные	Когда вызывать	Стоимость
list_connected_apps	user_id?: str	Проверить, какие приложения подключил данный пользователь	free
get_auth_url	app: str, user_id: str	Запустить OAuth-поток для пользователя	free
proxy_tool_call	app, tool, args, user_id	Любой вызов к downstream-инструменту — Klavis маршрутизирует его	varies by app

Стоимость и лимиты

Во что обходится

Квота API: Бесплатный тариф: 1k вызовов/мес. Pro: 100k/мес.
Токенов на вызов: 100–2000 в зависимости от приложения
Деньги: Freemium + по использованию
Совет: Проверьте, какие приложения дают наибольший объём вызовов, и установите квоты по приложениям в дашборде

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

Права, секреты, радиус поражения

Минимальные скоупы: read (per app) write-scoped (per app)

Хранение учётных данных: Klavis хранит OAuth-токены; шифрование в покое

Исходящий трафик: api.klavis.ai + каждый downstream SaaS

Никогда не давайте: admin scopes unless truly needed

Используйте self-host Docker для сред с SOC2 — hosted-плоскость видит весь трафик

Устранение неполадок

Частые ошибки и исправления

401 from proxy_tool_call

OAuth пользователя истёк — вызовите get_auth_url снова и попросите переподключиться

Проверить: Call list_connected_apps, check status==connected

Сервер "notion" не найден в шлюзе

Сначала включите его в дашборде Klavis, затем перезапустите MCP-клиент для обновления инструментов

Превышен лимит запросов для одного приложения

Klavis возвращает 429 с retry_after; сделайте паузу или сгруппируйте запросы

Альтернативы

Klavis в сравнении

Альтернатива	Когда использовать	Компромисс
Composio MCP	Нужна аналогичная hosted-платформа интеграций с другим ценообразованием	Другое покрытие приложений; схожая модель авторизации
Self-hosted individual MCPs	Один пользователь, мало приложений, требования к соответствию	Вы сами пишете OAuth-обвязку для каждого приложения

Ещё

Ресурсы

📖 Читать официальный README на GitHub

🐙 Открытые задачи

🔍 Все 400+ MCP-серверов и Skills