What is MCP?

The Model Context Protocol (MCP) lets Claude interact with your MossDocs instance conversationally. Connect to any MossDocs deployment via URL and get complete control - manage workspaces, organize folders, collaborate with teams, and create documents. Everything you can do in the web app, you can now do through natural conversation with Claude!

Full Workspace Control:

"Create a new workspace and invite the team as editors"

Document Management:

"Create a quarterly planning doc and organize it in the Q1 folder"

Team Collaboration

MossDocs includes powerful team collaboration features. Manage workspace members, control access with role-based permissions, and organize documents in shared folders - all from Claude Desktop! Perfect for teams working together on documentation.

Invite Team Members:

"Invite user@company.com to the Marketing workspace as an editor"

Organize Content:

"Create a folder structure for our Q1 projects"

Setup Instructions

Locate Claude Desktop Config

First, find your Claude Desktop configuration file:

macOS:

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

Windows:

%APPDATA%\Claude\claude_desktop_config.json

If the file doesn't exist, create it. The directory should already exist if you have Claude Desktop installed.

Add MossDocs MCP Server Configuration

Copy this configuration and paste it into your Claude Desktop config file:

{
  "mcpServers": {
    "draft": {
      "command": "npx",
      "args": [
        "-y",
        "@draft/mcp-bridge",
        "https://your-draft-url.com/api/mcp"
      ]
    }
  }
}

Important: Replace https://your-draft-url.com/api/mcp with your actual MossDocs URL:

https://localhost:3001/api/mcp - Local development
https://your-team-server.com/api/mcp - Team server
https://draft.yourcompany.com/api/mcp - Production

Restart Claude Desktop

Completely quit and reopen Claude Desktop for the configuration to take effect.

Look for the tool icon in Claude Desktop - this indicates MCP servers are connected!

Available Tools

Workspace Management

list_workspaces

List all workspaces you are a member of

get_workspace

Get details of a specific workspace

create_workspace

Create a new workspace

update_workspace

Update workspace settings (admin only)

switch_workspace

Switch to a different workspace

get_limit_status

Check workspace member limits and usage

Folder Management

list_folders

List all folders in current workspace

create_folder

Create new folder (EDITOR/ADMIN required)

update_folder

Rename or move a folder

delete_folder

Delete an empty folder

Team/Member Management

invite_user

Invite user by email (admin only)

generate_invite_link

Generate shareable invite link (admin only)

list_invitations

List pending invitations (admin only)

resend_invitation

Resend invitation email (admin only)

revoke_invitation

Revoke pending invitation (admin only)

list_workspace_members

List all workspace members (admin only)

update_member_role

Update member role (admin only)

remove_member

Remove member from workspace (admin only)

Document Management

list_documents

List all accessible documents with previews

get_document

Get full content of a specific document

create_document

Create new markdown documents

update_document

Update document title or content

delete_document

Delete/archive a document

search_documents

Search through document titles and content

Document Approval Checkpoints

approve_document

Approve current version with optional notes

get_approval_status

Get approval status showing changes since last approval

get_pending_reviews

Get My Reviews dashboard with filtering/sorting

get_approval_history

Get audit trail for a document

get_document_diff

Get exact diff between versions (defaults to your last approval vs current)

add_required_reviewer

Add required reviewer for compliance

remove_required_reviewer

Remove required reviewer

get_required_reviewers

List required reviewers with approval status

Document Templates

list_templates

Browse available templates with filtering by category/type

get_template

Get template details including variable definitions

create_document_from_template

Create document from static template (instant)

generate_ai_document

Start AI generation job from AI template (with web research)

check_generation_status

Check status of AI generation job

accept_generated_document

Accept AI-generated content and create document

get_token_usage

Check workspace AI token usage and limits

create_template

Create custom template (admin only)

Try It Out!

Once connected, try these example prompts in Claude Desktop:

Workspace Management:

"List all my workspaces"

"Create a new workspace called 'Marketing Team'"

"Switch to workspace [workspace-id]"

Folder & Organization:

"List all folders in my current workspace"

