Connect Claude Code to your knowledge

Welcome

Who this is for

You use Claude Code — the terminal-native Anthropic CLI — and you want Claude to read your Deep Thought knowledge while you work. You're comfortable running a couple of commands. After this wizard, claude in any project can query your sources, entities, and graph.

If you'd rather use Claude Desktop / claude.ai in a browser, use the Claude Desktop wizard instead — same connection, different client.

You're about to register the Deep Thought MCP server with Claude Code. After this, in any terminal session where you run claude, you can ask about your meetings, notes, transcripts, and entities — and Claude reads them directly through MCP.

This is the remote MCP connector: Claude Code talks to mcp.deep-thought.cloud over HTTPS using OAuth 2.1. The first call triggers a browser pop-up for consent (one-time), then Claude Code remembers the token. You can revoke at any time.

What you'll do in the next 5 minutes

Verify Claude Code is installed
Register the Deep Thought server with claude mcp add
Trigger the first call (the browser opens for OAuth)
Verify the response includes citations from your knowledge base

Verify Claude Code is installed

Open a terminal and run:

claude --version

You should see a version string like 1.x.y. If you get command not found, install Claude Code first from claude.ai/code — there's a single-line install script on that page.

Then check what MCP servers you already have:

claude mcp list

If you see an existing entry named deep-thought (a local stdio one from earlier setups), that's fine — the next step uses a different name (dt-cloud) so they coexist.

Register the Deep Thought server

Run this command in your terminal:

claude mcp add dt-cloud --transport http https://mcp.deep-thought.cloud/mcp

Breakdown:

dt-cloud — the name you'll see in claude mcp list. Pick anything memorable; dt-cloud is the convention.
--transport http — Streamable HTTP transport (this is the remote connector, not the local stdio one).
https://mcp.deep-thought.cloud/mcp — the production Deep Thought MCP endpoint.

Verify it's registered:

claude mcp list

You should see dt-cloud listed alongside any existing servers.

Make the first call — OAuth triggers

Start a Claude Code session (anywhere — your home directory works):

claude

Then prompt:

List my Deep Thought sources via the dt-cloud MCP server.

Claude Code will try to call a tool from dt-cloud. Because this is the first call, it needs to authenticate. Claude Code opens a browser window pointing at https://app.deep-thought.cloud/oauth/consent.

If the browser doesn't open automatically, look for a URL in Claude Code's output and open it manually.

Approve scopes in the browser

On the consent page:

Sign in with your Deep Thought account if not already
Review the scopes Claude Code is asking for:
- kb:read — read sources, transcripts, summaries, entities
- graph:read — traverse the entity graph
- kb:write (optional) — let Claude apply tags, create actions, add notes

Click Approve. The page redirects back, and Claude Code's first tool call completes. You'll see the result in your terminal.

The token is stored by Claude Code in its config — you won't be prompted again for this server unless you revoke or move machines.

Try a real query

In the same Claude Code session, try something specific:

Search my Deep Thought knowledge for the last planning meeting we had this month. Summarise the decisions.

Or:

What entities are connected to [a person or project name you've discussed]?

Claude Code will pick the right MCP tool (search, get_entity, traverse_graph) and call it. You may see Claude announce "I'll search your Deep Thought knowledge…" before responding.

Verify the response cites real data

Claude's response should reference specific sources — meeting titles, source IDs, dates, entity names you recognize. If the answer is generic and doesn't mention anything from your actual knowledge base, something didn't connect.

If you see citations: the connector works. You're done.

If the response is generic:

Run claude mcp list and confirm dt-cloud is there
Re-trigger by asking Claude to explicitly use the dt-cloud server for the search
Check Claude Code didn't fall back to other connectors / web search
If still stuck: claude mcp remove dt-cloud then re-add and re-authorize
Or email support@deep-thought.cloud

How to revoke the connection

Two paths:

From Deep Thought (recommended — invalidates immediately)

Visit app.deep-thought.cloud/settings/devices. You'll see a list of connected MCP clients (one per machine where you set up dt-cloud). Click Revoke next to any entry — the device token is invalidated server-side instantly. Claude Code's next call will get a 401.

From Claude Code (removes local config)

claude mcp remove dt-cloud

This deletes the entry locally. The token stays valid server-side until it expires (or you revoke it from the Deep Thought side too).

Best practice: revoke from Deep Thought first (invalidates the token), then remove from Claude Code (cleans up the local config).

Done

Claude Code can now read your Deep Thought knowledge from any terminal. Run claude in any project directory and ask questions in plain English — Claude will pick the right MCP tool and answer with citations.

Patterns that work well

Daily standup prep. "What did we decide in yesterday's standup?" → Claude pulls the source, lists decisions and action items.
Codebase + knowledge. "This file references the 'foo' service — what did we discuss about it in the architecture meeting?" → Claude combines code-reading with MCP.
Action-item harvest. "List every open action assigned to me, grouped by project." → Claude reads actions from Deep Thought directly.

Going deeper