# Synaplan

Wires your agent into a self-hosted Synaplan workspace: semantic search over your documents, long-term memory, and chat.

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

## What it does

Synaplan is an open-source PHP/Symfony platform you run yourself. It gives you chat with any model, search across uploaded documents, and an embeddable widget. The MCP server exposes that to agents like Claude, Codex, and Cursor.

It speaks HTTP at `https://web.synaplan.com/mcp`. For Claude the whole setup is one line: `claude mcp add --transport http synaplan https://web.synaplan.com/mcp`. Cursor and GitHub Copilot take the same URL in their config files. To run your own instance, clone the repo and use `make up`, then open `http://localhost:5173`.

Nothing works until a Synaplan instance is up, so start the platform or point at the hosted one first. The demo mode covers 40 messages a day for 14 days with no API key; after that you bring your own provider key or a local Ollama model.

## Requirements
- Needs: Docker
- Remote server: `https://web.synaplan.com/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http synaplan https://web.synaplan.com/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add synaplan --url https://web.synaplan.com/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "synaplan": {
            "url": "https://web.synaplan.com/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "synaplan": {
            "type": "http",
            "url": "https://web.synaplan.com/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http synaplan https://web.synaplan.com/mcp
```

## When to use it
- pull the right passage out of uploaded docs by meaning, not keywords
- give an agent access to an internal knowledge base without shipping it out
- keep context alive across agent sessions
- compare what each model's answer actually cost
- stand up an AI workspace on your own server with one command

## Example prompts
- Search my documents for the refund policy and quote the relevant paragraph
- Remember that this project uses Symfony and PostgreSQL
- Ask Synaplan what the last answer cost

## Similar
- [agent-memory-systems](https://affpapa.org/en/nevibecode/skills/sickn33-agent-memory-systems.md) — skill · 2000 installs
- [supermemory](https://affpapa.org/en/nevibecode/skills/supermemory.md) — skill · 903 installs
- [memory-search](https://affpapa.org/en/nevibecode/skills/ruvnet-memory-search.md) — skill · 750 installs
- [langchain-orchestration](https://affpapa.org/en/nevibecode/skills/langchain-orchestration.md) — skill · 451 installs
- [memory-systems](https://affpapa.org/en/nevibecode/skills/memory-systems.md) — skill · 393 installs
- [memory-engineering](https://affpapa.org/en/nevibecode/skills/memory-engineering.md) — skill · 29 installs

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