Connect Claude Code to trovex
Paste one prompt into Claude Code. It detects your handle from
git config, registers the MCP, and you're done — your agents can
then trovex_search the shared store and trovex_write to it.
Connect the MCP required
Pick your coding agent. trovex speaks the Model Context Protocol over HTTP, so any MCP client connects to the /mcp/ endpoint with one config entry — no filesystem changes, no shell scripts, no sudo.
1Set up the trovex MCP on this machine.231. Read my ~/.claude/settings.json (preserve everything else).42. Detect my handle: run `git config user.email`. Take the part before5 the @. If empty or weird, ask me. Confirm with me ([Y/n]) before6 proceeding.73. Add this entry to mcpServers (merge, don't replace siblings):89 "trovex": {10 "type": "http",11 "url": "http://localhost:8765/mcp/",12 "headers": { "X-TROVEX-User": "<my-handle>" }13 }14154. Tell me to restart Claude Code so the MCP loads. Then these tools16 are available: `trovex_search(query)` → relevant passages, `trovex_read`,17 and `trovex_write(content, kind, tags)` to store records into the shared store.185. To also WRITE to the store, add an "X-TROVEX-Write-Token" header (the19 shared token from your admin) next to X-TROVEX-User, then restart.
Prefer the CLI / manual edit?
one-liner — replace <handle>
1claude mcp add --transport http trovex \2 http://localhost:8765/mcp/ \3 --header "X-TROVEX-User: <handle>"
~/.cursor/mcp.json · replace <handle> · restart Cursor
1{2 "mcpServers": {3 "trovex": {4 "url": "http://localhost:8765/mcp/",5 "headers": { "X-TROVEX-User": "<handle>" }6 }7 }8}
~/.codeium/windsurf/mcp_config.json · then quit & reopen Windsurf
1{2 "mcpServers": {3 "trovex": {4 "serverUrl": "http://localhost:8765/mcp/",5 "headers": { "X-TROVEX-User": "<handle>" }6 }7 }8}
Windsurf uses serverUrl (not url) for remote HTTP servers.
settings.json under context_servers · restart Zed
1{2 "context_servers": {3 "trovex": {4 "source": "custom",5 "url": "http://localhost:8765/mcp/",6 "headers": { "X-TROVEX-User": "<handle>" }7 }8 }9}
Any MCP client works — point it at the same HTTP endpoint and send the X-TROVEX-User header.
trovex_search/trovex_read work as-is. To trovex_write/trovex_tag/trovex_delete, add a header "X-TROVEX-Write-Token": "<shared-token>" next to X-TROVEX-User (ask your admin for the token). In the web UI, paste it once on /settings.settings.json and restart. Zero residue.
Write-guard hook
optional
recommended
A PreToolUse hook that blocks writing a .md to disk and
redirects it to trovex_write — so records land in the shared
store, not scattered across repos. .trovexignore exempts
files that must stay on disk; degrades to allow if trovex is unreachable.
Write-guard hook optional recommended
A PreToolUse hook that blocks writing a .md to disk and
redirects it to trovex_write — so records land in the shared
store, not scattered across repos. .trovexignore exempts
files that must stay on disk; degrades to allow if trovex is unreachable.
1Install the trovex write-guard hook.231. Create ~/.claude/hooks/trovex-md-guard.sh with the content fetched from4 http://localhost:8765/hooks/trovex-md-guard.sh52. chmod +x it.63. Read ~/.claude/settings.json and add this to hooks.PreToolUse7 (merge — don't overwrite existing entries):89 {10 "matcher": "Write|Edit|MultiEdit",11 "hooks": [{12 "type": "command",13 "command": "/home/<me>/.claude/hooks/trovex-md-guard.sh"14 }]15 }16174. Replace <me> with $HOME's basename. Add a .trovexignore at your repo18 root for files that must stay on disk. Then tell me to restart.
LLM rerank
BYOK
quality boost
Bring your own OpenAI key. trovex fetches the top-20 from vector search,
then asks gpt-5.4-mini to pick the best 5. Improves top-1
reliability on ambiguous queries.
cost
~$0.0017 / query
budget
~$5 / month at 100 q/d
paid by
your key, your bill
LLM rerank BYOK quality boost
Bring your own OpenAI key. trovex fetches the top-20 from vector search,
then asks gpt-5.4-mini to pick the best 5. Improves top-1
reliability on ambiguous queries.
1Enable LLM reranking for trovex.231. Ask me for my OpenAI API key (starts with sk-). Do NOT proceed until4 I provide it. Treat the value as a secret — never echo it back to me5 in chat after the initial confirmation.62. Read my ~/.claude/settings.json and locate the existing "trovex" entry7 under mcpServers.83. Add the key as an additional header (merge, don't replace existing):910 "trovex": {11 "type": "http",12 "url": "http://localhost:8765/mcp/",13 "headers": {14 "X-TROVEX-User": "<my-existing-handle>",15 "X-TROVEX-OpenAI-Key": "<my-sk-key>"16 }17 }18194. Tell me to restart Claude Code. After restart, trovex() calls will be20 reranked by gpt-5.4-mini. Verify by checking21 http://localhost:8765/insights — my queries will be flagged22 as reranked.
X-TROVEX-Rerank-Model if you want cheaper or stronger.Verify it works
After restarting Claude Code, run this — you should get a relevant
passage with its title > heading breadcrumb.
1Call trovex_search with query="auth JWT" and show me the raw output.