• MAP
  • NAV
  • GAP
  • HUMAN

How to query and audit site structure with your AI

Connect Cockpit to your AI client once. After that, your agent can map out your entire site architecture or find specific pages.

Ask AI about this page

Short answer

How can I use my AI to audit my site structure?

Your AI uses Cockpit tools to pull sitemaps, list routes, and inspect navigation menus. You get a clear map of your site's organization and can quickly spot orphaned pages or broken hierarchies.

Where every issue lands.

Audit outcomes

The AI turns raw CMS data into organized reports for you.

MAP

Visual site maps

The AI pulls the full sitemap and lists all routes. You get a complete view of every URL in your system.

NAV

Menu integrity

By inspecting menus, the AI finds broken links or missing items. You see exactly how users navigate your site.

GAP

Orphaned pages

The AI compares the page list against the sitemap and menus. You find pages that aren't reachable through standard navigation.

HUMAN

Manual fixes

The AI identifies the problems, but you decide how to restructure the content. You handle the actual changes in the Cockpit UI.

The workflow

What your AI does when the request arrives.

Your agent acts as a bridge between your questions and the Cockpit API.

  1. Map the footprint

    The AI identifies every URL and path currently live on your site.

    get_sitemaplist_routes

  2. Check navigation

    It looks at your menus to see how pages are grouped and linked.

    list_menusget_menu

  3. Verify page content

    The AI looks up specific pages to check their metadata or hierarchy.

    get_page_by_route

  4. Report findings

    The AI summarizes the structure and highlights any logical errors it finds.

    list_pages

Try it

Copy these to start.

Paste these prompts into your chat to begin the audit.

Starting points

These are just ways to start. Swap out the specific menu or route names to match your actual Cockpit setup.

Cockpit CMS Connector

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

Connector linkhttps://edge.vinkius.com/vk_preview_fNofB8llpPLT1euBpo7Rm0YeaMUb0DsJJHBkdNZ7/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 — Cockpit CMS capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "cockpit-self-hosted-headless-cms-api-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_fNofB8llpPLT1euBpo7Rm0YeaMUb0DsJJHBkdNZ7/mcp"
    }
  }
}
Copy into chat04

  • List all the routes in my Cockpit instance and tell me if any look redundant.

  • Get the main navigation menu and check if all the links lead to valid pages.

  • Pull the sitemap and find any pages that aren't included in the primary menu.

  • Check the structure of the 'Products' menu and list all pages under that section.

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

Start here

Connect Cockpit once, then ask.

You only need to link your Cockpit instance one time. Your credentials stay encrypted, and you can immediately start asking questions about your site.

Connect Cockpit to your AI

FAQ

How this task behaves

  • 01

    Can the AI change my site structure?

    No. The AI can only read data from Cockpit. You must make all structural changes manually in your CMS.

  • 02

    Can the AI delete pages?

    No. There are no tools provided to delete or modify content. The AI is for auditing and inspection only.

  • 03

    How does it know which pages are broken?

    The AI compares the routes found in the sitemap and menus against the actual list of pages available in Cockpit.

  • 04

    Does it see my private content?

    The AI can only see what your Cockpit API permissions allow it to access.

  • 05

    Can I use this with any AI client?

    Yes, as long as you are using an MCP-compatible client like Claude, Cursor, or Windsurf.

  • More questions about Cockpit? The Connector page answers them. See everything the Cockpit Connector can do

Connect Cockpit CMS to Claude, Cursor, ChatGPT & more