From fab753cef03b8e4fab105bc4eaf2594c7db64735 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Fri, 21 Nov 2025 05:15:47 +0000 Subject: [PATCH] Update ai-native-poem.mdx --- ai-native-poem.mdx | 71 ++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 71 insertions(+) create mode 100644 ai-native-poem.mdx diff --git a/ai-native-poem.mdx b/ai-native-poem.mdx new file mode 100644 index 000000000..415de45dc --- /dev/null +++ b/ai-native-poem.mdx @@ -0,0 +1,71 @@ +--- +title: "AI-native" +description: "Learn how AI enhances reading, writing, and discovering your documentation" +keywords: ["AI", "assistant", "agent", "llms.txt", "MCP"] +--- + +When documentation lives on Mintlify's shore, +AI features help you find so much more. +Your content provides the context and light, +For AI-native features to work just right. + +## What makes your documentation AI-native + +### Reading + +Beyond pages read one by one, +Chat with the [assistant](/ai/assistant) till answers come. +It guides through your product with knowledge so true, +From documentation that's written by you. +Embed it in apps with the [API](api-reference/assistant/create-assistant-message) so grand, +To extend where your docs can lend a hand. + +### Writing + +The [agent](/ai/agent) helps maintain and create, +Pull requests it makes, no need to wait. +From prompts and threads in Slack's domain, +Anyone on your team can help maintain. +Add it to Slack or embed with care, +Via [API](/api-reference/agent/create-agent-job) it's everywhere. + +Configure [Cursor](/guides/cursor), [Claude Code](/guides/claude-code), [Windsurf](/guides/windsurf) with ease, +Reference your schema and style guides, if you please. + +### Discovering + +Your site's optimized for AI to find, +Markdown not HTML, efficient and kind. +Every page can be viewed with `.md` at the end, +Faster processing, fewer tokens to spend. + +`llms.txt` and `llms-full.txt` reside, +Industry standards to help LLMs guide. +Index your docs and respond with speed, +Relevant information for every need. + +An MCP server your site does host, +Connect your docs where users need them most. +Full-text search with semantic grace, +Understands intent, not just words in place. +And when 404 errors appear in sight, +Related pages suggested make things right. + +## Enable AI features + +Select any of the following cards for more information. + + + + Configure the assistant to search external sites or direct people to your support team if it can't answer their questions. + + + Add the agent to your Slack workspace or embed it into custom apps to have it help write and update your documentation. + + + Add a menu to pages that lets users query AI tools, connect to your MCP server, and copy pages as context with one click. + + + Your site has a hosted MCP server that lets users connect your documentation directly to their AI tools. Make your users aware of your MCP server and how to connect to it. + +