Skip to main content
Base is in beta and subject to change.

Create your base

1

Create a base from the project switcher in your dashboard

  1. In your dashboard, click the project switcher at the top of the left sidebar.
  2. Click New project.
  3. Select Base, then click Continue.
Your base is part of the same organization as your other projects.
2

Choose how you'll make updates

Select how you plan to make updates: Web editor, Local development, or MCP. This selection is only for the initial setup. You can use every method in your base later.
3

Create the project

Click Create project. Your base opens in the editor with a starter page.
Your base appears under Base in the project switcher in your dashboard.

Add pages

Create pages for your team in the Teamspace section of the sidebar. Click the plus button beside the Teamspace header and select New page. To bring in existing Markdown files, drag them from your computer onto the sidebar. When you make changes to pages in your Teamspace, Mintlify commits them to your base’s repository automatically. To draft privately first, create a page in the Personal section and move it to your Teamspace when you want it to be available to your team. For more information on editing pages, see Create and edit pages.

Invite your team

Members of your organization can access your base. To add teammates, invite them from your Members settings.

Connect your AI tools

Connect Claude, ChatGPT, Cursor, or another AI tool to your base so it can search, read, and update your pages.
  1. In your dashboard, open your base and go to the MCP settings.
  2. Under Connect, select your AI tool and follow the prompts to sign in.
When an AI tool edits your base, it commits changes the same way the editor does. For the tools available and example prompts, see Admin MCP.

(Optional) Connect your own repository

Your base starts with a repository that Mintlify hosts. To edit your base locally, connect a repository from your Git settings. Commits pushed to the connected repository update your base.