プロトタイプ · プレビュー版:公式レジストリのすべてのサーバーを掲載し、30分ごとに同期しています。Google でログインするとレビューを書けます。プロトタイプ · 30分ごとに更新
PopNx MCPAIを使う人のためのMCPサーバー · やさしい言葉で解説 ログイン

KnowDrive

✓ 提供元 · knowdrive.ai

作者:Recourse-Software-Incバージョン 0.1.8i★ 0iパソコンでもクラウドでも公式サイト ↗
レジストリ名ai.knowdrive/knowdrive-mcp

インストール方法

できること

Private, multimodal knowledge store for agents: hybrid search with cited, provenance-backed results.

作者による原文

  • 接続方法 パソコンでもクラウドでも
  • アカウントまたはキー クラウド:Authorization が必要 · ローカル:KNOWDRIVE_API_KEY が必要
  • カテゴリ 検索・AIの記憶

一緒に使える

この種の作業を AI に教える Skill。これと一緒に使えます

timesfm

TimesFM (Time Series Foundation Model) is a pretrained time-series foundation model developed by Google Research for time-series forecasting.

作者:google-research★ 35,6421 個の skill

Skill · 手順書

Shadowbroker

Open-source intelligence for the global theater. Track everything from the corporate/private jets of the wealthy, and spy satellites, to seismic events in one unified interface. Hook an AI agent up to have it parse through data and find previously unseen correlations. The knowledge is available to…

作者:BigBodyCobain★ 11,6081 個の skill

Skill · 手順書

google-maps-scraper

scrape data from Google Maps. Extracts data such as the name, address, phone number, website URL, rating, reviews number, latitude and longitude, reviews,email and more for each place

作者:gosom★ 8,2561 個の skill

Skill · 手順書

この順位の理由

これは「AI につながるアプリ」タブにあり、スターを使わず次の順で並びます

1. Claude のコネクタディレクトリにあるいいえ
2. チームが実際に試したいいえ
3. タイのユーザー向けいいえ
4. スターを除いた利用状況20/100人気 0 · 新しさ 12 · 応答中 8 · ユーザーのいいね +0
5. 登録日2026-11-10

ユーザーのいいね: 0 · 順位に最大 5 点(1 人 1 点)加算。お金では買えません。

品質: 基本チェック 5/5 項目に合格(表示のみ、並び順には不使用)

インストール

使っているAIアプリを選んで、設定をコピーしてください。

ひとことで AI にインストールしてもらう

KnowDrive をインストールして。https://mcp.popnx.com/i/knowdrive-mcp.md に従い、コマンドを見せて、私が OK するまで実行しないで。

パソコンで作業できる AI(Claude Code や Cursor など)に貼り付けます。手順を読み、コマンドを見せて、あなたの OK を待ちます。キー不要・登録不要。 · AI が読む全文を見る

チェック 5/5 合格 · 質問内容は提供元のサーバー(knowdrive.ai)を通ります · ✓ コマンド確認済み 2026年11月14日

まず:どの AI を使っていますか?

使っているアプリを選ぶと、下に手順が表示されます。

Claude につなげます · 約 5 分

KnowDrive のキーが必要です(提供元のサイトで作成) · claude.ai かデスクトップアプリで一度設定すれば、チャットで使えます · 無料アカウントは 1 つまで · Team/Enterprise はオーナー(Owner)が追加

  1. KnowDrive に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    KnowDrive のサイトを開く ↗

  2. Claude の Connectors ページを開く

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  3. 「Add」→「Custom」→「Web」を押し、この 2 つを入力

    ここからコピーして Claude の同じ名前の欄に貼り付け、Continue を押します

    Name · 名前KnowDrive
    Remote MCP server URL · アドレスhttps://knowdrive.ai/api/v1/mcp

    Request headers に、この名前と値を追加

    ヘッダー名Authorization
    値Bearer <ここにキーを貼り付け>

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

    Claude が検出したサインイン設定の画面で Continue を押す · Authentication は作者の説明どおり(Sign in now・Sign in when needed・No sign in)を選び Add を押します

  4. チャットで有効にする

    +ConnectorsKnowDrive

  5. 試してみる

    KnowDrive を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude が KnowDrive を使っていると言うか、回答に KnowDrive のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

