MCP Server Integration
mkdn.pro includes an MCP (Model Context Protocol) server that lets AI assistants share documents directly.
What is MCP?
MCP (Model Context Protocol) is a standard that lets AI assistants interact with external tools and services. With mkdn's MCP server, AI assistants like Claude can:
- Share markdown documents you're working on
- Create beautiful formatted versions of their responses
- Generate shareable links for code, documentation, and more
Setup
1. Install the CLI
The MCP server is included in the mkdn CLI:
npm install -g mkdn.pro2. Configure Your AI Assistant
Add mkdn to your MCP configuration. For Claude Desktop, edit your config file:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%/Claude/claude_desktop_config.jsonAdd this configuration:
3. Restart Your AI Assistant
After saving the configuration, restart Claude Desktop to load the MCP server.
Using with AI Assistants
Once configured, you can ask your AI assistant to share documents:
- "Share this as a mkdn document"
- "Create a shareable link for this code"
- "Format this as a beautiful document and share it"
The AI will use the MCP server to create and share documents automatically.
Available Tools
The MCP server exposes these tools to AI assistants:
| Tool | Description |
|---|---|
share_markdown | Share a markdown document |
share_code | Share a code snippet with syntax highlighting |
get_document | Retrieve an existing document |
Example Workflow
- You're working with Claude on a technical document
- You ask: "Share this documentation as a mkdn link"
- Claude uses the MCP server to create the document
- You receive a shareable link instantly
Troubleshooting
MCP Server Not Loading
- Verify the config file path is correct
- Ensure mkdn CLI is installed globally
- Check Claude Desktop logs for errors
Permission Errors
- Run manually to verify it works
npx mkdn.pro mcp - Check that your system allows the command to execute
Need help? Check our full MCP documentation or contact support.