Prototipo · Versión preliminar: todos los servidores del registro oficial, sincronizados cada 30 minutos. Inicia sesión con Google para escribir reseñas.Prototipo · se actualiza cada 30 min
PopNx MCPServidores MCP para quienes usan IA · en palabras sencillas Iniciar sesión

KnowDrive

✓ del servicio · knowdrive.ai

de Recourse-Software-Incversión 0.1.8i★ 0iComputadora o nubeSitio oficial ↗
Nombre en el registroai.knowdrive/knowdrive-mcp

Cómo instalar

Qué hace

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

Texto original del autor

  • Conexión Computadora o nube
  • Cuenta o clave Nube: Necesita Authorization · Local: Necesita KNOWDRIVE_API_KEY
  • Categoría Búsqueda y memoria de IA

Úsalo junto con

Skills que enseñan a la IA este tipo de trabajo; funcionan junto a este

timesfm

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

de google-research★ 35.6421 skills

Skill · Guía de trabajo

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…

de BigBodyCobain★ 11.6081 skills

Skill · Guía de trabajo

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

de gosom★ 82561 skills

Skill · Guía de trabajo

Por qué está en este puesto

Está en la pestaña “Apps que se conectan a la IA”, que se ordena sin estrellas, en este orden

1. En el directorio de conectores de ClaudeNo
2. Probado por nuestro equipoNo
3. Útil para usuarios de TailandiaNo
4. Uso sin estrellas20/100Popularidad 0 · Actualidad 12 · Sigue respondiendo 8 · Me gusta de usuarios +0
5. Registrado el2026-11-10

Me gusta de usuarios: 0 · Suma como máximo 5 puntos (1 por persona). No se puede comprar.

Calidad: Pasó 5/5 revisiones básicas (se muestra, no ordena)

Instalación

Elige la app de IA que usas y copia la configuración.

Que tu IA lo instale con una frase

Instala KnowDrive. Sigue https://mcp.popnx.com/i/knowdrive-mcp.md, enséñame los comandos y espera mi OK antes de ejecutarlos.

Pégala en una IA que trabaje en tu equipo (como Claude Code o Cursor). Lee nuestros pasos, te muestra los comandos y espera tu OK. Sin clave ni registro. · Ver el texto completo que lee tu IA

Pasó 5/5 revisiones · Lo que preguntas pasa por el servidor del autor (knowdrive.ai) · ✓ Comandos revisados el 14 nov 2026

Primero: ¿qué IA usas?

Elige tu app y los pasos aparecen abajo.

Funciona con Claude · unos 5 min

Necesitas una clave de KnowDrive (créala en el sitio del autor) · Configúralo una vez en claude.ai o en la app de escritorio y úsalo en el chat · las cuentas gratis pueden añadir 1 · en Team/Enterprise lo añade un Owner

  1. Regístrate y crea una clave de KnowDrive

    Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.

    Abrir el sitio de KnowDrive ↗

  2. Abre la página Connectors de Claude

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  3. Pulsa “Add” → “Custom” → “Web” y completa estos 2 campos

    Copia cada valor al campo con el mismo nombre en Claude y pulsa Continue

    Name · NombreKnowDrive
    Remote MCP server URL · Direcciónhttps://knowdrive.ai/api/v1/mcp

    En Request headers, añade este nombre y valor

    Nombre del headerAuthorization
    ValorBearer <pega tu clave aquí>

    Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie

    Pulsa Continue en la pantalla de inicio de sesión que detectó Claude · en Authentication elige lo que indique el autor (Sign in now, Sign in when needed o No sign in) y pulsa Add

  4. Actívalo en un chat

    +ConnectorsKnowDrive

  5. Pruébalo

    Usa KnowDrive y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude dice que está usando KnowDrive o muestra una herramienta de KnowDrive en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

ChatGPT todavía no puede conectar KnowDrive

KnowDrive necesita tu propia clave para conectarse, pero la ayuda de OpenAI solo describe el inicio de sesión con OAuth; no hay una opción de clave que hayamos podido verificar

Lo que puedes hacer en su lugar

