Skip to content
Documentation

MCP and AI Assistants

updated

Meldoc integrates with AI assistants through the Model Context Protocol (MCP). This lets tools like Claude, Cursor, and VS Code read, search, write, and reorganize your documentation — directly from the conversation.

What can AI assistants do?

With MCP connected, your AI assistant can:

  • Search and read — find documents by natural-language query, fetch full content, walk the document tree, and follow magic-link relationships across the workspace
  • Write and edit — create new documents with proper frontmatter, update existing ones (full or partial edits), and remove drafts
  • Audit your docs — surface staleness, duplicates, and other quality signals across a project
  • Manage glossary terms — read and edit shared definitions used across your workspace
  • Work with assets — list uploaded files, fetch metadata, and attach them to documents

Available tools

Here’s the full set of MCP tools the Meldoc server exposes today:

Category Tools
Documents — read docs_search, docs_get, docs_list, docs_tree, docs_graph, docs_related
Documents — write docs_create, docs_update, docs_delete
Documents — quality docs_audit
Glossary glossary_list, glossary_get, glossary_add, glossary_update, glossary_delete
Assets assets_list, asset_get, asset_attach
Navigation list_workspaces, projects_list, get_workspace, app_link
Meta server_info, auth_login_instructions

Tip: Ask your AI assistant “What MCP tools do you have for Meldoc?” — most clients will list them with descriptions.

Setting up MCP

For most clients, add the Meldoc MCP server to your tool’s configuration:

{
  "mcpServers": {
    "meldoc": {
      "type": "url",
      "url": "https://api.meldoc.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

Replace YOUR_TOKEN with an integration token from your workspace settings (Settings → Integration Tokens).

For Claude.ai and Claude Desktop via Custom Connectors, no token is needed — connect through the OAuth flow and sign in with your Meldoc account.

The CLAUDE.md file

You can add a CLAUDE.md file to your project to guide AI agents on your content rules, tone, and conventions. This demo project has one — it defines the friendly tone and demo- alias prefix used throughout these docs.

The CLI auto-generates and updates CLAUDE.md when you run meldoc init or meldoc pull.

Tip: Think of CLAUDE.md as onboarding instructions for your AI teammate. The clearer your rules, the better the AI will write.