连接 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 mintlify。codex 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。