Kollektiv | Your private LLM knowledgebase

コレクティヴMCP

🧠 あなた専用のLLM知識ベース

Kollektiv MCPを使えば、わずか数秒でパーソナルLLMナレッジベースを構築し、お気に入りのエディタやクライアントから利用できます。インフラのセットアップ、チャンク化、同期は不要。データをアップロードしてチャットを開始するだけです。Cursor、Windsurf、Claude Desktopなど、主要なMCPクライアントをすべて標準サポートしています。

🧪 Kollektiv は初期ベータ版です。MCP クライアントへの接続で問題が発生した場合は、まず以下の手順をお試しください。それでも問題が解決しない場合は、こちらで問題を報告してください。

💿 接続

Kollektiv MCPに接続する最も簡単な方法は、以下の設定をエディターのmcp.jsonファイルにコピー＆ペーストすることです。すべてのクライアント（Cursor、Windsurf、Claude Desktop、VSCode、PyCharm）がこのjson形式をサポートしています。

• 名前：
  • kollektiv - サーバーにわかりやすい名前を付けることができます
• 指示：
  • npx - このコマンドを実行する前にnode.jsがインストールされていることを確認してください
• 引数:
  • -y - これにより、シェルがリモートサーバーに接続するために必要なmcp-remoteをインストールできるようになります。
  • mcp-remote - これにより、クライアントはリモート MCP サーバー (この場合は Kollektiv) に接続できるようになります。
  • https://mcp.thekollektiv.ai/mcp - 接続先のエンドポイントです

以下の短いデモをご覧いただくか、クライアント固有の手順をお読みください。

カーソル

Cursorを開き、 Cursor Settings > MCP > Add new global MCP Serverに進みます。上記の設定を貼り付けて保存します（Ctrl/Cmd+S）。

構成が成功し、以前に認証したことがない場合は、ログイン ページに誘導するブラウザ ウィンドウが開きます。

json保存した後、CursorがMCPに接続するまでしばらく時間がかかる場合があります。Cursorを再起動するか、少し時間を置く必要があるかもしれません。「クライアントが閉じられています」などのエラーが表示される場合は、以下のトラブルシューティング手順を実行すると解決する可能性があります。

接続が成功すると、設定ページで Kollektiv MCP が緑色に変わります。

ウィンドサーフィン

Windsurfを開き、 Settings -> Windsurf Settings > MCP Servers > View raw configに進みます。上記の設定を貼り付けて保存します（Ctrl/Cmd+S）。

構成が成功し、以前に認証したことがない場合は、ログイン ページに誘導するブラウザ ウィンドウが開きます。

💡Windsurfは他のクライアントとは異なり、私の経験では、正しく接続するにはアプリの再起動が必要です。しばらく経ってもサーバーが「緑色」にならない場合は、以下のトラブルシューティング手順をお試しください。

接続が成功すると、設定ページで Kollektiv MCP が緑色に変わります。

デスクトップ版クロード

Claude Desktopを開き、 Settings -> Developer > Edit configに進みます。任意のテキスト/コードエディターでjsonファイルを開き、上記の設定を貼り付けて保存します（Ctrl/Cmd+S）。

構成が成功し、以前に認証したことがない場合は、ログイン ページに誘導するブラウザ ウィンドウが開きます。

💡Claude for Desktop を正しく接続するには、アプリの再起動が必要です。しばらくしてもサーバーが緑色にならない場合は、以下のトラブルシューティング手順をお試しください。

接続が成功すると、設定ページで Kollektiv MCP が緑色に変わります。

VSコード

VS Code を開き、 Settings -> MCP: Add server > Command (stdio)に移動します。

• 指示：
  • npx -y mcp-remote https://mcp.thekollektiv.ai/mcp
• 名前：
  • サーバーにkollektivなどのわかりやすい名前を付けます

構成のsettings.jsonは次のようになります。

次のステップ:

• 開始をクリックしてMCPサーバーに接続します
  • 認証されていない場合は認証ページに移動します
• settings.jsonに"chat.mcp.enabled": true,追加することを忘れないでください。
• エージェントモードに切り替える

💡VS CodeでMCPを使用するには、サーバーを手動で起動し、 chat.mcp.enabledを追加してエージェントモードに切り替える必要があります。エージェントモードでMCPツールが表示されない場合は、以下のトラブルシューティング手順をお試しください。

接続が成功すると、Kollektiv MCP によって公開されたツールが表示されます。

クライン

Cline を開き、 MCP Servers > Edit Configurationをクリックして、次の構成をcline_mcp_settings.jsonに追加します。

注意: 認証をサポートするリモート サーバーへの直接接続は、Cline ではまだサポートされていません。

接続に成功すると、認証フローに進みます。ログイン後、Cline で Kollektiv MCP が有効になっていることを確認できます。

その他 (PyCharm、Claude Code)

ほとんどの MCP クライアントは同じ.json形式に従っており、前述のクライアントと同様の構成手順で動作するはずです。

1. 設定をコピーしてクライアントのjson設定に貼り付けます
2. アプリを再起動してください
3. まだ認証していない場合は認証してください
4. Kollektiv MCP は緑色になり、チャット/エージェントモードで利用可能になるはずです

接続が成功するかどうかは、次のようなさまざまな要因によって決まります。

• 特定のクライアントの強力な開発者がMCP接続をサポートしたいと考えているかどうか
• クライアントがOAuthをサポートする最新のMCP仕様をサポートしているかどうか

問題が発生している場合は、次の簡単なトラブルシューティング手順を実行すると役立つ場合があります。

サポートされているクライアント

次の MCP クライアントへの接続が機能することを検証しました。

