Docs

MCP Setup

mkdshare.DEV exposes a cloud-hosted Model Context Protocol server. Connect any MCP client once, then create, share, and annotate markdown documents directly from AI conversations.

Prerequisites

  • 1. A free mkdshare account. Sign up with Google →
  • 2. An API token. Get yours at mkdshare.dev/api-access after signing in.
  • 3. Claude Desktop, Claude Code, Cursor, or any MCP client that supports Streamable HTTP.

Endpoint

POST https://mkdshare.dev/mcp

No local install needed. The server runs in the cloud.

Claude Desktop

Open ~/Library/Application Support/Claude/claude_desktop_config.json and add inside "mcpServers": 

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

Restart Claude Desktop after saving (Cmd+Q).

Claude Code

Run once in your terminal:

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

Cursor

Go to Settings → Cursor Settings → MCP, click Add new MCP server, and enter:

Name mkdshare
Type http
URL https://mkdshare.dev/mcp
Header Authorization: Bearer <your-token>

Other MCP clients

Any client that supports the MCP Streamable HTTP transport can connect. Use https://mkdshare.dev/mcp as the endpoint and set the Authorization: Bearer <token> header.

Detailed setup guides

Claude Desktop
Cursor
Codex

Sign in without a browser

If you are in an environment without a browser, ask your AI assistant to call request_device_auth. It returns a short URL and code. Visit the URL on any device, sign in with Google, and the token is returned automatically.

Example prompt

Call request_device_auth on mkdshare, then give me the link and code to complete sign-in.

Available tools

create_document Publish a markdown doc and get a shareable URL. Supports visibility, allowed_emails, allowed_domain, expires_at.
get_document Read the full content of any document you have access to.
update_document Edit the title, content, or access settings of a document you own.
list_documents List all documents you own.
create_annotation Add an inline comment anchored to a specific passage of text.
list_annotations List all inline comments on a document.
request_device_auth Start Google sign-in without a browser. No token needed.
poll_device_auth Complete sign-in and retrieve your API token.

Example prompts

Publish this markdown as a mkdshare document and give me the shareable link.
Create a project brief in markdown, publish it with mkdshare, and make it 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

401 Unauthorized

Your token is missing or incorrect. Check the Authorization header. Get a fresh token at mkdshare.dev/api-access.

Tools not appearing

Restart your MCP client after adding the server. For Claude Desktop, fully quit and reopen the app.

Connection error

Verify the URL is exactly https://mkdshare.dev/mcp and that your client supports the Streamable HTTP transport.

Create a free account to get your API token.