KnowSync AI

公式

散在するドキュメントを、Claude、Cursor、VS Code、その他のAIツールとシームレスに連携するAI対応の知識に変換します。

KnowSync AI MCPで何ができますか？

ナレッジベースを検索 — AIに、関連するドキュメントやコンテンツを検索させます。knowsync_query を使用し、自動インテント検出とAIによる再ランキングを利用します。
ドキュメントを管理 — knowsync_manage を使用して、ナレッジベース監査のために、ステータスやコンテンツタイプでドキュメントを一覧表示、閲覧、フィルタリングします。
ウェブコンテンツを追加 — AIに特定のURLをクロールさせたり、関連するウェブページを発見させて、knowsync_manage 経由で自動的にナレッジベースに追加させます。
セッションを考慮したフォローアップ — 同じ会話内で文脈に沿ったフォローアップ質問ができます。knowsync_query がコンテキストを保持し、自然なマルチターンクエリを実現します。

ドキュメント

MCP統合

KnowSyncのModel Context Protocol（MCP）サーバーにより、AIエージェントが組織のナレッジベースにリアルタイムでアクセスできるようになります。Claude、Cursor、VS Code、その他のAIツールを接続して、ナレッジベースのコンテンツをシームレスに検索、取得、追加できます。

MCPとは

概要

Model Context Protocol（MCP）は、Anthropicが開発したオープン標準であり、AIアプリケーションが外部データソースに安全にアクセスできるようにします。KnowSyncのMCPサーバーは、インテリジェントキャッシュ、AI駆動のクエリ最適化、セッション管理を備えた2つの統合ツールを提供し、AIエージェントが標準化されたJSON-RPC 2.0 APIを通じてナレッジベースと対話できるようにします。

主な機能

2つの統合ツール：

ユニバーサルクエリ：自動インテント検出、AI駆動の再ランキング、スマートキャッシュ、セッション認識型コンテキスト保持を備えたインテリジェントな検索と取得
ドキュメント管理：Webクローリング、ディスカバリー、使用状況追跡を含む包括的なコンテンツ管理とドキュメント操作

エンタープライズセキュリティ：

詳細な権限を持つAPIキー認証
レート制限と使用状況追跡
全リクエストのチームメンバー帰属
IP制限とアクセス制御

MCP APIキーの設定

最初のAPIキーの作成

MCPダッシュボードにアクセス：組織ダッシュボードに移動し、MCPサーバーカードをクリックします
APIキータブに移動：APIキーセクションをクリックします
新しいキーを作成：APIキーの作成ボタンをクリックします
キー設定を構成：
- 名前：わかりやすい名前（例：「Claude Desktop」、「開発テスト」）
  - 権限：キーがアクセスできるツールを選択
  - レート制限：1時間あたりのリクエスト数を設定（プランに基づく）

利用可能なMCPツール

KnowSyncは、以前の5ツールシステムの機能を統合した2つの強力な統合MCPツールを提供します：

ユニバーサルツール（全プラン）

knowsync_query：

インテリジェントキャッシュによるユニバーサル検索とコンテンツ取得（応答が60〜85%高速化）
クエリ拡張と最適化を備えた自動インテント検出（検索と取得）
会話メモリによるフォローアップクエリのセッション認識型コンテキスト保持
AIクエリ分類と信頼度スコアリングに基づくスマートパラメータ調整
関連性向上のためのAI駆動の結果再ランキング（Pro+プラン）
繰り返しクエリを高速化する埋め込み類似性キャッシュ

管理ツール（全プラン）

knowsync_manage：

使用状況追跡を備えた包括的なドキュメント管理操作
高度なフィルタリングとステータス監視によるドキュメントの一覧表示と閲覧（0.5 APIユニット）
完全なベクトル処理による特定のWebページのナレッジベースへの追加（URLあたり2 APIユニット：クロール1 + 処理1）
自動処理による関連Webコンテンツの調査と発見（発見されたURLあたり2 APIユニット）
詳細なAPI消費追跡を備えた全ドキュメント操作の統合インターフェース

権限設定

ツールレベルの権限：各APIキーには、ニーズに基づいて特定のツールへのアクセスを付与できます：

検索のみ：読み取り専用のAIエージェントに最適
フルアクセス：利用可能なすべてのツールへの完全なアクセス
カスタム：特定のユースケースに合わせて特定のツールを選択

