• STRUCTURE
  • DISCOVERY
  • AUDIT
  • HUMAN

How to map documentation hierarchy with your AI

Connect GitBook to your AI client to let it explore your docs. Once connected, your agent can see how your content is organized.

Ask AI about this page

Short answer

How can I map my GitBook hierarchy with AI?

Your AI uses the GitBook MCP to pull lists of your organizations, spaces, collections, and pages. It then builds a structural map so you can find exactly where specific information lives. You get a clear view of your content layout.

The mapping outcomes

Where your data lands

The AI turns raw GitBook data into a structured mental model of your docs.

STRUCTURE

Full hierarchy map

The AI identifies every space and collection. You get a clear picture of how your documentation is nested.

DISCOVERY

Page location tracking

The agent finds exactly which pages belong to which collections. This makes finding specific topics much easier.

AUDIT

Content gaps

By seeing the full list of pages, your AI can spot where documentation is missing or disorganized.

HUMAN

Manual reorganization

The AI only reads the structure. You still handle the actual moving or deleting of pages in GitBook.

The workflow

What your AI does when the connection is live.

The AI moves from the top level of your GitBook account down to individual pages.

  1. Identify the account

    The agent starts by finding all organizations you have access to.

    list_organizations

  2. Scan the spaces

    It looks inside those organizations to find every individual space.

    list_spaces

  3. Locate collections

    The AI drills into spaces to see how you've grouped your content into collections.

    list_collections

  4. Index the pages

    Finally, it lists every page within those collections to complete the map.

    list_pages

Try it

Copy these to start.

Use these prompts to begin exploring your documentation.

Starting points

Replace the specific names like 'Engineering' or 'Product Docs' with your actual GitBook names.

GitBook Connector

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

Connector linkhttps://edge.vinkius.com/vk_preview_bRfoqKlN0JQsHziOen3XBSPPRUJeuiKs7Qebu7XE/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 — GitBook capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "gitbook-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_bRfoqKlN0JQsHziOen3XBSPPRUJeuiKs7Qebu7XE/mcp"
    }
  }
}
Copy into chat04

  • List all the spaces in my Engineering space.

  • Show me the hierarchy of the Product Docs collection.

  • Which pages are currently inside the API Reference collection?

  • Map out the entire structure of my main organization.

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

Start here

Connect GitBook once, then ask.

Click the link to connect your account. Your credentials stay encrypted, and you can immediately start asking your AI about your docs.

Connect GitBook to your AI

FAQ

How this task behaves

  • 01

    Can the AI edit my GitBook pages?

    No. This MCP only allows the AI to list and read your organizational structure.

  • 02

    Can the AI delete a collection?

    No. The AI has no tools to delete or modify your GitBook content.

  • 03

    Does the AI see the content inside the pages?

    The AI can see the list of pages and their hierarchy, but it only reads the content if you specifically ask it to look at a page's details.

  • 04

    Can I use this with Claude?

    Yes, as long as you are using an MCP-compatible client like Claude Desktop.

  • 05

    How does the AI know which organization to look at?

    The AI uses the list_organizations tool to see everything available to you and then asks you to specify which one you want to explore.

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

Connect GitBook to Claude, Cursor, ChatGPT & more