Docs

Claude Desktop MCP Markdown Sharing

Connect mkdshare to Claude Desktop and publish, share, and annotate markdown documents without leaving the conversation.

Prerequisites

1. Claude Desktop installed on your Mac. Claude Desktop installed on your Windows machine. Claude Desktop is not officially supported on Linux. We recommend using Claude Code or another MCP client.
2. A free mkdshare account. Sign up with Google →
3. A free mkdshare account to sign in with during setup — no API token needed.

Step 1 — Open the config file

Open this file in a text editor (create it if it doesn't exist):

Mac ~/Library/Application Support/Claude/claude_desktop_config.json

Windows %APPDATA%\Claude\claude_desktop_config.json

Step 2 — Add the mkdshare server

Add an mcpServers key if it isn't there yet, then add the mkdshare entry. Replace <your-token> with your API token.

{
  "mcpServers": {
    "mkdshare": {
      "url": "https://mkdshare.dev/mcp",
      "headers": {
        "Authorization": "Bearer <your-token>"
      }
    }
  }
}

If the file already has other MCP servers, add the "mkdshare": {…} block alongside them inside mcpServers.

Step 3 — Restart Claude Desktop

Fully quit Claude Desktop (Cmd+Q on Mac, not just close the window) and reopen it. Claude loads MCP servers on startup. Fully quit Claude Desktop (right-click the Claude tray icon and select Quit, don't just close the window) and reopen it. Claude loads MCP servers on startup. Restart your MCP host application to apply the configuration.

Step 4 — Verify tools appear

Start a new conversation. Click the tools icon in the input bar. You should see mkdshare tools listed:

create_document Publish a markdown doc and get a shareable URL

get_document Read a document you have access to

update_document Edit a document you own

list_documents Browse all your documents

create_annotation Leave an inline comment on a specific passage

list_annotations Read all comments on a document

Example prompts

Publish this markdown as a mkdshare document and give me the shareable link.

Create a project brief in markdown and publish it on mkdshare, restricted to my team domain.

Read the annotations on this mkdshare document and summarize the requested changes.

Update the mkdshare document at slug abc123 with this revised content.

Troubleshooting

Tools not appearing

Make sure you fully quit and relaunched Claude Desktop — closing a window is not enough. Also verify the JSON is valid (a missing comma or bracket prevents all MCP servers from loading).

401 Unauthorized

Your API token is missing or expired. Get a fresh token at mkdshare.dev/api-access and update the config file.

Config file not found

Create the file at the path shown above. Make sure Claude Desktop has been launched at least once to create the parent directory.

Create a free account to get your API token.