レート制限：使用パターンに基づいてリクエスト制限を設定：

無料プラン：最大60リクエスト/時間
スタータープラン：最大600リクエスト/時間
プロフェッショナルプラン：最大3,000リクエスト/時間
エンタープライズプラン：カスタム制限が利用可能

AIツールとの統合

Claude Desktopのセットアップ

前提条件：

Claude Desktopアプリケーション（最新版）
適切な権限を持つKnowSync APIキー
チーム追跡用のユーザー識別情報

設定：

サーバーURLを取得：https://www.knowsync.ai/api/mcp
Claude Desktop設定に追加：

{
  "mcpServers": {
    "knowsync": {
      "url": "https://www.knowsync.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY",
        "X-User-Id": "your_user_id_here"
      }
    }
  }
}

Cursor IDE統合

セットアップ手順：

Cursor設定を開く（Cmd/Ctrl + ,）
MCPセクションに移動
KnowSyncサーバーを追加：

{
  "mcpServers": {
    "knowsync": {
      "url": "https://www.knowsync.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY",
        "X-User-Id": "your_user_id_here"
      }
    }
  }
}

VS Code統合

MCP拡張機能の使用：

VS Code用のMCP拡張機能をインストール
settings.jsonで設定：

{
  "mcp.servers": {
    "knowsync": {
      "url": "https://www.knowsync.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY",
        "X-User-Id": "your_user_id_here"
      }
    }
  }
}

Claude Codeのセットアップ

前提条件：

Claude Code CLIがインストールされていること（npm install -g @anthropic-ai/claude-codeからインストールするか、公式インストールガイドに従ってください）
適切な権限を持つKnowSync APIキー
KnowSyncユーザー/メールID（プロフィール設定で確認可能）

設定：

Claude CLIを使用してKnowSync MCPサーバーを追加：

ユーザーIDを使用：

claude mcp add --transport http knowsync https://www.knowsync.ai/api/mcp \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "X-User-Id: your_user_id_here"

ユーザーメールを使用：

claude mcp add --transport http knowsync https://www.knowsync.ai/api/mcp \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "X-User-Email: your_user_email_here"

設定を確認：

claude mcp list

これにより、リストにknowsyncサーバーが表示されるはずです。

注意：APIキーに必要なツール権限があることを確認してください。プレースホルダーを実際の値に置き換えてください。

チームメンバー追跡

必須ヘッダー：すべてのMCPリクエストには、適切な帰属のためにユーザー識別情報を含める必要があります：

X-User-Id：KnowSyncユーザーID（プロフィール設定で確認可能）
X-User-Email：登録済みのメールアドレス

必要な理由：

個々のチームメンバーの使用状況を追跡
ユーザーごとの分析とインサイトを生成
適切な監査証跡を確保
使用量ベースの課金と制限を有効化

実際のMCP使用例

開発ワークフロー統合

シナリオ1：コードレビューアシスタント

ユースケース：AIエージェントがチームのコーディング標準とベストプラクティスにアクセスしてコードレビューを支援します。

# Query for coding standards
curl -X POST https://www.knowsync.ai/api/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-User-Id: your_user_id" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "knowsync_query",
      "arguments": {
        "query": "What are our React component naming conventions and prop validation requirements?",
        "mode": "retrieve",
        "limit": 4
      }
    }
  }'

AIエージェント統合：開発中にチームの標準に即座にアクセスできるよう、Claude Codeをこの用途に設定します。

シナリオ2：新規チームメンバーのオンボーディング

ユースケース：新入社員向けに最新のフレームワークドキュメントをナレッジベースに自動的に追加します。

# Discover and add latest documentation
curl -X POST https://www.knowsync.ai/api/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-User-Id: your_user_id" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
      "name": "knowsync_manage",
      "arguments": {
        "operation": "discover",
        "query": "Next.js 15 App Router migration guide 2024",
        "options": {
          "maxResults": 8,
          "maxUrls": 4,
          "relevanceThreshold": 0.8
        }
      }
    }
  }'

API消費を含む期待される応答：

{
  "success": true,
  "documentsCreated": 4,
  "apiUnitsConsumed": 8,
  "message": "Successfully discovered and processed 4 documents into knowledge base (8 API units consumed)"
}

注：4 URL × 各2ユニット（クロール1 + 処理1）= 合計8 APIユニット

カスタマーサポートの強化

