mirror of
https://github.com/mintlify/docs.git
synced 2026-09-14 13:35:46 +08:00
Ethan Palm
4cffd85891
* docs(DOC-389): add Codex CLI guide and MCP connection tab Adds a guide for using OpenAI Codex CLI with Mintlify docs (AGENTS.md config + MCP connection), adds Codex to the AI tools nav group, and adds a Codex tab to the MCP server connection example section. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * docs: add Codex to AI tools list in guides index Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * docs: update Windsurf → Devin Desktop across guides and contextual menu windsurf.com permanently redirects to devin.ai/desktop. Updates: - guides/windsurf.mdx: rebrand to Devin Desktop, update rules path to .devin/rules/, update docs links, add MCP config with correct format - ai/contextual-menu.mdx: replace deprecated "windsurf" identifier with "devin-desktop" in example config, update description and keywords Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * docs: rename guides/windsurf to guides/devin-desktop, add redirect Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * docs: sweep remaining Windsurf → Devin Desktop references in English docs Updates ai-native.mdx, guides/index.mdx, guides/claude-code.mdx, organize/settings-structure.mdx, organize/settings-reference.mdx, and cli/install.mdx. Changelogs and translation files left as-is (changelogs are historical records; translations auto-update on merge). Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * docs: add Codex tab to Use your MCP server section Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * Update docs.json --------- Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
59 lines
4.1 KiB
Plaintext
59 lines
4.1 KiB
Plaintext
---
|
|
title: "AI-native documentation"
|
|
sidebarTitle: "AI-native"
|
|
description: "Discover how AI-native features enhance reading, writing, and discovering your documentation with the assistant, agent, and MCP server."
|
|
keywords: ["AI","assistant","agent","llms.txt","MCP","llms-full.txt"]
|
|
---
|
|
|
|
When you host your documentation on Mintlify, built-in AI features help your users find answers and your team maintain content more efficiently. Your content provides the context for these AI-native features to improve the experiences of reading, writing, and discovering your documentation.
|
|
|
|
## What makes your documentation AI-native
|
|
|
|
### Reading
|
|
|
|
In addition to reading individual pages, users can chat with the [assistant](/assistant) in your documentation for immediate answers to their questions and links to relevant content. The assistant helps guide users through your product with accurate information from your documentation. Embed the assistant into custom apps with the [API](/api/assistant/create-assistant-message-v2) to extend where users can access your documentation.
|
|
|
|
### Writing
|
|
|
|
The [agent](/agent) helps you write and maintain documentation. It creates pull requests with proposed changes based on your prompts, pull requests, and Slack threads. Add the agent to your Slack workspace so that anyone on your team can help maintain your documentation by chatting with the agent. Or embed the agent into custom apps via the [API](/api/agent/v2/create-agent-job).
|
|
|
|
Create [automations](/automations/index) to run the agent on a schedule or on a push to a repository. Each automation defines a prompt for the agent and a trigger for when to run it.
|
|
|
|
Configure popular tools like [Cursor](/guides/cursor), [Claude Code](/guides/claude-code), and [Devin Desktop](/guides/devin-desktop) to reference the Mintlify schema, your style guide, and best practices.
|
|
|
|
### Discovering
|
|
|
|
Your site is automatically optimized for AI tools and search engines to help users discover your documentation. All pages send their content as Markdown to AI agents instead of HTML, which helps these tools process your content faster and use fewer tokens. Every page is also available to view as Markdown by appending `.md` to the URL. Use the [visibility](/components/visibility) component to tailor content for each audience.
|
|
|
|
Mintlify hosts `llms.txt` and `skill.md` files for your documentation. These industry-standard files help LLMs respond efficiently with relevant information to user queries and provide a list of capabilities for agents to use, so that users are more successful with your product.
|
|
|
|
<Tip>
|
|
Teach your users how to install your `skill.md` file so they get better results when using your product with AI tools. Embed an installation prompt directly in your docs with the [`Prompt` component](/components/prompt):
|
|
|
|
```mdx
|
|
<Prompt description="Install the skill for your product." actions={["copy", "cursor"]}>
|
|
npx skills add https://your-docs-domain.com
|
|
</Prompt>
|
|
```
|
|
</Tip>
|
|
|
|
Your documentation site also hosts an MCP server that lets users connect your documentation directly to their AI tools for up-to-date information about your product directly where they want it.
|
|
|
|
Full-text search and semantic understanding help users and AI tools find relevant information quickly. Search understands user intent rather than just matching keywords. And if a user encounters a 404 error, your site suggests related pages to help them find what they're looking for. No configuration required.
|
|
|
|
## Enable AI features
|
|
|
|
Select any of the following cards for more information.
|
|
|
|
<CardGroup>
|
|
<Card title="Assistant" icon="bot-message-square" href="/assistant/configure">
|
|
Configure the assistant to search external sites or direct people to your support team if it can't answer their questions.
|
|
</Card>
|
|
<Card title="Automations" icon="message-circle-plus" href="/automations/index">
|
|
Get documentation updates automatically on a schedule or when a push event occurs.
|
|
</Card>
|
|
<Card title="Contextual menu" icon="sparkles" href="/ai/contextual-menu">
|
|
Add a menu to pages that lets users query AI tools, connect to your MCP server, and copy pages as context with one click.
|
|
</Card>
|
|
</CardGroup>
|