ChatGPT はまだ KnowDrive につなげません

KnowDrive は接続時に自分のキーが必要ですが、OpenAI のヘルプページは OAuth ログインしか説明しておらず、確認できたキー入力方法がありません

代わりにできること

A · KnowDrive につなげるアプリを使う

  • KnowDrive のキーが必要です(提供元のサイトで作成) · claude.ai かデスクトップアプリで一度設定すれば、チャットで使えます · 無料アカウントは 1 つまで · Team/Enterprise はオーナー(Owner)が追加
  • KnowDrive のキーが必要です(提供元のサイトで作成)
  • KnowDrive のキーが必要です(提供元のサイトで作成)
  • KnowDrive のキーが必要です(提供元のサイトで作成)

B · 検索・AIの記憶 の中で ChatGPT につなげる別のサーバー

同じカテゴリでよく使われているものから、キーなしでアドレスだけでつなげるものを選びました

Claude Code につなげます · 約 5 分

KnowDrive のキーが必要です(提供元のサイトで作成)

  1. KnowDrive に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    KnowDrive のサイトを開く ↗

  2. ターミナルを開く

    Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く

  3. このコマンドを貼り付けて Enter

    claude mcp add --transport http --scope user knowdrive https://knowdrive.ai/api/v1/mcp --header 'Authorization: Bearer your-value'

    Enter の前に「your-value」を自分のキーに書き換えてください

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  4. Claude Code で /mcp と入力

    KnowDrive が一覧にあり、接続済みと表示されれば OK です

  5. 試してみる

    KnowDrive を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude Code が KnowDrive を使っていると言うか、回答に KnowDrive のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Cursor につなげます · 約 5 分

KnowDrive のキーが必要です(提供元のサイトで作成)

  1. KnowDrive に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    KnowDrive のサイトを開く ↗

  2. このボタンで Cursor を開く

    Cursor で開く

    Cursor がインストールの確認をするので Install を押します

  3. キーを入力

    KnowDrive の設定で Authorization が空です。自分のキーを入れて保存します

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  4. Cursor の AI チャットを Agent モードで開く

  5. 試してみる

    KnowDrive を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Cursor が KnowDrive を使っていると言うか、回答に KnowDrive のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

VS Code につなげます · 約 5 分

KnowDrive のキーが必要です(提供元のサイトで作成)

  1. KnowDrive に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    KnowDrive のサイトを開く ↗

  2. このボタンで VS Code を開く

    VS Code で開く

    VS Code がインストールの確認をするので Install を押します

  3. キーを入力

    KnowDrive の設定で Authorization が空です。自分のキーを入れて保存します

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  4. VS Code の AI チャットを Agent モードで開く

  5. 試してみる

    KnowDrive を使って、私に何ができるか教えて、1 つやってみせて

    ✓ VS Code が KnowDrive を使っていると言うか、回答に KnowDrive のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください

MCP を使えるアプリをすべて見る →

Web 経由でつなぐアプリ用のアドレス

アドレスhttps://knowdrive.ai/api/v1/mcp

JSON 設定は下の「開発者向け」にあります

つまずいたら?KnowDrive を使っている人に聞いてみましょう💬 ディスカッション →
開発者向け:ターミナルのコマンドと JSON 設定

Web 経由

Claude Code

claude mcp add --transport http --scope user knowdrive https://knowdrive.ai/api/v1/mcp --header 'Authorization: Bearer your-value'

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "knowdrive": {
      "url": "https://knowdrive.ai/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "knowdrive": {
      "type": "http",
      "url": "https://knowdrive.ai/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer your-value"
      }
    }
  }
}

パソコンにインストール

Claude Code