シナリオ3：インスタントサポートドキュメントアクセス

ユースケース：サポートエージェントが顧客対応中に製品ドキュメントから即座に回答を得られます。

# Search for troubleshooting information
curl -X POST https://www.knowsync.ai/api/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-User-Id: support_agent_123" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 3,
    "method": "tools/call",
    "params": {
      "name": "knowsync_query",
      "arguments": {
        "query": "Customer getting 401 errors during payment processing, what are the common causes and solutions?",
        "mode": "auto",
        "limit": 6
      }
    }
  }'

利点：キャッシュにより応答時間が60〜85%短縮され、AI強化された関連性ランキングが最も役立つソリューションを最初に表示します。

プロダクトマネジメントワークフロー

シナリオ4：競合分析リサーチ

ユースケース：プロダクトマネージャーが競合他社の機能と業界トレンドを調査します。

# Discover latest competitive analysis
curl -X POST https://www.knowsync.ai/api/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-User-Id: product_manager" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 4,
    "method": "tools/call",
    "params": {
      "name": "knowsync_manage",
      "arguments": {
        "operation": "discover",
        "query": "SaaS pricing strategy trends 2024 freemium models",
        "options": {
          "maxResults": 10,
          "maxUrls": 5,
          "relevanceThreshold": 0.7
        }
      }
    }
  }'

シナリオ5：機能要件の検索

ユースケース：計画中に既存の機能仕様と要件をすばやく見つけます。

# Search existing requirements
curl -X POST https://www.knowsync.ai/api/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-User-Id: product_manager" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 5,
    "method": "tools/call",
    "params": {
      "name": "knowsync_query",
      "arguments": {
        "query": "user authentication flow requirements two-factor authentication implementation",
        "mode": "retrieve",
        "filters": {
          "contentTypes": ["documents"],
          "documentIds": ["spec_docs_collection"]
        }
      }
    }
  }'

セールスおよびマーケティングサポート

シナリオ6：セールスイネーブルメント

ユースケース：セールスチームが顧客対応中に製品情報と競合ポジショニングにアクセスします。

# Quick product feature lookup
curl -X POST https://www.knowsync.ai/api/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-User-Id: sales_rep" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 6,
    "method": "tools/call",
    "params": {
      "name": "knowsync_query",
      "arguments": {
        "query": "What security certifications do we have? SOC 2 compliance status enterprise security features",
        "mode": "search",
        "limit": 5
      }
    }
  }'

ナレッジベースメンテナンス

シナリオ7：コンテンツギャップ分析

ユースケース：どのドキュメントが存在し、何を作成する必要があるかを特定します。

# Audit existing documentation
curl -X POST https://www.knowsync.ai/api/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-User-Id: content_manager" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 7,
    "method": "tools/call",
    "params": {
      "name": "knowsync_manage",
      "arguments": {
        "operation": "list",
        "filters": {
          "limit": 50,
          "status": "ready",
          "contentType": "markdown"
        }
      }
    }
  }'

シナリオ8：業界ドキュメントの追加

ユースケース：最新の業界標準とフレームワークでナレッジベースを最新に保ちます。

# Add specific technical documentation
curl -X POST https://www.knowsync.ai/api/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-User-Id: tech_writer" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 8,
    "method": "tools/call",
    "params": {
      "name": "knowsync_manage",
      "arguments": {
        "operation": "crawl",
        "url": "https://nextjs.org/docs/app/building-your-application/authentication",
        "options": {
          "respectRobots": true,
          "timeout": 45,
          "followLinks": false
        }
      }
    }
  }'

KnowSync MCPが革新的である理由

パワーの違い

従来のドキュメントシステムでは、情報を探し回る必要があります。KnowSync MCPでは、情報があなたのもとに届きます：

KnowSync MCP導入前：

ドキュメントを検索するためにツールを切り替える
類似の質問に対して検索を繰り返す
複数のソースから情報を手動でまとめる
検索ごとに2〜5秒待つ
関連性があるかどうかわからない結果を得る

KnowSync MCP導入後：

AIエージェントが自動的にナレッジベースにアクセス
インテリジェントキャッシュにより応答が60〜85%高速化
AIがコンテキストを理解し、必要なものを正確に提供
セッションメモリが会話コンテキストを維持
結果はAIによって最大の関連性にランク付け

ワークフローへの実際の影響

# Traditional approach: Manual search in documentation
# Time: 2-5 minutes per question
# Result: May not find the right answer

