Synaplan — Claude Code MCP server: RAG search and memory
Wires your agent into a self-hosted Synaplan workspace: semantic search over your documents, long-term memory, and chat.
claude mcp add --transport http synaplan https://web.synaplan.com/mcpWhat Synaplan 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.
What it helps with
- 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 for the agent
- 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
How to install Synaplan
Platform CLI: remote server
claude mcp add --transport http synaplan https://web.synaplan.com/mcpPlatform CLI: remote server
codex mcp add synaplan --url https://web.synaplan.com/mcpConfig file
{
"mcpServers": {
"synaplan": {
"url": "https://web.synaplan.com/mcp"
}
}
}Config file
{
"servers": {
"synaplan": {
"type": "http",
"url": "https://web.synaplan.com/mcp"
}
}
}Platform CLI: remote server
gemini mcp add -t http synaplan https://web.synaplan.com/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Synaplan
How do I install Synaplan in Claude Code?
Run claude mcp add --transport http synaplan https://web.synaplan.com/mcp. The server then shows up in Claude's MCP list.
What does Synaplan do?
It is a self-hosted AI workspace: chat across providers, semantic search over your files, long-term memory, and a site widget. The MCP server hands those to your agent.
Do I need an API key to use Synaplan?
The demo mode runs without a key at 40 messages a day for 14 days. After that, connect your own provider key or a local Ollama model.
