Connect / Claude Code

Connect

Connect Dexi to Claude Code

MCP server · https://mcp.dexi.net/mcp

Claude Code is Anthropic’s agentic coding tool — a CLI that also runs inside VS Code and JetBrains. Connected to Dexi, it can pull up your architecture notes mid-task, save decisions as you make them, and search a year of reading without you leaving the terminal.

What you need

  1. Claude Code installed and signed in.
  2. A Dexi account — free at app.dexi.net.

Setup

Option 1 — the Dexi plugin (recommended)

The plugin registers the MCP server and ships a skill that teaches Claude Dexi’s conventions (meaning-based search, #hashtags, @mentions, [[wiki links]]). Inside Claude Code, run:

  1. /plugin marketplace add turbo-labs/dexi-claude
  2. /plugin install dexi@dexi-claude

Option 2 — register the server directly

In a terminal:

  1. claude mcp add --transport http dexi https://mcp.dexi.net/mcp
  2. Add --scope user to make it available in every project instead of just the current one.

Authenticate

  1. Inside Claude Code, type /mcp and pick dexi.
  2. Your browser opens Dexi’s approval page — sign in and approve. Done.

Try it

Try: “Search my Dexi notes for how we decided to handle auth tokens” — or “save a note to Dexi: we chose Postgres over Redis for the queue, tagged #architecture.”

Troubleshooting

/mcp says dexi needs authentication

That’s the normal first-run state — select it and complete the browser sign-in. Tokens refresh automatically afterwards.

The server is missing in other projects

A plain claude mcp add registers the server for the current project only. Re-add it with --scope user, or use the plugin, which applies everywhere.

Disconnecting

In the Dexi app, open Settings → Connected apps to see every app connected to your account and disconnect any of them instantly. Revoking access there signs Claude Codeout of your notes no matter what’s configured on the client side.

Frequently asked questions

What does the plugin add over claude mcp add?

Both register the same MCP server. The plugin additionally ships a skill that teaches Claude how to use Dexi well — when to search by meaning vs keyword, how Dexi’s #hashtag and [[wiki link]] conventions work, and to check your existing tags before inventing new ones.

How do I remove it?

Plugin: /plugin uninstall dexi. Direct registration: claude mcp remove dexi. To revoke access server-side, use Settings → Connected apps in Dexi.

Does it work in headless or CI runs?

The OAuth sign-in needs a browser once per machine. After that, stored credentials refresh automatically, including in non-interactive runs.

Other clients

Dexi works with any MCP client that supports streamable HTTP with OAuth — see the overview, or jump to a guide: Claude, ChatGPT, Goose, Cursor, VS Code.

Questions?

Email team@dexi.net — see also Support and our Privacy Policy.