A · Usa una app que pueda conectar KnowDrive

  • Necesitas una clave de KnowDrive (créala en el sitio del autor) · Configúralo una vez en claude.ai o en la app de escritorio y úsalo en el chat · las cuentas gratis pueden añadir 1 · en Team/Enterprise lo añade un Owner
  • Necesitas una clave de KnowDrive (créala en el sitio del autor)
  • Necesitas una clave de KnowDrive (créala en el sitio del autor)
  • Necesitas una clave de KnowDrive (créala en el sitio del autor)

B · Otros en Búsqueda y memoria de IA que funcionan con ChatGPT

Elegidos entre los más usados de la misma categoría, solo los que se conectan con una dirección y sin clave

Funciona con Claude Code · unos 5 min

Necesitas una clave de KnowDrive (créala en el sitio del autor)

  1. Regístrate y crea una clave de KnowDrive

    Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.

    Abrir el sitio de KnowDrive ↗

  2. Abre la Terminal

    Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell

  3. Pega este comando y pulsa Enter

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

    Cambia “your-value” por tu clave antes de pulsar Enter

    Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie

  4. Escribe /mcp en Claude Code

    Deberías ver KnowDrive en la lista como conectado

  5. Pruébalo

    Usa KnowDrive y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude Code dice que está usando KnowDrive o muestra una herramienta de KnowDrive en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con Cursor · unos 5 min

Necesitas una clave de KnowDrive (créala en el sitio del autor)

  1. Regístrate y crea una clave de KnowDrive

    Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.

    Abrir el sitio de KnowDrive ↗

  2. Pulsa este botón para abrir Cursor

    Abrir en Cursor

    Cursor te pedirá confirmar; pulsa Install

  3. Escribe tu clave

    En la configuración de KnowDrive, Authorization está vacío; añade tu clave y guarda

    Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie

  4. Abre el chat de IA de Cursor en modo Agent

  5. Pruébalo

    Usa KnowDrive y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Cursor dice que está usando KnowDrive o muestra una herramienta de KnowDrive en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con VS Code · unos 5 min

Necesitas una clave de KnowDrive (créala en el sitio del autor)

  1. Regístrate y crea una clave de KnowDrive

    Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.

    Abrir el sitio de KnowDrive ↗

  2. Pulsa este botón para abrir VS Code

    Abrir en VS Code

    VS Code te pedirá confirmar; pulsa Install

  3. Escribe tu clave

    En la configuración de KnowDrive, Authorization está vacío; añade tu clave y guarda

    Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie

  4. Abre el chat de IA de VS Code en modo Agent

  5. Pruébalo

    Usa KnowDrive y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si VS Code dice que está usando KnowDrive o muestra una herramienta de KnowDrive en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps

Ver todas las apps que usan MCP →

Dirección para apps que se conectan por la web

Direcciónhttps://knowdrive.ai/api/v1/mcp

La configuración JSON está en “Para desarrolladores”, abajo

¿Te atascaste? Pregunta a quien usa KnowDrive💬 Conversación →
Para desarrolladores: comandos de Terminal y configuración JSON

Por la 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"
      }
    }
  }
}

Instalado en tu computadora

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

Valores que debes completar

  • KNOWDRIVE_API_KEY secreto obligatorio env
    Clave de API de KnowDrive (kd_…). Genérela en https://knowdrive.ai/developer-keys o deje que un agente se registre por sí mismo (consulte https://knowdrive.ai/llms.txt).
    Ver original en inglésKnowDrive 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
    Despliegue de KnowDrive al que conectarse. El valor predeterminado es https://knowdrive.ai.
    Ver original en inglésKnowDrive deployment to connect to. Defaults to https://knowdrive.ai.
  • Authorization secreto 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.

Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.

Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.

De un vistazo

Descargas por semanai
29/sem
Dominio verificado
✓ knowdrive.ai
Conexión
Computadora o nube
Transporte
stdio, streamable-http
Última versióni
0.1.8
Publicado en el registroi
11 nov 2026
Último cambio de códigoi
11 nov 2026
Última revisión
16 nov 2026
Creador
Recourse-Software-Inc
Paquetes
npm: @knowdrive/mcp
Sitio web
knowdrive.ai
Estado en el registro
Activo

Qué apps pueden usarlo

Según cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.

Se conectan por internet en

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

Se ejecutan en tu computadora en

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

Todas las apps, con ventajas y desventajas →

Qué puede hacer

El servidor pide iniciar sesión antes de mostrar sus herramientas.