• カーソル✅
• ウィンドサーフィン✅
• クロードデスクトップ✅
• VSコード✅
• クライン ✅

他のMCPクライアントも理論上はサポートされるはずですが、実際には状況が多少異なる可能性があります。どうしても接続したいクライアントがございましたら、お知らせください。

🎮 使用方法

利用可能なツール

• /query_documents — Kollektiv にアップロードしたドキュメントに質問を送信し、ドキュメントのソースに基づいて回答を受け取ります。
• /list_documents — 基本的なメタデータとともに同期されたドキュメントのリストを返します。
• **プロのヒント:**クライアントがこれらのツールを呼び出すことがわかるように、 「Kollektiv MCP を使用する」というフレーズを含めます。

使用上のヒント

• 常に「use Kollektiv MCP」を追加します。これにより、クライアントに使用する MCP サーバーが指示されます。
• ドキュメントが利用可能になるまで待機します- アップロード後、ドキュメントを照会できるようになるまでに 1 ～ 2 分かかります。
• 必要に応じてクエリを言い換える— クライアントが不適切なクエリを生成した場合は、自分で編集または書き直します。

❓ トラブルシューティングとサポート

このMCPサーバーは、Cloudflare Agents SDKをはじめとするライブラリを使用して、ユーザーがMCPサーバーに接続して利用するための最新の方法を提供しています。一方、MCPクライアントでは、以下の2つの重要な機能のサポートがまだ実装されていません。

• リモートMCPサーバー
• MCPサーバーの認証

接続の問題が発生した場合は、次のトラブルシューティング手順に従ってください。MCP サーバーに接続できるようになります。

サポート

追加のサポートが必要な場合は、GitHub の問題を開くか、 support@thekollektiv.aiまでご連絡ください。

接続のトラブルシューティング

以下のような無効な認証リクエストエラーが発生する場合、または別の理由で接続できない場合は、以下の手順を試して問題を解決してください。

1. 正しいエンドポイントに接続していることを確認してください:
   • MCP エンドポイントとしてhttps://mcp.thekollektiv.ai/mcp使用します。
2. mcp-remote キャッシュを消去します:
   • これが何をするか:
     • リモート接続をサポートしていないクライアントからリモートサーバーに接続するために使用されるmcp-remoteライブラリのキャッシュを削除します。
   • どうやって：
     • ターミナルで次のコマンドを実行します

3. ブラウザのデータとCookieを消去します:
   • これが何をするか:
     • Kollektiv にログインするときに認証情報を保存するために使用されるブラウザ クッキーを削除します。
   • どうやって：
     • ブラウザの設定を開き、過去数時間の閲覧データを削除します

⚠️ 注意：これにより、Kollektivを含むすべてのアクティブなセッションからサインアウトされます。ログインフローがうまくいかない場合にのみ、この操作を行ってください。

4. MCP クライアントを再起動し、MCP サーバーに再接続してみます。
   • これが何をするか:
     • MCP クライアント (Cursor、Windsurf など) は、以前の実行からの接続/構成設定をキャッシュすることが多く、それが認証に干渉する可能性があります。
   • どうやって：
     • エディター/クライアントを再起動します
     • MCPサーバーに再接続してみてください

MCPインスペクターの使用

デバッグの目的で、MCP インスペクターを使用して Kollektiv MCP サーバーに接続できます。

SSEまたはストリーミング可能なHTTPトランスポートを選択します

• SSE: https://mcp.thekollektiv.ai/sseでサーバーに接続します。
• ストリーミング可能な HTTP: https://mcp.thekollektiv.ai/mcpでサーバーに接続します。

🛠️ 実装の詳細（🤓用）

Kollektiv についてのみ知りたい場合は、このセクションは飛ばしてください。このセクションは、Kollektiv の仕組みに興味のある開発者やビルダー向けです。

Kollektiv MCP はモジュラー システムの一部であり、ユーザーはインフラストラクチャ、パイプライン、またはモデル構成を管理する必要なく、数秒でデータに対して RAG をセットアップできます。

これは、独立して展開された 3 つのサービスで構成されています。

• MCP サーバー (Cloudflare ワーカー)
  https://mcp.thekollektiv.ai
  モデルコンテキストプロトコルを介してインデックス化されたデータとやり取りするクライアントのための安全なゲートウェイとして機能します。OAuth をサポートします。
• フロントエンド（React + Vite Worker）
  https://thekollektiv.ai
  コンテンツをアップロードおよび管理するための、シンプルで最小限のユーザー インターフェース。
• バックエンド（FastAPI）
  https://api.thekollektiv.ai
  RAG パイプラインのソースの取り込み、検証、オーケストレーションを処理します。

🔐 セキュリティ

Kollektiv MCP は、いくつかのセキュリティ対策を実装しています。

• サインインは、Supabase が提供する標準のOAuth 2.1「認証コード」フローを介して行われます。短命のHttpOnly``Secureクッキーのみが保存され、パスワードがこのサーバーにアクセスすることはありません。
• すべてのトラフィックは、 Cloudflare のエッジを通じて HTTPS 経由でのみ提供され、すべての機密 POST リクエストには 1 回限りの CSRF/トランザクション トークンが含まれます。
• バックエンドはCloudflare Workers サンドボックス内で実行されるため (ローカル ファイル システムや長時間実行されるプロセスはありません)、攻撃対象領域が大幅に削減されます。詳細な開示ガイドラインについては、 SECURITY.md を参照してください。

🪪 ライセンス

Apache License 2.0 に基づいてリリースされています — 商用サポートまたは代替ライセンスについては、 azuev@outlook.com までお問い合わせください。