• NAV UPDATES
  • META DATA
  • SYNCED STATE
  • HUMAN REVIEW

How to update documentation settings with your AI

Connect Mintlify to your AI client once. After that, you can manage your documentation structure through simple chat commands.

Ask AI about this page

Short answer

How can I change my Mintlify docs settings with AI?

You tell your AI what changes you want to make to your navigation or metadata, and it executes the updates for you. It uses the connected Mintlify tools to read your current setup and apply your new configurations.

Where every change lands.

The outcomes of your commands

Your AI translates your intent into specific configuration updates.

NAV UPDATES

New site navigation

The AI modifies your project structure. You get a reorganized sidebar or menu based on your description.

META DATA

Updated site info

The AI changes your project's metadata. This updates how your docs appear in search results and browser tabs.

SYNCED STATE

Current config view

The AI pulls your existing settings first. You get a clear picture of your current setup before any changes happen.

HUMAN REVIEW

Manual verification

The AI doesn't push code to your repo. You still need to review the changes in your local files or Git provider.

The workflow

What your AI does when the command arrives.

The AI acts as the bridge between your chat window and your Mintlify configuration.

  1. Fetch current settings

    The AI looks at your existing Mintlify configuration to understand your current navigation and metadata.

    get_metadata

  2. Analyze your request

    Your agent compares your requested changes against the current project state to plan the update.

    get_metadata

  3. Apply configuration

    The AI sends the new navigation or metadata values to Mintlify to update the project settings.

    update_metadata

  4. Confirm changes

    The AI verifies that the new settings match what you asked for and reports back.

    get_metadataupdate_metadata

Try it

Copy these to start.

Use these prompts to kick off the process.

Starting points

These are basic ideas. Swap out the project names or specific navigation labels to match your actual docs.

Mintlify Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_M9aK5cxlba7CD7hPXRmZkQWDWejHvt8xp1tZNLBC/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Mintlify capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "mintlify-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_M9aK5cxlba7CD7hPXRmZkQWDWejHvt8xp1tZNLBC/mcp"
    }
  }
}
Copy into chat04

  • Show me the current metadata for my 'api-docs' project.

  • Update the navigation in my 'user-guide' project to add a new section called 'Advanced Features'.

  • Change the site title in my 'dev-portal' project to 'Internal Engineering Docs'.

  • Reorganize the sidebar for 'mobile-app-docs' so that 'Getting Started' is at the top.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect Mintlify once, then ask.

Just link your account through the Vinkius dashboard. Your credentials stay encrypted, and you can start chatting with your docs immediately.

Connect Mintlify to your AI

FAQ

How this task behaves

  • 01

    Can the AI edit my actual Markdown files?

    No. This Connector only manages Mintlify configuration settings like metadata and navigation. You still manage your content files manually.

  • 02

    Will the AI delete my entire navigation menu?

    The AI only performs the specific updates you request. It doesn't have the capability to wipe your configuration unless you explicitly tell it to.

  • 03

    Does the AI need my Mintlify login?

    No. You connect via Vinkius, which handles the connection securely. Your AI client never sees your raw login credentials.

  • 04

    Can I use this with any AI client?

    Yes, as long as the client supports the Model Context Protocol (MCP).

  • 05

    How do I see the changes after the AI runs a command?

    The AI will confirm the update, and you can see the results live on your Mintlify documentation site.

  • More questions about Mintlify? See everything the Mintlify Connector can do

Connect Mintlify to Claude, Cursor, ChatGPT & more