@mdedit/mcp-server

@mdedit/mcp-server

Use mdedit.ai Markdown Documents from Claude Code and other Model Context Protocol clients. The server runs locally over stdio and authenticates to mdedit with a scoped API key.

Claude Code setup

Create an API key in mdedit, then add the server:

claude mcp add --transport stdio \
  --env MDEDIT_API_KEY=mdh_your_key \
  mdedit -- npx -y @mdedit/mcp-server

Use --scope user before mdedit if you want the server available in every project. Verify the connection with claude mcp get mdedit or /mcp inside Claude Code.

Reviewer agents normally use articles:read,reviews:write. Editing agents need articles:write. Accepting a suggestion also requires articles:write because it changes document content. Agents that publish public links need publishing:write; publication status only needs publishing:read. Publishing does not happen implicitly after edits.

Tools

• list_articles
• read_article
• publish_article
• get_publish_status
• unpublish_article
• edit_article
• add_comment
• add_suggestion
• reply_to_thread
• resolve_thread
• list_review_threads
• get_presence

publish_article and unpublish_article require explicit confirmation fields in their tool inputs. A published document is readable by anyone with its mded.it link.

Live collaborative documents keep one agent session open across tool calls. The default idle timeout is 60 seconds; non-collaborative documents use the REST fallback and report an empty live-presence list.

Environment

• MDEDIT_API_KEY — required mdedit API key
• MDEDIT_API_URL — optional API host override
• MDEDIT_AGENT_NAME — optional awareness display hint; defaults to mdedit-mcp
• MDEDIT_MCP_IDLE_TIMEOUT_MS — optional positive idle timeout in milliseconds

Never commit API keys to a repository or place them in shared project MCP configuration.

Maintainer launch gate

The repository includes a manual Claude Code smoke test. It creates a uniquely named fixture article in the selected test workspace, enables collaboration, exercises list/read/comment/list/resolve/presence through MCP, verifies the resolved comment through the review API, and deletes the fixture.

MDEDIT_API_KEY=mdh_launch_gate_key \
MDEDIT_SMOKE_WORKSPACE_ID=workspace_id \
yarn workspace @mdedit/mcp-server smoke:claude

Use a test workspace and a key with articles:write,reviews:write. The key owner must have access to the workspace and the collaboration entitlement.