Guide

Connect your AI assistant to Turbodoc

Turbodoc exposes your entire library — bookmarks, notes, code snippets, and diagrams — through a hosted MCP (Model Context Protocol) server. This guide walks through setup for each major client.

Before you start

You need a free Turbodoc account — sign up here. That's it. Authentication happens through OAuth 2.0: the first time your client connects, a browser window opens where you sign in and approve access. There are no API keys.

The server endpoint for every client is:

https://api.turbodoc.ai/mcp

Claude (web and desktop)

  1. Open Settings → Connectors.
  2. Click Add custom connector.
  3. Name it Turbodoc and paste the endpoint URL above.
  4. Click connect and sign in with your Turbodoc account when prompted.

Turbodoc tools then appear in Claude's tool menu for every conversation where the connector is enabled.

Claude Code

Run this in your terminal:

claude mcp add --transport http turbodoc https://api.turbodoc.ai/mcp

Then inside a Claude Code session, run /mcp and follow the authentication prompt. Add --scope user to the command above to make the server available in every project.

Cursor

Add this to ~/.cursor/mcp.json (global) or .cursor/mcp.json in a project:

{
  "mcpServers": {
    "turbodoc": {
      "url": "https://api.turbodoc.ai/mcp"
    }
  }
}

Cursor detects the change, shows Turbodoc under Settings → MCP, and opens the OAuth sign-in when the server is first used.

VS Code

Run the MCP: Add Server command from the command palette, choose HTTP, and paste the endpoint. Or add it to .vscode/mcp.json:

{
  "servers": {
    "turbodoc": {
      "type": "http",
      "url": "https://api.turbodoc.ai/mcp"
    }
  }
}

Windsurf

Add this to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "turbodoc": {
      "serverUrl": "https://api.turbodoc.ai/mcp"
    }
  }
}

Example prompts

  • “Save this article to Turbodoc and tag it with 'design-systems'.”
  • “What did I bookmark about Postgres in the last three months?”
  • “Summarize our conversation and store it as a note called 'Q3 planning'.”
  • “Save this function as a code snippet, language TypeScript.”
  • “Create a Mermaid sequence diagram of this flow and save it to my diagrams.”
  • “List my unread bookmarks and archive the ones about tools I no longer use.”

Troubleshooting

  • Authentication loop or 401 errors: remove the server from your client, re-add it, and complete the OAuth flow again to refresh tokens.
  • Client doesn't support remote servers: Turbodoc uses Streamable HTTP transport. Older clients that only support stdio servers can bridge with npx mcp-remote https://api.turbodoc.ai/mcp.
  • Tools not appearing: make sure the connector/server is enabled for the current conversation or workspace, then start a new conversation.
  • Still stuck? Contact us — we read everything.

What your assistant can do

The server exposes 22 tools covering full create, read, update, and delete operations on bookmarks, notes, code snippets, and diagrams, plus tag listing and batch operations. See the complete tool catalog.

Turbodoc is free while in beta — and 100% open source.

Create your free account