AI tool integration for docs-as-code

[mintlify]

Summary

This update improves the quickstart guide by adding a new AI tip and prompt for integrating Mintlify with AI coding tools. It also introduces a new guide for the Mintlify Model Context Protocol (MCP) server, which enables AI tools to directly edit documentation content.

Changes

• Quickstart guide (quickstart.mdx) now includes an AI tip and prompt for setting up Mintlify with AI coding tools.
• New guide (ai/mintlify-mcp.mdx) details the Mintlify MCP server, its capabilities, and how to connect it with various AI clients like Claude and Cursor.
• The new guide explains the difference between the documentation MCP and the Mintlify MCP.
• Provides a step-by-step explanation of how a Mintlify MCP session works, from checking out a branch to saving changes.

Mintlify

0 threads from 0 users in Mintlify

• No unresolved comments

---

Note

Low Risk
Documentation-only changes; main risk is accidental MDX rendering issues (e.g., the stray / line) or incorrect setup instructions/URLs.

Overview
Adds a new ai/mintlify-mcp.mdx guide explaining the Mintlify MCP’s write-access workflow (OAuth connection, branch-based sessions, available tools) and providing setup steps for clients like Claude/Claude Code/Cursor.

Updates quickstart.mdx to include an AI-focused tip + copyable prompt for installing the Mintlify skill and connecting the MCP server, and makes small frontmatter/MDX formatting tweaks (e.g., keywords formatting, image attribute ordering).

^{Reviewed by Cursor Bugbot for commit 76e87bc. Bugbot is set up for automated code reviews on this repo. Configure here.}

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 76e87bc. Configure here.}

[cursor]

Stray forward slash renders as visible text on page

High Severity

A stray / character on its own line was introduced between the intro paragraph and the "Before you begin" heading. This will render as a visible forward slash on the published quickstart documentation page, which is user-facing and likely one of the most visited pages.

 

^{Reviewed by Cursor Bugbot for commit 76e87bc. Configure here.}