claude mcp add --scope user knowdrive --env KNOWDRIVE_API_KEY=your-value -- npx -y @knowdrive/mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "knowdrive": {
      "command": "npx",
      "args": [
        "-y",
        "@knowdrive/mcp"
      ],
      "env": {
        "KNOWDRIVE_API_KEY": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "knowdrive": {
      "command": "npx",
      "args": [
        "-y",
        "@knowdrive/mcp"
      ],
      "env": {
        "KNOWDRIVE_API_KEY": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "knowdrive": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@knowdrive/mcp"
      ],
      "env": {
        "KNOWDRIVE_API_KEY": "your-value"
      }
    }
  }
}

自分で入力する値

  • KNOWDRIVE_API_KEY 秘密 必須 env
    KnowDrive API キー(kd_…)。https://knowdrive.ai/developer-keys で発行するか、エージェントに自己登録させてください(https://knowdrive.ai/llms.txt を参照)。
    英語の原文を見るKnowDrive API key (kd_…). Mint one at https://knowdrive.ai/developer-keys, or let an agent onboard itself (see https://knowdrive.ai/llms.txt).
  • KNOWDRIVE_BASE_URL env
    接続先の KnowDrive デプロイメント。既定値は https://knowdrive.ai です。
    英語の原文を見るKnowDrive deployment to connect to. Defaults to https://knowdrive.ai.
  • Authorization 秘密 HTTP header
    Optional: set to 'Bearer ' for headless / API-key use. Interactive MCP clients may instead authenticate via the server's OAuth 2.0 (authorization-code) flow and omit this header.

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

ひと目でわかる

週あたりのダウンロードi
29/週
確認済みドメイン
✓ knowdrive.ai
接続方法
パソコンでもクラウドでも
最新バージョンi
0.1.8
レジストリ公開日i
2026年11月11日
コードの最終更新i
2026年11月11日
最終確認
2026年11月16日
作者
Recourse-Software-Inc
パッケージ
npm: @knowdrive/mcp
ウェブサイト
knowdrive.ai
レジストリでの状態
有効

使えるアプリ

このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。

インターネット経由でつなげるアプリ

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

パソコン上で動かせるアプリ

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

すべてのアプリと長所・短所 →

できること

このサーバーは、ツール一覧を表示する前にサインインを求めます。

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月20日にチェック

  • ✓ 合格

    作者とリポジトリが一致

    レジストリ名はドメイン knowdrive.ai で確認済みです(レジストリがドメインの所有を確認しています)

  • ✓ 合格

    今もメンテナンスされている

    コードの最終更新:9 日前

  • ✓ 合格

    ライセンスがある

    MITを使用

  • ✓ 合格

    エンドポイントが応答する

    387ミリ秒で応答(HTTP 401)

  • ✓ 合格

    OAuthでサインイン

    OAuthでのサインインに対応しているため、AIアプリがログイン画面へ案内してくれます

  • … 未チェック

    ツールの説明に隠れた指示がない

    まだチェックしていません。エンドポイントをチェックするときにツール一覧を読み取ります

公開済みの脆弱性(OSV.dev)

OSV.dev に @knowdrive/mcp@0.1.8 の登録はありません

このバージョンのパッケージ本体のみ確認。すべての依存関係ではありません · 確認日 2026年11月15日

確認していること → · JSON

作者の方へ:再確認の依頼・情報の誤りの報告
作者向け:README にバッジを付ける

