连接 Mintlify Admin MCP

连接 https://mcp.mintlify.com 并通过 OAuth 登录,管理文档与导航。只读文档检索需使用独立的 mintlify-docs 配置。

这是 Mintlify Admin MCP:改文档内容、导航、docs.json 和部分仪表盘设置,并能开 PR。文档包含 Codex 配置说明。远程入口是 https://mcp.mintlify.com,无需添加 /mcp 后缀。Streamable HTTP。必须交互 OAuth,官方没给 API key / bearer 路径。

官方 TOML:

[mcp_servers.mintlify]
url = "https://mcp.mintlify.com"
enabled = true

CLI 等价:

codex mcp add mintlify --url https://mcp.mintlify.com
codex mcp login mintlify

桌面走 Settings → Integrations & MCP,名字填 mintlify,URL 填同一条。CLI / 桌面 / IDE 共用这份配置。若浏览器未打开,运行 codex mcp login mintlifycodex mcp list 应列出 mintlify。TUI 里 /mcp 看是否还要授权。

Admin 和文档检索使用不同入口,需分别配置服务名:

用途 URL 官方写在
Admin(写文档、开 PR) https://mcp.mintlify.com Admin MCP 的 Codex 专节
文档检索(只读) https://mintlify.com/docs/mcp 写作指南 / Search MCP 的 Codex 示例

写作指南和 Search MCP 页的 Codex 示例都是 [mcp_servers.mintlify] 指向 https://mintlify.com/docs/mcp。同名配置会覆盖 Admin。文档检索请使用独立服务名:

codex mcp add mintlify-docs --url https://mintlify.com/docs/mcp

自己站点的检索 MCP 在站点域名后面加 /mcp,再另起表名,不要覆盖 mintlify。全站索引是 https://index.mintlify.com,又是第三台。

Admin 会改文档。会话先 checkout 绑到一条分支,再改,再用 save 开 PR。部署管理(工作流、成员、账单、集成)是 Code mode,立刻写进线上,没有 PR。

移除连接:删除 ~/.codex/config.toml 里的 [mcp_servers.mintlify]。仪表盘 Settings → Security & access → Connected apps 撤销授权。已创建的 PR 会保留。

网页 Cloud 不读取 ~/.codex/config.toml。配置后用 codex mcp get mintlify 看 url 是 https://mcp.mintlify.com,传输是 streamable_http。OAuth 路径的 Auth 应显示 OAuth。

来源