From 832c1751c1b13abe947453620bf25a1fb6a3aabf Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Thu, 30 Apr 2026 22:15:47 +0000 Subject: [PATCH] Document agent identification in Mintlify MCP editor view Generated-By: mintlify-agent --- ai/mintlify-mcp.mdx | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/ai/mintlify-mcp.mdx b/ai/mintlify-mcp.mdx index 309065c47..4a8088884 100644 --- a/ai/mintlify-mcp.mdx +++ b/ai/mintlify-mcp.mdx @@ -99,6 +99,18 @@ Every Mintlify MCP session binds to a single Git branch. The flow is: Calling `checkout` again during an active session switches the session to the new branch. Use this to abandon an in-progress draft and start fresh without ending the conversation. +## See which agent is editing + +When an AI tool edits a page through the Mintlify MCP, the dashboard editor's live collaboration view shows the agent by name and icon, alongside the team member who authorized the connection. Open the `editorUrl` returned by `checkout` to watch edits stream in with the agent's avatar attached to the cursor and selection. + +The agent shown in the editor is detected from the MCP client's name during the OAuth handshake. Recognized clients include Claude, Claude Code, Cursor, ChatGPT, Codex, GitHub Copilot, Gemini, Windsurf, Cline, Roo Code, Goose, v0, Replit, and others. Unrecognized clients fall back to the client name reported by the OAuth client, with a generic AI agent icon. + +Each edit also tracks the **authorizing user**—the team member who completed the OAuth login from the AI tool. This makes it easy to tell at a glance whose Claude Code or Cursor session triggered a given change when multiple teammates are working in parallel. + + + Agent identification works for `edit_page`, `write_page`, and `create_node` calls. The editor avatar appears in real time as the agent streams edits, and the agent name persists in the session's awareness state until the connection closes. + + ## What the Mintlify MCP can do ### Content