Skip to main content
If your product documentation is published with Mintlify, you can connect the docs site to Exec. Exec imports every page of the site into your Knowledge Hub as a source and keeps it in sync. Synced pages are searchable, available to the AI agent, and can be used in roleplays like any other source.
The Mintlify integration is in alpha.

Before you start

  • You need to be a workspace admin to connect a docs site.
  • If your docs site is public, you only need its URL.
  • If your docs site requires readers to sign in, create a client for Exec first. In your Mintlify dashboard, go to Project settings → Docs MCP and create a client. The client has read-only access. Keep its client ID and client secret ready.

Connecting a docs site

1

Open Integrations

Go to Settings → Integrations from the workspace sidebar and find the Mintlify card.
2

Enter your docs site URL

Click the + button on the Mintlify card. In Docs Site URL, enter the address of your docs site, for example https://docs.acme.com.
3

Add credentials if your site needs a sign-in

For a public site, leave Client ID (optional) and Client Secret (optional) empty. For a site behind a sign-in, paste the client ID and client secret you created in Mintlify. Enter both or neither.
4

Connect

Click Connect. Exec checks the site and starts the first sync right away. The card shows Syncing… while pages are imported, then Last synced with the time of the last completed sync.
You can connect more than one docs site to the same workspace. Each site appears as its own entry in the Mintlify panel.
Exec syncs every page the connection can read, including pages limited to specific groups in Mintlify. Everyone in your workspace can see the synced pages in the Knowledge Hub.

What gets synced

There is no page picker. Exec imports every page of the docs site as its own source, with the page title as the source title. Each synced page keeps a link back to the original, so you can open it on your docs site with Open in Mintlify. To find synced pages, open Filters in the Knowledge Hub, choose Source, and select Mintlify. The first sync of a large docs site can take several runs to finish, because Exec imports a limited number of pages per run.

Keeping content in sync

Exec checks each connected docs site for changes every 15 minutes. New and changed pages are imported, and pages removed from the docs site are removed from the Knowledge Hub. To sync right away, open the Mintlify card, click the … menu next to the docs site, and choose Sync Now. Sync Now is unavailable while a sync is already running. Synced pages do not have a per-page Resync button. Mintlify remains the source of truth. If you delete a synced page in Exec, the next sync brings it back. To remove a page for good, remove it from your docs site or disconnect the site.

Reconnecting

If Mintlify rejects the stored credentials, for example after you rotate the client secret, the card shows Reconnect Required. Open the Mintlify card, click Reconnect next to the docs site, enter the new client ID and client secret, and click Reconnect. Your docs site URL is filled in for you.

Disconnecting

You can disconnect a docs site at any time from Settings → Integrations. Disconnecting removes that site’s synced pages from the Knowledge Hub.

Getting help

Questions about the Mintlify integration? Contact us at [email protected].