codraftdocs

Connect your agent

codraft itself doesn't ship an AI model. You bring the agent you already use, codraft just gives it a place to write.

It works with any agent that supports MCP (Model Context Protocol):

  • Claude Code (Anthropic)
  • Cursor CLI
  • Codex CLI (OpenAI)
  • GitHub Copilot CLI

You'll configure your agent once. After that, the agent can open documents, write into them, and respond to comments without leaving your editor.

One-time setup

Inside codraft, open Settings → Agents. Pick the agent you use and click Copy connector config. codraft puts the right snippet on your clipboard.

Paste it into your agent's MCP settings:

Claude Code

Paste into ~/.config/claude-code/mcp.json (or run the claude mcp add command codraft shows you in Settings).

Cursor CLI

Paste into ~/.cursor/mcp.json (global) or .cursor/mcp.json in a specific project.

Codex CLI

Paste into ~/.codex/mcp.json.

GitHub Copilot CLI

Paste into your Copilot CLI configuration file (Copilot will show its location on first run).

Tip

Don't have your agent installed yet? Each one has its own quick-start guide on its vendor's site, install and sign in there first, then come back here.

Verify it works

Restart your agent so it picks up the new config, then run a quick check:

Open a new document in codraft and write a one-paragraph intro about magic-link auth.

You should see:

  1. A codraft window open (if it wasn't already).
  2. The "Claude is writing…" presence dot appear in the top right.
  3. Text stream into the page, character by character, with a clay-colored caret following the cursor.

If nothing appears in the codraft window, see Troubleshooting below.

Switch agents anytime

You can have multiple agents configured at once. codraft uses whichever one is talking to it; if you want to switch your default, open Settings → Agents and pick a new one.

Troubleshooting

  • "My agent says it can't reach codraft." Make sure codraft is launched. The connector starts the app automatically when your agent runs, but if it can't find the install it'll error out. Confirm codraft is in /Applications.
  • "The agent acknowledged but nothing showed up." Check that the codraft window is open (not just running in the background). A minimized window still receives writes; a closed window doesn't.
  • "Edits go to the wrong document." Each codraft window is bound to one file. Ask your agent to open the right file first, or use File → Open… in codraft before asking for edits.
  • "My agent isn't listed above." Any agent that supports MCP works. Use the same JSON snippet, the mcpServers block, in that agent's MCP settings.

If you're still stuck, email support@codraft.app with the agent you're using and what you tried.