"Create a folder called 'Q1 Planning'"

Team Management:

"List all members of my current workspace"

"Invite user@example.com as an EDITOR"

"Generate a shareable invite link that expires in 7 days"

Documents:

"Show me my recent documents"

"Create a document called 'Meeting Notes' in folder [folder-id]"

"Search my documents for 'project roadmap'"

Document Approvals:

"Show me all documents needing my review"

"Show me exactly what changed in document [document-id] since I last approved it"

"Approve document [document-id] with note 'Looks good for Q1 launch'"

"Get approval status for document [document-id]"

"Show me the approval history for this document"

"Add user [user-id] as a required reviewer for document [document-id]"

Document Templates:

"List all available templates, filter by Sales category"

"Create a document from the 'Meeting Agenda' template with variables: meeting_title='Q1 Planning', date='2024-01-15'"

"Generate an AI document from 'Sales Call Prep Research' template for customer_name='Acme Corp', customer_website='acme.com'"

"Check the status of generation job [job-id]"

"Show me my workspace's AI token usage this month"

Common Workflows

Multi-step workflows showing how to accomplish common tasks with Claude Desktop and MossDocs MCP.

AI-Powered Sales Call Prep

1
"List templates filtered by Sales category"
2
"Get details for the Sales Call Prep Research template"
3
"Generate AI document with variables: customer_name='Acme Corp', customer_website='acme.com', call_date='2024-02-15'"
4
"Check generation status - wait for AI to research company and create briefing"
5
"Accept the generated document and save it to my Sales folder"

Document Approval Workflow

1
"Show me all documents needing my review"
2
"Get approval status for document [document-id]"
3
"Show me what changed since I last approved"
4
"Approve document [document-id] with note: Reviewed for compliance"
5
"Get approval history to see who else approved"

Manage Required Reviewers

1
"Get list of required reviewers for document [document-id]"
2
"Add user [user-id] as required reviewer for document [document-id]"
3
"Check if all required reviewers have approved"
4
"Remove user [user-id] as required reviewer if needed"

Review Pending Documents

1
"Show me all documents that need my review"
2
"Open [document name] for review"
3
"Show me what changed since the last version"
4
"Approve this document" or "Request changes to this document"

Bulk Document Organization

1
"Show all documents in [workspace]"
2
"Create a new folder called [folder name]"
3
"Move documents with [keyword] to [folder name]"
4
"List documents in [folder name] to verify"

Team Onboarding with Workspace Setup

1
"Create a new workspace called [team name]"
2
"Add [email] as a member of [workspace]"
3
"Create a welcome document in [workspace]"
4
"Set up approval workflow for [workspace]"

Document Search and Filtering

1
"Find all documents containing 'security' updated in the last month"
2
"Show documents modified by [author name]"
3
"List documents created in the last week"

Version Control Operations

1
"Show me version history for [document]"
2
"Compare current version with version from last week"
3
"Revert [document] to previous version"

Troubleshooting

Connection Issues

Problem: Claude Desktop not connecting to MossDocs MCP server.
Solution: Check that your Claude Desktop config file is correctly formatted JSON. Verify the MossDocs URL is accessible and includes the /api/mcp endpoint. Completely quit and restart Claude Desktop (not just close the window). Check the Claude Desktop logs for error messages.

Authentication Problems

Problem: MCP server returns authentication errors.
Solution: Verify you're logged into MossDocs in your browser. Check that your session hasn't expired. If using API key authentication, verify your token is correct and hasn't expired. Try logging out and back into MossDocs, then restart Claude Desktop.

Permission Denied Errors

Problem: Operations fail with permission errors.
Solution: Verify you have the correct role in the workspace. Document operations require at least EDITOR role. Workspace admin operations (inviting members, changing settings) require ADMIN role. Check your role in MossDocs settings and request elevated permissions if needed.

MCP Server Source Code

The MossDocs MCP server is open source. View the source code, report issues, or contribute to the project on GitHub.

View Source Code Report Issues

Need More Help?

Check out the full documentation or explore the API docs

API Docs AI Integration Guide

MCP Server Setup