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 and models

You can have multiple agents configured at once, and choose which agent and model runs per document.

  • Set a global default in Settings.
  • Override per file from the picker at the top of the chat and comments panels, for example Claude with Opus on one doc and Codex with GPT-5.5 on another. The choice is remembered for that document.

codraft pulls the model list for each agent from our server, so it stays current as vendors add models.

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.