Use Cases

Share Markdown from Claude

Ask Claude to publish a document with mkdshare and get a shareable link in one tool call. The document renders cleanly, reviewers can comment inline, and you control who can access it.

The problem

Claude produces long, well-structured markdown answers. But sharing them is awkward. Pasting into chat scrolls forever. Copying into Google Docs loses formatting. Sending the raw text to a client or stakeholder is unreadable. You need a clean, permanent link that people can open in a browser and comment on.

Setup — Claude Desktop

  1. 1

    Create a free mkdshare account and get your API token at mkdshare.dev/api-access.

  2. 2

    Add mkdshare to your Claude Desktop config. Open ~/Library/Application Support/Claude/claude_desktop_config.json and add:

    {
  "mcpServers": {
    "mkdshare": {
      "url": "https://mkdshare.dev/mcp",
      "headers": {
        "Authorization": "Bearer <your-token>"
      }
    }
  }
}
  3. 3 Restart Claude Desktop. The mkdshare tools appear automatically.

Full Claude Desktop setup guide →

Setup — Claude Code

claude mcp add --transport http mkdshare \
  https://mkdshare.dev/mcp \
  --header "Authorization: Bearer <your-token>"

Example prompts

Publish a document
Publish this implementation plan as a mkdshare document. Make it public and give me the link.
Publish with access control
Create a project brief in markdown and publish it with mkdshare. Restrict it to my team at company.com.
Publish with expiry
Write a change proposal and publish it with mkdshare. Make it expire in 7 days.
Read comments
Read the annotations on mkdshare document abc12345 and summarize the requested changes.
Update a document
Update the mkdshare document at abc12345 with this revised content.

What Claude can do with mkdshare

create_document Publish markdown as a document and return the shareable URL.
update_document Edit a document you own, preserving its URL.
get_document Read any document you have access to, including its full content.
list_documents List all your documents.
create_annotation Leave an inline comment anchored to specific text.
list_annotations Read all comments on a document.

Troubleshooting

mkdshare tools not showing in Claude — Fully quit and reopen Claude Desktop after editing the config file. The MCP server list only updates on startup.

Authentication error — Check that your token is pasted correctly with no extra spaces. Regenerate it at mkdshare.dev/api-access if needed.

No browser available — Ask Claude to call request_device_auth. It returns a short link and code you can open on any device.

Ready to connect Claude?

Create a free account, grab your token, and add the config.

MCP docs →