作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/knowdrive-mcp.svg)](https://mcp.popnx.com/en/servers/knowdrive-mcp)

話し合い

質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。

まだ投稿はありません。最初の質問や共有をどうぞ。

ここの投稿は利用者によるもので、PopNx チームのものではありません。

ログインして投稿

ユーザーレビュー

まだレビューはありません

ログインしてレビューを書く

検索・AIの記憶のほかのサーバーとの比較i

  • このカテゴリのほかの6508件のうち0%よりスターが多い
  • このカテゴリのほかの6508件のうち81%より最近レジストリに公開
  • 基本チェックの結果が、このカテゴリのほかの6508件のうち99%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

KnowDriveは安全ですか?

当てはまる基本チェック5項目のうち5項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか?

入力が必要なもの:Authorization, KNOWDRIVE_API_KEY

パソコンで動きますか、それともクラウドですか?

どちらでも使えます。パソコンにインストールしても、クラウド版につないでもかまいません。

今もメンテナンスされていますか?

GitHubリポジトリの最終更新は9 日前、最新バージョン(0.1.8)がレジストリに届いたのは9 日前です。

どのアプリで使えますか?

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。URL で接続するので、リモート MCP を受け付けるアプリでも使えます。例:Web 版 ChatGPT(Business 以上はフル MCP、Pro は読み取りのみ)。

代わりに使えるものは?

同じカテゴリには:OpenSEO, Exa, Microsoft Learn MCP, Docs, COTAL actions (cotal.ai)

似た働きのほかの候補

同じカテゴリでほかの作者のもの。コマンドは確認済み。公式を先に、次にスター順。

カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i

OpenSEO

Keyword research, site audits, rank tracking and AI visibility for your AI agent.

作者:every-app広く使われている★ 2.8万6 日前更新

クラウドで動く✓ everyapp.com

Exa

Official Exa MCP for web search, content fetching, and multi-step research.

作者:exa-labs広く使われている★ 5245今日更新

クラウドで動く✓ 提供元 · exa.aiPopNx チームが実際に試用

Microsoft Learn MCP

Official Microsoft Learn MCP Server – real-time, trusted docs & code samples for AI and LLMs.

作者:MicrosoftDocs広く使われている★ 200212 か月前更新

クラウドで動く✓ 提供元 · microsoft.comPopNx チームが実際に試用

Docs

Search and read Empryo's documentation. Read-only, no auth, no local access.

作者:proxysoul成長中★ 16292 か月前更新

クラウドで動く✓ empryo.com
似たものと比べる
これ
KnowDrive
OpenSEOExaMicrosoft Learn MCPDocsCOTAL actions (cotal.ai)
動く場所クラウドでもパソコンにインストールでも使えるクラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要
キーが必要はいいいえいいえいいえいいえいいえ
Claude で + から追加いいえはいはいはいいいえいいえ
基本チェック5/55/52/44/44/44/4
ライセンスMITMITMITCC-BY-4.0NOASSERTIONApache-2.0
料金登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

KnowDrive MCP Server

A private, multimodal knowledge store for your agents. Drop in documents, images, recordings and video; your agent searches them over one MCP endpoint and gets back exact, cited fragments — source file, version, and byte range or timestamp — instead of re-reading whole files. Hybrid (vector + full-text) search, OAuth sign-in, free tier with no card at knowdrive.ai. Just add "check KnowDrive".

[Claude setup →](#claude-code-and-claudeai) — one command (Claude Code) or a connector paste (claude.ai) · Website · REST API (OpenAPI)

❌ Without KnowDrive

  • ❌ You paste the same docs, notes, and transcripts into every conversation — and pay for those tokens every time
  • ❌ The context window fills up long before your corpus ends
  • ❌ Your agent answers from year-old training data while the real answer sits in your files, meetings, and recordings

✅ With KnowDrive

Context7 gives agents public docs. Exa gives them the live web. KnowDrive gives them YOUR knowledge: private, multimodal, versioned, permissioned. Powered by the KnowDB knowledge engine, it ingests your files, text, audio, and images (URLs too, where enabled); extracts and chunks them into searchable atoms; and answers hybrid (vector + full-text) semantic search with a ranked window of just the relevant slices. Your corpus stays out of the conversation, so cost does not grow with corpus size. Just add check KnowDrive to your question (the Add-a-Rule tip below makes this automatic):

What did our Q3 planning doc say about pricing changes? check KnowDrive

Installation

The hosted server speaks streamable HTTP at `https://knowdrive.ai/api/v1/mcp`. First connect is a single browser OAuth prompt — no API key to copy, nothing to configure.

There are two ways in, and they reach the same hosted server:

Connect directly (recommended)npm bridge (@knowdrive/mcp)
ForAny client that speaks remote MCPstdio-only clients, headless, CI
AuthOne browser click (OAuth)KNOWDRIVE_API_KEY
SetupPaste a URL, or one commandnpx -y @knowdrive/mcp --install

Start with Connect directly — it's fewer steps and needs no key. Reach for the npm bridge when your client only speaks stdio, or when you're wiring this into CI where a browser sign-in isn't possible.

Claude Code and Claude.ai
claude mcp add --transport http knowdrive https://knowdrive.ai/api/v1/mcp

Remove it just as fast: claude mcp remove knowdrive. On claude.ai: Settings → Connectors → Add custom connector, paste the URL above, and complete the OAuth sign-in — KnowDrive runs as a claude.ai connector today. To uninstall, remove the connector from the same page.

Cursor & VS Code

Use the one-click badges at the top — the server URL is encoded in the link. Clients that support MCP OAuth will prompt a browser sign-in on first use. To uninstall, delete the knowdrive entry from your client's MCP server settings.

Other MCP clients

Most clients accept the standard mcpServers shape (shown exactly once — expand below for where it goes):

{

"mcpServers": { "knowdrive": { "type": "streamable-http", "url": "https://knowdrive.ai/api/v1/mcp" } } }

Client-specific config locations

ClientWhere the JSON goes
Cursor (manual)~/.cursor/mcp.json
VS Code (manual).vscode/mcp.json, or user-level via MCP: Open User Configuration
Windsurf~/.codeium/windsurf/mcp_config.json
Zedsettings.json → context_servers
Gemini CLI~/.gemini/settings.json → mcpServers
OpenCode~/.config/opencode/opencode.json
WarpSettings → AI → MCP Servers
LM StudioProgram → Install → Edit mcp.json

A note on transport spelling: "streamable-http" is the generic/registry spelling; Claude Code and VS Code spell the same transport "type": "http" (this repo's claude-plugin/.mcp.json uses that spelling for exactly this reason). Config locations drift between client versions — if a path above has moved, your client's MCP docs are authoritative. Removal is the mirror image everywhere: delete the knowdrive entry from the same config. For headless or CI use, add an Authorization: Bearer YOUR_API_KEY header instead of OAuth — see Authentication.

npm bridge (stdio / headless)

@knowdrive/mcp is a thin stdio↔HTTP bridge to the same hosted endpoint, for clients that don't speak remote MCP and for headless/CI use where a browser OAuth prompt isn't possible. It carries your API key and proxies every tool through — no tool logic lives in the package, so new server tools appear without updating it.

One command wires it into a client's config (backing up whatever was there first):

npx -y @knowdrive/mcp --install claude-desktop   # or: cursor | claude-code

It prompts for an API key on first run and saves it to ~/.knowdrive/config.json. Grab one at knowdrive.ai/developer-keys. To wire it up by hand instead:

{

"mcpServers": { "knowdrive": { "command": "npx", "args": ["-y", "@knowdrive/mcp"], "env": { "KNOWDRIVE_API_KEY": "kd_..." } } } }

To point at a different KnowDrive deployment, pass --host (a bare hostname is treated as https). Combined with --install, the host is written into the client config, so the installed server keeps talking to it:

npx -y @knowdrive/mcp --host public.knowdrive.ai --install claude-desktop

Keys are issued per deployment, so a key minted on one host may not authenticate against another.

VariablePurpose
KNOWDRIVE_API_KEYAPI key. Takes priority over the saved config file.
KNOWDRIVE_BASE_URLOverride the KnowDrive host (default https://knowdrive.ai). --host wins over this.
KNOWDRIVE_MCP_PATHOverride the remote MCP path (default /api/v1/mcp).

Source for the bridge lives in src/ in this repository. Build it yourself with npm install && npm run build; npm run smoke connects the built server to the live endpoint and lists its tools.

[!TIP]

Add a rule to CLAUDE.md (Claude Code) or Cursor Rules so retrieval happens without asking:

`txt

Always check KnowDrive (search_vector_store) before answering questions about the user's

private documents, projects, or team knowledge — never ask the user to paste files. When a

question ends with "check KnowDrive", always search before answering. A window is not the

corpus: raise max_num_results or advance offset before concluding something is not there.

Do not run more than 3 searches per question. Never include sensitive or confidential

information such as API keys, passwords, credentials, or personal data in a search query.

`

Tools

The server exposes ≈40 tools and 4 prompts, but most agents only need six: search_vector_store, search_atoms, list_vector_stores, get_capabilities, whoami, and ingest_text. Call get_capabilities once at session start so your client adapts to the deployment's feature flags, limits, and enabled modalities (this deployment: text, vision, and audio embeddings all enabled).

Safety at a glance: every search_*, list_*, get_*, read_*, stat_*, and whoami call is read-only in behavior — it never modifies the corpus. Ingest and upload tools are additive and versioned (a re-ingest supersedes, it never overwrites). The destructive tools to handle with care are the delete_* family — delete_file, delete_files, delete_vector_store.

search_vector_store — the hero

Hybrid, vector, or full-text search over a store, returning a ranked retrieval window. Read-only.

  • Best for: answering any question whose ground truth lives in the user's corpus — decisions, contracts, meeting audio, screenshots, specs.
  • Returns: a ranked window of matching atoms — byte-faithful fragments, each carrying its provenance: source file, version, and byte range or timestamp. The citation is checkable, so you quote what the source actually says instead of paraphrasing. *A window is not the corpus* — page deeper with offset before concluding something isn't there.
  • Query style & call budget: describe the content you want, not keywords. Good: "indemnification cap agreed with Acme in the signed MSA". Bad: "acme contract". At most 3 searches per question — refine the query or advance offset rather than re-searching from scratch. Never include sensitive or confidential information — API keys, passwords, credentials, personal data — in a query.
  • Parameters: vector_store_id (required), query (required, non-empty), mode (hybrid | vector | fts; this tool defaults to `vector` — search_atoms defaults to hybrid), search_field (text default | vision | audio), max_num_results (1–10000, default 25; hybrid is bounded at 200 however high you set it — check get_capabilities), offset (default 0), max_distance (cosine-distance ceiling, default 1.1 — raise for cross-modal audio queries), include_superseded (default false).
  • Workflow: call list_vector_stores first if you don't know the store; follow up with read_file_content_by_path when a snippet isn't enough.
ingest_text — get knowledge in

Index text straight into a store, versioned by path: re-ingesting the same path supersedes the prior version and mints version+1 (content-hash idempotent, blake3 digests). Additive, never overwrites.

  • Best for: capturing notes, decisions, transcripts, or generated docs as durable, searchable knowledge.
  • Returns: the queued file (pipeline phase pending); poll wait_for_file_status (≤45 s per wait) until indexed.
  • Parameters: vector_store_id, path (the file's identity within the store), and text — all required; the live tool schema is authoritative for optional fields.
  • Workflow: batch with bulk_ingest_text; upload real files with upload_file, or upload_create/upload_part/upload_complete for big files (1 MiB chunks). ingest_file_from_url pulls from the web where enabled (feature-flagged per deployment; off on this one).
The supporting heroes
  • `search_atoms` — the sibling search tool, at atom granularity. Best for: when search_vector_store isn't the right result shape — its live schema documents how the two differ. Returns: a ranked window of matching atoms; the same query-style, call-budget, and sensitive-data rules apply.
  • `list_vector_stores` — enumerate reachable stores. Best for: finding the right vector_store_id before the first search. Returns: the stores the caller is entitled to see (per-store ACLs apply), by id and name.
  • **get_capabilities*

冒頭だけを表示しています。続きはリポジトリで読めます