Knowi MCPサーバー

Claude Code、Claude Desktop、Cursor、またはその他のMCP互換AIクライアントをKnowiに接続します。AIアシスタントから直接、自然言語でデータのクエリ、ダッシュボードの作成、レポートの管理などを行うことができます。

MCPサーバーはKnowiアプリケーションに組み込まれています。別途インストールする必要はありません。

クイックスタート

1. MCPトークンの生成

1. Knowiにログインします

2. Settings（設定） → AI Settings（AI設定） に移動します

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

利用可能なツール

AI搭載ツール

KnowiのAIオーケストレーターを使用して指示を解釈し、操作を連鎖させる自然言語ツールです。

決定論的ツール

予測可能な動作をする、直接的で高速な操作ツールです。

使用例

"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"

ユーザーごとに1つのトークン。 新しいトークンを生成すると、以前のトークンは自動的に無効になります。

APIリファレンス

MCPサーバーは、Streamable HTTP（MCPクライアント用）とRESTエンドポイント（直接的なプログラム利用用）の両方を公開しています。

ヘルスチェック

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クライアント操作は、標準のJSON-RPCを使用して POST /api/2.0/mcp を呼び出します:

# 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エンドポイントにのみアクセスでき、より広範な管理APIに対しては使用できません。

• リクエストごとの認可: すべてのツールは、実行前に認証されたユーザーが要求されたリソースへのアクセス権を持っていることを検証します。

• プロンプトインジェクション保護: AI搭載ツールは、既知のインジェクションパターンがないか指示をスキャンし、AIモデルに到達する前に拒否します。

• 破壊的操作の保護: knowi_do は delete/drop/purge 命令をブロックします。削除には、confirm: true パラメータを必須とする knowi_delete ツールを使用する必要があります。

• データの切り捨て: knowi_get_data および knowi_ask は、デフォルトで最大100行を返します。

• セッションセキュリティ: Streamable HTTPセッションは認証されたユーザーに紐付けられます。セッションID単体ではアクセス権を付与しません。

データフロー

ClaudeがKnowi MCPツールを呼び出すと、ツールのレスポンス（データ行、メタデータ、インサイト）がClaudeに返され、Anthropicのインフラストラクチャ上で処理されます。これはMCPの性質上避けられないものであり、クライアントは結果を受け取って処理する必要があります。

データの分離を最大化するには、MCPの代わりにKnowiの製品内AIエージェントを使用してください。

トラブルシューティング

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

claude mcp list で「Failed to connect」と表示される場合:

• --transport http を使用したか確認してください（Streamable HTTPに必須）

• トランスポートの設定が正しくない場合は、サーバーを削除して再追加してください

401エラー:

• トークンの有効期限が切れているか、無効化されている可能性があります。Settings → AI Settings から新しいトークンを生成し、設定を更新してください。

ツール呼び出しでアクセス拒否が返される場合:

• 設定したトークンのユーザーが、要求されたリソースへのアクセス権を持っていません。

• 本番環境で使用する場合は、必要な最小限の権限を持つ専用のKnowiユーザーを作成してください。

要件

• AI Agents が有効なKnowiアカウント（Settings → AI Settings）

• Claude Code CLI、Claude Desktop、またはMCP互換クライアント

ドキュメント

• MCPサーバーリファレンス — 完全なAPIリファレンス、すべてのツールスキーマ、セキュリティモデル

• Claude Codeセットアップガイド — ステップバイステップのセットアップ手順

• Knowiドキュメント — 製品ドキュメント全体

サポート

• ドキュメント: knowi.com/docs

• サポート: support.knowi.com

• このリポジトリに関する問題: GitHub issueを作成してください