# Connapse

A self-hosted knowledge backend where your agent uploads documents and searches them with hybrid retrieval, so context survives between sessions.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed · ★ 21
- Author: Destrayon
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Destrayon/Connapse
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/connapse

## What it does

Connapse stores your files and hands them to the agent over MCP. You can upload into containers, or point it at S3 buckets and local directories you already have. The agent then creates containers, adds files and queries them on its own.

Search combines vector and keyword retrieval. Answers come back with citations to the source file. Alongside MCP there is a REST API and a separate `connapse` CLI. Everything runs in Docker, so the data stays on your machine.

You need Docker and Docker Compose, plus three environment variables: `CONNAPSE_ADMIN_EMAIL`, `CONNAPSE_ADMIN_PASSWORD` and `Identity__Jwt__Secret`. Skip them and the first start fails. Ollama is optional if you want local embeddings. The app comes up at `http://localhost:5001`.

## Requirements
- Needs: Docker

## Install

### Claude Code (native platform)

**Install**
- The MCP registry has no launch command for it: see the repository README

## When to use it
- keep agent context across separate sessions
- index a PDF and retrieve an answer from it
- hook an existing S3 bucket up to the agent
- get a reply that cites the original document
- create containers and fill them from inside the chat

## Example prompts
- Create a container called `research` and put `distributed-systems-notes.md` in it
- Search `research` for how to prevent cascading failures in microservices
- Show me the stats for `research`: document and chunk counts

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md