MCP Server

Connect MDDoc to Claude as a tool. Convert from your AI workflow.

What is MCP?

The Model Context Protocol (MCP) lets AI assistants like Claude use external tools. MDDoc provides an MCP server that gives Claude direct access to your templates, documents, and conversions.

Instead of switching between Claude and the MDDoc dashboard, you just ask Claude to convert your document. It calls MDDoc behind the scenes.

MCP access is available on all plans — including Solo. No Team plan required.

Setup

You need Python 3.10+ and an API key from your MDDoc dashboard.

1. Install dependencies

bash

pip install httpx mcp

2. Configure Claude Desktop

Add this to your Claude Desktop claude_desktop_config.json:

claude_desktop_config.json

{
  "mcpServers": {
    "mddoc": {
      "command": "python3",
      "args": ["/path/to/mcp_server.py"],
      "env": {
        "MDDOC_API_URL": "https://api.mddoc.app",
        "MDDOC_API_KEY": "mddoc_YOUR_KEY"
      }
    }
  }
}

3. Configure Claude Code

For Claude Code, add a .mcp.json file in your project root:

.mcp.json

{
  "mcpServers": {
    "mddoc": {
      "command": "python3",
      "args": ["./mcp_server.py"],
      "env": {
        "MDDOC_API_URL": "https://api.mddoc.app",
        "MDDOC_API_KEY": "mddoc_YOUR_KEY"
      }
    }
  }
}

Restart Claude after adding the config. You should see MDDoc tools listed when you start a conversation.

Available tools

The MCP server exposes seven tools:

Tool	Description
mddoc_list_templates	List all available Word templates
mddoc_list_mappings	List style mappings, optionally filtered by template
mddoc_list_documents	List all stored documents
mddoc_submit_document	Submit markdown with a title and optional project
mddoc_get_document	Get document details by ID
mddoc_convert	Convert a document with a template and mapping
mddoc_classify	AI-powered document type classification

Example workflow

Here's what a typical conversation with Claude looks like:

You

"Convert this project spec to Word using the corporate template."

Claude

Claude calls mddoc_list_templates to find the corporate template, then mddoc_list_mappings to get the matching mapping, then mddoc_submit_document with your markdown, and finally mddoc_convert.

Result

A professionally formatted .docx file, ready to download or export to SharePoint.

AI classification

The mddoc_classify tool uses Claude or GPT-4 to analyze your markdown and recommend a document type. It recognizes 14 types:

ADR

Architecture Document

Requirements Document

Test Plan

API Specification

Runbook

Design Document

User Guide

Release Notes

Meeting Notes

Technical Specification

Deployment Guide

Security Review

General

Classification modes:

suggest — returns recommendations without taking action
auto — classifies and executes the full pipeline automatically
dry-run — shows the plan without writing anything

Billing & access

The MCP server validates your API key and billing status before every tool call. If your subscription has lapsed or your conversion quota is exhausted, the tool returns a clear error message that Claude can relay to you.

Unlike the public REST API (which requires Team or Enterprise), MCP server access is included on all plans — even Solo.

If you need to push converted documents to SharePoint, see SharePoint Export.

Templates & Mappings SharePoint Export