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.mdas onboarding instructions for your AI teammate. The clearer your rules, the better the AI will write.