Setup guide

Paste one prompt. Sign in once.

Ask your AI to install DeerDawn for itself. It detects the client, performs the setup it can automate, and pauses only when you need to approve an action or sign in.

One-prompt setupManual setupWhere to add itMake it automaticLocal install (advanced)
Fastest setup

Let your AI handle it

Paste this into the AI tool you want to connect. DeerDawn's hosted guide gives it the exact instructions for Codex, Claude Code, Cursor, Claude, ChatGPT, VS Code, or another MCP client.

Fetch and follow the DeerDawn setup instructions at https://deerdawn.com/agent-setup/prompt.md. Detect which AI tool you are running in, install or configure DeerDawn for me, pause only when I need to approve an action or sign in, then verify the connection and help me save my first project brief.

The agent preserves existing configuration and stops for browser sign-in or any approval your client requires.

Manual fallback

Connect it yourself

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/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/mcp/claude
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.

If start_session includes a "Since last session" catch-up, open with at most two sentences: the most meaningful change, anchored in time ("Last session (yesterday) you shipped X"), then the open thread as an offer ("Y is still open. Want to pick that up?"). Then stop and let me steer. Do not recite the full brief. If nothing changed, confirm readiness in one line. Never invent progress, decisions, or landmines that are not in the context.

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.

If start_session includes a "Since last session" catch-up, open with at most two sentences: the top change anchored in time, then the open thread as an offer. Do not recite the full brief; if nothing changed, confirm readiness in one line. Never invent progress that is not in the context.

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@latest process 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 -e DEERDAWN_SURFACE_ID=claude_code -- 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 →