Revisiones básicasi

Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 20 nov 2026

  • ✓ Superada

    El creador coincide con el repo

    El nombre en el registro se verificó con el dominio knowdrive.ai (el registro comprueba quién es dueño del dominio)

  • ✓ Superada

    Sigue en mantenimiento

    Último cambio de código: hace 9 días

  • ✓ Superada

    Tiene licencia

    Usa MIT

  • ✓ Superada

    El endpoint responde

    Respondió en 387 ms (HTTP 401)

  • ✓ Superada

    Inicio de sesión con OAuth

    Declara inicio de sesión con OAuth, así que tu app de IA puede llevarte a iniciar sesión

  • … Aún sin revisar

    Sin instrucciones ocultas en las descripciones de herramientas

    Aún sin revisar; leemos la lista de herramientas cuando revisamos el endpoint

Vulnerabilidades publicadas (OSV.dev)

Sin entradas en OSV.dev para @knowdrive/mcp@0.1.8

Solo revisa esta versión del paquete, no todas sus dependencias · revisado 15 nov 2026

Qué revisamos → · JSON

Creadores: pedir otra revisión o avisar de un dato erróneo
Para autores: añade una insignia a tu README

Si lo creaste tú, pega este código en tu README. La insignia enlaza a esta página.

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

Conversación

Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.

Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.

Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.

Inicia sesión para publicar

Reseñas de usuarios

Aún no hay reseñas

Inicia sesión para escribir una reseña

Comparado con otros en Búsqueda y memoria de IAi

  • Más estrellas que el 0% de los otros 6508 servidores de esta categoría
  • Publicado en el registro más recientemente que el 81% de los otros 6508 servidores de esta categoría
  • Revisiones básicas iguales o mejores que el 99% de los otros 6508 servidores de esta categoría

Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.

Preguntas frecuentes

¿Es seguro KnowDrive?

Superó 5 de 5 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.

¿Qué claves o códigos necesita?

Debes completar: Authorization, KNOWDRIVE_API_KEY

¿Se ejecuta en mi computadora o en la nube?

Funciona de las dos formas: instálalo en tu computadora o conéctate a la versión en la nube.

¿Sigue en mantenimiento?

El repo de GitHub cambió por última vez hace 9 días, y la última versión (0.1.8) llegó al registro hace 9 días.

¿Qué apps pueden usarlo?

Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. Se conecta por URL, así que también sirve en apps que aceptan MCP remoto, como ChatGPT en la web (MCP completo en Business y superiores; Pro solo lectura).

¿Qué puedo usar en su lugar?

En la misma categoría: OpenSEO, Exa, Microsoft Learn MCP, Docs, COTAL actions (cotal.ai)

Alternativas parecidas

Misma categoría, otros creadores, comandos ya revisados. Primero los oficiales, luego por estrellas.

Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi

OpenSEO

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

de every-appMuy usado★ 28,4 milActualizado hace 6 días

Se ejecuta en la nube✓ everyapp.com

Exa

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

de exa-labsMuy usado★ 5,2 milActualizado hoy

Se ejecuta en la nube✓ del servicio · exa.aiProbado por el equipo de PopNx

Microsoft Learn MCP

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

de MicrosoftDocsMuy usado★ 2 milActualizado hace 12 meses

Se ejecuta en la nube✓ del servicio · microsoft.comProbado por el equipo de PopNx

Docs

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

de proxysoulEn crecimiento★ 1,6 milActualizado hace 2 meses

Se ejecuta en la nube✓ empryo.com

COTAL actions (cotal.ai)

cotal.ai actions: product overview, site search, build log, feedback, Cloud waitlist, updates, calls

de Cotal-AIEn crecimiento★ 403Actualizado hace 2 meses

Se ejecuta en la nube✓ del servicio · cotal.ai
Comparado con otros parecidos
Este
KnowDrive
OpenSEOExaMicrosoft Learn MCPDocsCOTAL actions (cotal.ai)
Dónde se ejecutaEn la nube o instalado en tu equipoFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nada
Necesita claveSíNoNoNoNoNo
Se añade con + en ClaudeNoSíSíSíNoNo
Revisiones básicas5/55/52/44/44/44/4
LicenciaMITMITMITCC-BY-4.0NOASSERTIONApache-2.0
PrecioSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registro

README del creador

Abrir el README

Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.

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*

Solo se muestra el principio; lee el resto en el repo