Setup guide

One URL. Sign in once.

Connect every AI tool that supports MCP through a single secure endpoint, and each one starts every session briefed on your project. Paste the URL, click connect, and authorize in your browser — no API keys to copy, no per-tool config. The same flow works in Claude.ai, ChatGPT, Cursor, Claude Code, VS Code, and more.

Universal setup

Connect any tool

Every MCP-compatible tool connects the same way: add DeerDawn as a remote MCP server using the URL below, then sign in through your browser. DeerDawn handles the OAuth handshake (including dynamic client registration) automatically — there is nothing to paste but the URL.

DeerDawn MCP URL
https://api.deerdawn.com/api/v1/mcp
1
In your AI tool, add a custom / remote MCP server (sometimes called a connector) and paste the URL above. Leave any OAuth client fields blank.
2
Click Connect. A DeerDawn tab opens — sign in and press Connect to authorize.
3
You're returned to your tool and the DeerDawn tools (start_session, get_context, update_context, …) are ready to use.
Prefer a key? Any tool that only supports header auth can skip OAuth: set Authorization: Bearer <your-api-key> with a key from app.deerdawn.com/api-keys.
Per-tool menu

Where to add the URL

The URL and browser sign-in are identical everywhere — only the menu location differs. Find your tool below.

Claude.ai
Settings → Connectors → Add custom connector
ChatGPT.com
Settings → Connectors → Add MCP server (choose OAuth)
Cursor
Settings → MCP → Add server, or add a "url" entry in .cursor/mcp.json
Claude Code
Run the claude mcp add command below
VS Code / Copilot
Command palette → MCP: Add Server → HTTP → paste the URL
Windsurf, Gemini, others
Add a custom remote / HTTP MCP server with the URL
Claude Code — one command
claude mcp add -s user --transport http deerdawn https://api.deerdawn.com/api/v1/mcp
Make it automatic

Brief every new chat automatically

Add a short instruction so your AI calls DeerDawn automatically — reading the brief at the start and keeping it current as you work — without you asking each time.

Claude.ai — add to a Project's instructions
At the start of every conversation, silently call start_session from DeerDawn before responding. Use the returned context (current task, decisions, stack) to answer without asking me to re-explain the project.

After any of the following, call update_context with a 1-2 sentence summary:
- A decision is made
- The task or status changes
- Something meaningful is built or fixed
- I confirm an approach ("yes", "good", "do it", "ship it")

Do not mention that you are calling these tools unless I ask.

Settings → Projects → Project instructions, so it applies to every conversation in that project.

ChatGPT — add to custom instructions
At the start of every conversation, call start_session from DeerDawn before responding. Use the returned context to orient yourself — current task, recent decisions, open questions — without asking me to re-explain.

After any decision, task change, or meaningful progress, call update_context with a brief summary of what changed and why.

Call these tools silently. Do not narrate the tool calls unless I ask.

Settings → Custom instructions → What would you like ChatGPT to know?

Advanced / optional

Local install for coding tools

The universal URL above is all most people need. Coding assistants can optionally run DeerDawn as a local npx -y @deerdawn/mcp-server@latestprocess instead. It signs in the same way (browser), and adds two things the remote URL can't:

  • Writes .deerdawn-context.md / .cursorrules into your repo so the brief loads with no tool call.
  • Installs SessionStart / Stop hooks that capture and update the brief automatically.

Claude Code

1
Run this in your terminal. Claude Code registers MCP servers via its CLI — it does not read a ~/.claude/mcp.json file.
Run in your terminal
claude mcp add -s user deerdawn -e DEERDAWN_API_URL=https://api.deerdawn.com -- npx -y @deerdawn/mcp-server@latest
2
Restart Claude Code. On first use a browser tab opens for sign-in — sign in with your DeerDawn account.
Tip: Ask Claude to run apply_setup after signing in. It writes the DeerDawn session-start instruction to your ~/.claude/CLAUDE.md so every session starts briefed automatically.

Cursor

1
Add the config to .cursor/mcp.json in your project, or ~/.cursor/mcp.json globally.
.cursor/mcp.json or ~/.cursor/mcp.json
{
  "mcpServers": {
    "deerdawn": {
      "command": "npx",
      "args": ["-y", "@deerdawn/mcp-server@latest"],
      "env": {
        "DEERDAWN_API_URL": "https://api.deerdawn.com"
      }
    }
  }
}
2
Restart Cursor. Sign in via browser when prompted.
DeerDawn writes the brief to .cursorrules automatically so Cursor starts every session briefed on the latest project state.

Codex (OpenAI)

1
Add the config to ~/.codex/config.toml.
~/.codex/config.toml
[mcp_servers.deerdawn]
command = "npx"
args = ["-y", "@deerdawn/mcp-server@latest"]
startup_timeout_sec = 120

[mcp_servers.deerdawn.env]
DEERDAWN_API_URL = "https://api.deerdawn.com"
2
Restart Codex. Sign in via browser when prompted.

Claude Desktop & ChatGPT Desktop

1
Add the same config to the app's MCP config file:
  • Claude (macOS): ~/Library/Application Support/Claude/claude_desktop_config.json
  • ChatGPT (macOS): ~/Library/Application Support/com.openai.chat/mcp_servers.json
{
  "mcpServers": {
    "deerdawn": {
      "command": "npx",
      "args": ["-y", "@deerdawn/mcp-server@latest"],
      "env": {
        "DEERDAWN_API_URL": "https://api.deerdawn.com"
      }
    }
  }
}
2
Quit and reopen the app. Sign in via browser on first use.

Not signed up yet?

Create a free account and connect your first tool in a few minutes.

Get started free →