MCP-сервер Knowi

Подключите Claude Code, Claude Desktop, Cursor или любой другой ИИ-клиент с поддержкой MCP к Knowi. Запрашивайте данные, создавайте дашборды, управляйте отчетами и многое другое — на естественном языке, напрямую через вашего ИИ-ассистента.

MCP-сервер встроен в приложение Knowi. Отдельная установка не требуется.

Быстрый старт

1. Создание MCP-токена

1. Войдите в Knowi

2. Перейдите в Settings → AI Settings (Настройки → Настройки ИИ)

3. В разделе MCP Token выберите срок действия и нажмите Generate Token (Создать токен)

4. Скопируйте токен — он отображается только один раз

2. Подключение к Claude Code

claude mcp add knowi https://your-instance.knowi.com/api/2.0/mcp \
  --transport http \
  --header "Authorization: Bearer YOUR_MCP_TOKEN"

Для аккаунтов knowi.com:

claude mcp add knowi https://www.knowi.com/api/2.0/mcp \
  --transport http \
  --header "Authorization: Bearer YOUR_MCP_TOKEN"

3. Подключение к Claude Desktop

Отредактируйте файл конфигурации:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

• Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "knowi": {
      "type": "streamable-http",
      "url": "https://your-instance.knowi.com/api/2.0/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_MCP_TOKEN"
      }
    }
  }
}

После сохранения перезапустите Claude Desktop.

4. Проверка

"What Knowi tools are available?"

Вы должны увидеть инструменты, включая knowi_do, knowi_ask, knowi_search, knowi_list_dashboards и другие.

Related MCP server: AgenticBI

Доступные инструменты

Инструменты на базе ИИ

Инструменты естественного языка, которые используют ИИ-оркестратор Knowi для интерпретации инструкций и объединения операций в цепочки.

Детерминированные инструменты

Прямые, быстрые операции с предсказуемым поведением.

Примеры использования

"Show me my Knowi dashboards"

"Ask Knowi: what were our top customers by revenue last month?"

"Create a sales dashboard with revenue trends and top products"

"Search Knowi for dashboards related to customer analytics"

"Get the data from the Monthly Revenue widget"

"Export the Executive Summary dashboard to PDF"

"Push these sales records to a Knowi dataset called 'Daily Sales'"

"Set up a daily email report for the executive dashboard"

Управление токенами

Ротация токена:

1. Перейдите в Settings → AI Settings → MCP Token

2. Нажмите Revoke Token (Отозвать токен)

3. Создайте новый и обновите конфигурацию:

claude mcp remove knowi
claude mcp add knowi https://your-instance.knowi.com/api/2.0/mcp \
  --transport http \
  --header "Authorization: Bearer YOUR_NEW_TOKEN"

Один токен на пользователя. Создание нового токена автоматически отзывает предыдущий.

Справочник API

MCP-сервер предоставляет как Streamable HTTP (для MCP-клиентов), так и REST-эндпоинты (для прямого программного использования).

Проверка работоспособности (Health Check)

curl https://your-instance.knowi.com/api/2.0/mcp/health

{
  "status": "healthy",
  "toolCount": 28,
  "tools": ["knowi_do", "knowi_ask", "knowi_search", "..."],
  "activeSessions": 0
}

Список инструментов

curl -H "Authorization: Bearer YOUR_TOKEN" \
  https://your-instance.knowi.com/api/2.0/mcp/tools

Вызов инструмента (REST)

curl -X POST https://your-instance.knowi.com/api/2.0/mcp/tools/call \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "knowi_list_dashboards",
    "arguments": {}
  }'

Streamable HTTP (JSON-RPC)

Все операции MCP-клиента используют POST /api/2.0/mcp со стандартным JSON-RPC:

# Initialize
curl -X POST https://your-instance.knowi.com/api/2.0/mcp \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}'

Ответ включает заголовок Mcp-Session-Id для использования в последующих запросах.

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

• Ограниченные учетные данные: MCP-токены имеют доступ только к MCP-эндпоинтам — их нельзя использовать для работы с основным Management API.

• Авторизация при каждом запросе: Каждый инструмент проверяет, имеет ли аутентифицированный пользователь доступ к запрашиваемому ресурсу перед выполнением.

• Защита от инъекций промптов: Инструменты на базе ИИ сканируют инструкции на наличие известных шаблонов инъекций и отклоняют их до передачи ИИ-модели.

• Защита от деструктивных операций: knowi_do блокирует инструкции удаления/сброса/очистки. Удаления требуют использования явного инструмента knowi_delete с обязательным параметром confirm: true.

• Усечение данных: knowi_get_data и knowi_ask по умолчанию возвращают не более 100 строк.

• Безопасность сессии: Streamable HTTP-сессии привязаны к аутентифицированному пользователю. Идентификаторы сессий сами по себе не предоставляют доступ.

Поток данных

Когда Claude вызывает инструмент Knowi MCP, ответ инструмента (строки данных, метаданные, аналитика) возвращается в Claude и обрабатывается в инфраструктуре Anthropic. Это неотъемлемая часть MCP — клиент должен получать результаты, чтобы действовать на их основе.

Для максимальной изоляции данных используйте ИИ-агенты внутри продукта Knowi вместо MCP.

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

Инструменты не отображаются в Claude:

• Полностью перезапустите Claude Code / Claude Desktop

• Проверьте доступность сервера: curl https://your-instance.knowi.com/api/2.0/mcp/health

• Проверьте валидность токена: curl -H "Authorization: Bearer TOKEN" https://your-instance.knowi.com/api/2.0/mcp/tools

Ошибка "Failed to connect" в claude mcp list:

• Убедитесь, что вы использовали --transport http (требуется для Streamable HTTP)

• Удалите и добавьте сервер снова, если транспорт был настроен неверно

Ошибки 401:

• Токен может быть просрочен или отозван. Создайте новый токен в Settings → AI Settings и обновите конфигурацию.

Вызовы инструментов возвращают "access denied" (доступ запрещен):

• Пользователь, чей токен вы настроили, не имеет прав на запрашиваемый ресурс.

• Для промышленного использования создайте выделенного пользователя Knowi с минимально необходимыми правами.

Требования

• Аккаунт Knowi с включенными AI Agents (Settings → AI Settings)

• Claude Code CLI, Claude Desktop или любой клиент с поддержкой MCP

Документация

• Справочник MCP-сервера — полный справочник API, схемы всех инструментов, модель безопасности

• Руководство по настройке Claude Code — пошаговые инструкции по настройке

• Документация Knowi — полная документация по продукту

Поддержка

• Документация: knowi.com/docs

• Поддержка: support.knowi.com

• Проблемы с этим репозиторием: Откройте issue на GitHub