# KnowSync MCP approach: AI agent instantly knows
# Time: 2-5 seconds per question
# Result: Contextual, accurate, source-cited answers

例：「認証はどう扱っていますか？」と尋ねる開発者は、認証ドキュメントだけでなく、現在のプロジェクトコンテキストに関連するセクションを、フォローアップ提案付きで2秒以内に取得できます。

高度な統合パターン

セッション認識型会話

AIは同じセッション内のクエリ間でコンテキストを記憶し、自然なフォローアップ質問を可能にします：

# First query
curl -X POST https://www.knowsync.ai/api/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-User-Id: developer_session_123" \
  -d '{
    "params": {
      "name": "knowsync_query",
      "arguments": {
        "query": "How do we handle user authentication in our React apps?"
      }
    }
  }'

# Follow-up query (AI maintains context)
curl -X POST https://www.knowsync.ai/api/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-User-Id: developer_session_123" \
  -d '{
    "params": {
      "name": "knowsync_query",
      "arguments": {
        "query": "What about logout and session management for that?"
      }
    }
  }'

パフォーマンス最適化の例

インテリジェントキャッシュのパワーを実証します：

# First time query (full processing)
time curl -X POST https://www.knowsync.ai/api/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-User-Id: your_user_id" \
  -d '{
    "params": {
      "name": "knowsync_query",
      "arguments": {
        "query": "deployment pipeline configuration Docker containerization"
      }
    }
  }'
# Response time: ~800ms

# Similar query (cached response)
time curl -X POST https://www.knowsync.ai/api/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-User-Id: your_user_id" \
  -d '{
    "params": {
      "name": "knowsync_query",
      "arguments": {
        "query": "how to configure deployment pipelines with Docker containers"
      }
    }
  }'
# Response time: ~120ms (85% faster!)

チームの生産性を変革

KnowSync MCP導入前と導入後

| シナリオ | 従来の方法 | KnowSync MCP導入後 | 節約時間 | |----------|-------------------|-------------------|------------| | コードレビュー | ドキュメントを手動で検索 | AIエージェントがコーディング標準を即座に引用 | 90%高速化 | | カスタマーサポート | トラブルシューティングガイドを調べる | AIが正確な解決手順を提供 | 85%高速化 | | オンボーディング | ドキュメントへのリンクを送信 | AIが文脈に応じて具体的な質問に回答 | 95%高速化 | | 製品計画 | 競合他社の機能を手動で調査 | AIが最新トレンドを発見・分析 | 80%高速化 |

複合効果

1週目：チームはドキュメント検索で1日あたり2〜3時間を節約 1ヶ月目：チームメンバー1人あたり40〜60時間を節約 1年目：各チームメンバーが2〜3週間の生産時間を取り戻す

実際のユーザー影響ストーリー

開発チーム：「APIパターンを探すのに30分費やす代わりに、Claude Codeが私が必要とするものを即座に表示してくれます。探し回る代わりに構築に集中できます。」

サポートチーム：「以前は調査に10分かかっていた顧客の質問が、今では30秒で回答できるようになりました。応答品質が向上し、応答時間は劇的に短縮されました。」

製品チーム：「以前は数時間かかっていた調査が、今では数分で完了します。競合機能の分析、要件の発見、意思決定をこれまで以上に迅速に行えます。」

はじめ方は簡単

APIキーを作成（2分）
AIエージェントを接続（Claude、Cursor、VS Code）
質問を始める - それだけです！

パワーはテクノロジーにあるのではなく、検索から創造へと日常業務を変革する方法にあります。

使用状況分析とモニタリング

MCPダッシュボード機能

APIキー管理：

APIキーの作成、編集、削除
キーごとの使用統計の監視
権限とレート制限の設定
リクエスト履歴とパターンの表示

使用状況分析：

ツール別のリアルタイムリクエストメトリクス
成功/エラー率と応答時間
ユーザーごとの帰属とチームインサイト
履歴トレンドと使用パターン

設定構成：

Webクローリング制限とタイムアウト設定
Webディスカバリー用のドメイン許可/ブロックリスト
コンテンツタイプフィルタリング設定
レート制限とセキュリティ制御

チーム使用状況追跡

個別分析：

どのチームメンバーがMCPツールを使用しているかを追跡
組織全体の採用パターンを監視
パワーユーザーとトレーニングニーズを特定
管理層向けの使用状況レポートを生成

