docs: add admin MCP page#5587
Open
mintlify[bot] wants to merge 3 commits intomainfrom
Open
Conversation
Mintlify-Source: dashboard-editor
Contributor
Author
|
Preview deployment for your docs. Learn more about Mintlify Previews.
|
Contributor
|
Preview deployment for your docs. Learn more about Mintlify Previews.
|
ethanpalm
requested changes
Apr 29, 2026
Collaborator
ethanpalm
left a comment
ethanpalm
left a comment
There was a problem hiding this comment.
just requesting changes to confirm the name
| @@ -0,0 +1,157 @@ | |||
| --- | |||
| title: "Admin MCP" | |||
Collaborator
There was a problem hiding this comment.
Are we confirmed naming this Admin MCP?
| @@ -0,0 +1,157 @@ | |||
| --- | |||
| title: "Admin MCP" | |||
| description: "Let AI tools edit your Mintlify documentation directly with the admin MCP server. Connect Claude, Cursor, or any MCP client to draft, save, and ship doc changes." | |||
Collaborator
There was a problem hiding this comment.
Suggested change
| description: "Let AI tools edit your Mintlify documentation directly with the admin MCP server. Connect Claude, Cursor, or any MCP client to draft, save, and ship doc changes." | |
| description: "Let AI tools directly edit your content on Mintlify with the MCP server. Connect Claude, Cursor, or any MCP client to draft, save, and ship doc changes." |
TBD on the confirmed name
| --- | ||
| title: "Admin MCP" | ||
| description: "Let AI tools edit your Mintlify documentation directly with the admin MCP server. Connect Claude, Cursor, or any MCP client to draft, save, and ship doc changes." | ||
| keywords: ["admin MCP", "write access", "AI editing", "Claude", "Cursor", "branch", "pull request"] |
Collaborator
There was a problem hiding this comment.
Suggested change
| keywords: ["admin MCP", "write access", "AI editing", "Claude", "Cursor", "branch", "pull request"] | |
| keywords: ["MCP", "write access", "AI", "editing", "Claude", "Cursor", "branch", "pull request"] |
|
|
||
| ## About the admin MCP | ||
|
|
||
| The admin MCP server gives AI tools write access to your Mintlify documentation. Where the [documentation MCP server](/ai/model-context-protocol) lets AI tools read and search your published docs, the admin MCP lets them propose changes: edit pages, restructure navigation, update `docs.json`, and open pull requests. |
Collaborator
There was a problem hiding this comment.
Suggested change
| The admin MCP server gives AI tools write access to your Mintlify documentation. Where the [documentation MCP server](/ai/model-context-protocol) lets AI tools read and search your published docs, the admin MCP lets them propose changes: edit pages, restructure navigation, update `docs.json`, and open pull requests. | |
| The admin MCP server gives AI tools write access to your Mintlify content. Where the [documentation MCP server](/ai/model-context-protocol) lets AI tools read and search your published content, the admin MCP lets them propose changes: edit pages, restructure navigation, update `docs.json`, and open pull requests. |
Starting to replace documentation with content as part of expanding to cover more use cases.
|
|
||
| The admin MCP server gives AI tools write access to your Mintlify documentation. Where the [documentation MCP server](/ai/model-context-protocol) lets AI tools read and search your published docs, the admin MCP lets them propose changes: edit pages, restructure navigation, update `docs.json`, and open pull requests. | ||
|
|
||
| Connect any MCP client like Claude, Claude Code, or Cursor to the admin MCP and your assistant can collaborate with you on docs the same way it collaborates on code — except every change runs through a Mintlify branch and lands in your repository as a pull request. |
Collaborator
There was a problem hiding this comment.
Suggested change
| Connect any MCP client like Claude, Claude Code, or Cursor to the admin MCP and your assistant can collaborate with you on docs the same way it collaborates on code — except every change runs through a Mintlify branch and lands in your repository as a pull request. | |
| Connect any MCP client like Claude, Claude Code, or Cursor to the admin MCP to collaborate on your Mintlify content with the same tools you use to write code. When you use the MCP server, all changes happen on a branch and require a pull request to merge. |
| </Accordion> | ||
|
|
||
| <Accordion title="Use slugs for branch names"> | ||
| Pass a `slug` to `checkout` (e.g. `add-quickstart`) so the auto-generated branch is human-readable. Without it, the branch name is derived from the session token and is hard to recognize in your repo. |
Collaborator
There was a problem hiding this comment.
Suggested change
| Pass a `slug` to `checkout` (e.g. `add-quickstart`) so the auto-generated branch is human-readable. Without it, the branch name is derived from the session token and is hard to recognize in your repo. | |
| Pass a `slug` to `checkout` (for example, `add-quickstart`) so the auto-generated branch is human-readable. Without it, the branch name derives from the session token and is hard to recognize in your repository. |
| </Accordion> | ||
|
|
||
| <Accordion title="Keep sessions focused"> | ||
| One session, one logical change. Smaller sessions produce smaller, easier-to-review pull requests. Use `discard_session` and `checkout` again to pivot to unrelated work. |
Collaborator
There was a problem hiding this comment.
Suggested change
| One session, one logical change. Smaller sessions produce smaller, easier-to-review pull requests. Use `discard_session` and `checkout` again to pivot to unrelated work. | |
| Keep each session focused to one change. Smaller sessions produce easier to review pull requests and preserve agents' context windows. Use `discard_session` and `checkout` again to pivot to unrelated work. |
| </AccordionGroup> | ||
|
|
||
| <Warning> | ||
| Sessions hold an in-memory branch on the Mintlify side. If a session is abandoned without a `save` or `discard_session`, the branch persists until your next checkout overwrites it. Avoid leaving stale `admin-mcp/*` branches in your repository — clean them up periodically. |
Collaborator
There was a problem hiding this comment.
Suggested change
| Sessions hold an in-memory branch on the Mintlify side. If a session is abandoned without a `save` or `discard_session`, the branch persists until your next checkout overwrites it. Avoid leaving stale `admin-mcp/*` branches in your repository — clean them up periodically. | |
| Sessions hold an in-memory branch on the Mintlify side. If you abandon a session without saving or discarding it, the branch persists until your next checkout overwrites it. Avoid leaving stale `admin-mcp/*` branches in your repository. Clean them up periodically. |
| </Accordion> | ||
| </AccordionGroup> | ||
|
|
||
| <Warning> |
Collaborator
There was a problem hiding this comment.
Suggested change
| <Warning> | |
| <Note> |
Changing to a note since this isn't really destructive, just clutter
|
|
||
| <Warning> | ||
| Sessions hold an in-memory branch on the Mintlify side. If a session is abandoned without a `save` or `discard_session`, the branch persists until your next checkout overwrites it. Avoid leaving stale `admin-mcp/*` branches in your repository — clean them up periodically. | ||
| </Warning> No newline at end of file |
Collaborator
There was a problem hiding this comment.
Suggested change
| </Warning> | |
| </Note> |
![cursor[bot]](https://avatars.githubusercontent.com/in/1210556?s=60&v=4){kind=small}
There was a problem hiding this comment.
Cursor Bugbot has reviewed your changes and found 1 potential issue.
❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.
Reviewed by Cursor Bugbot for commit 2ef0590. Configure here.
| "agent/use-cases" | ||
| ] | ||
| }, | ||
| "ai/mintlify-mcp", |
There was a problem hiding this comment.
Page placed in wrong navigation section
High Severity
The ai/mintlify-mcp entry is added inside the "Create content" group (between the Agent subgroup and the Components subgroup), but the PR description states it belongs in the "Optimize" section right after ai/model-context-protocol. The page will render in the wrong place in the site navigation, making it hard for users to discover.
Reviewed by Cursor Bugbot for commit 2ef0590. Configure here.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Adds a new page at
/ai/admin-mcpcovering what the admin MCP server is, how it differs from the read-only documentation MCP, how to connect Claude / Claude Code / Cursor, the session lifecycle (checkout → edit → diff → save), the full tool catalog, example prompts, and best practices.Sits in the Optimize section right after Model Context Protocol.
Mintlify
0 threads from 0 users in Mintlify
Note
Cursor Bugbot is generating a summary for commit 9114d98. Configure here.