リクエスト帰属：すべてのMCPリクエストにはユーザー識別ヘッダーが必要です：

X-User-Id：直接のユーザーID帰属
X-User-Email：メールベースのユーザー帰属
ユーザーヘッダーがないリクエストは拒否されます
コンプライアンスのための完全な監査証跡

セキュリティとアクセス制御

認証システム

APIキーセキュリティ：

保存キーのBcryptハッシュ化
自動キーローテーション機能
悪用防止のためのキーごとのレート制限
不審なアクティビティのリアルタイム監視

権限モデル：

ツールレベルの権限（詳細なアクセス制御）
組織ベースのアクセス制限
プランベースの機能利用可能性
カスタム権限の組み合わせ

エンタープライズセキュリティ（エンタープライズプラン）

高度な機能：

IPベースのアクセス制限
シングルサインオン（SSO）統合
コンプライアンス要件のための監査ログ
カスタムセキュリティポリシーと制御

データ保護：

すべての通信におけるTLS暗号化
APIキーとユーザーデータの安全な保存
GDPRおよびCCPA準拠機能
定期的なセキュリティ監査と更新

トラブルシューティング

一般的な問題

接続の問題:

エラー: AIエージェントがMCPサーバーに接続できない
解決策:
- APIキーが正しく、有効期限が切れていないことを確認する
  - ドメインURLにアクセス可能であることを確認する（リモートツールの場合はlocalhostではない）
  - ユーザー識別ヘッダーが含まれていることを確認する
  - 必要なツールに対するAPIキーの権限を確認する

認証エラー:

エラー: 「Unauthorized」または「User identification required」
解決策:
- すべてのリクエストにX-User-IdまたはX-User-Emailヘッダーを含める
  - ユーザーID/メールが組織内に存在することを確認する
  - 必要に応じてAPIキーを再生成する
  - APIキーに適切なツール権限があることを確認する

レート制限:

エラー: 「Rate limit exceeded」
解決策:
- MCPダッシュボードで現在の使用状況を確認する
  - APIキーのレート制限を調整する
  - より高い制限のためにプランのアップグレードを検討する
  - アプリケーションにリクエストスロットリングを実装する

ツール権限エラー:

エラー: 「Permission denied for tool X」
解決策:
- MCPダッシュボードでAPIキーの権限を編集する
  - プランに高度なツールへのアクセスが含まれていることを確認する
  - プラン固有の制限についてはサポートに連絡する

MCPサーバーのテスト

ヘルスチェック:

# Test server connectivity
curl https://www.knowsync.ai/api/mcp

# Expected response includes server info and available tools

ツールテスト:

# Test initialize method
curl -X POST https://www.knowsync.ai/api/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-User-Id: your_user_id" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
      "protocolVersion": "2024-11-05",
      "capabilities": {"tools": true},
      "clientInfo": {"name": "test-client", "version": "1.0.0"}
    }
  }'

将来のMCPツール

KnowSyncは2025年に予定されている追加のMCPツールを積極的に開発中です:

フェーズ1（2025年第1四半期）:

knowsync_summarize: ドキュメントのスマートな要約を生成
knowsync_bulk_operations: 複数のドキュメントに対する一括操作を実行
knowsync_compare: ドキュメントを比較して類似点と相違点を確認

フェーズ2（2025年第2四半期）:

knowsync_analytics: 使用状況の洞察とナレッジベース分析を取得
knowsync_quality_check: コンテンツ品質を分析して改善

完全な詳細については、MCPツールロードマップをご覧ください。

サポートの受け方

ドキュメント:

実際の例を含む完全なMCPテストガイド
すべてのツールのAPIリファレンスドキュメント
人気のAIプラットフォーム向け統合ガイド

サポートチャネル:

スターター/プロフェッショナル: MCP専門知識を持つメールサポート
エンタープライズ: 専任のMCP統合サポート
全プラン: コミュニティフォーラムとドキュメント

カスタム統合: エンタープライズ顧客は、カスタムMCPツール開発と高度な統合パターンについて当社チームと協力できます。

🚀 AIツールを接続する準備はできましたか？

MCPダッシュボードで最初のAPIキーを作成し、簡単な検索クエリで接続をテストすることから始めましょう。適切なチーム帰属のために、ユーザー識別ヘッダーを含めることを忘れないでください。