---
title: "连接 Mintlify Admin MCP"
summary: "连接 https://mcp.mintlify.com 并通过 OAuth 登录，管理文档与导航。只读文档检索需使用独立的 mintlify-docs 配置。"
category: mcp
level: starter
surfaces: [cli, app, ide]
tags: ["MCP", "Mintlify", "OAuth", "HTTP"]
canonical: /tips/mintlify-admin-mcp/
---

# 连接 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：

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

CLI 等价：

```bash
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。文档检索请使用独立服务名：

```bash
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。

## 来源

- [Mintlify · Admin MCP](https://www.mintlify.com/docs/ai/mintlify-mcp)
- [Mintlify · Write documentation with Codex](https://www.mintlify.com/docs/guides/codex)
- [Mintlify · Search MCP](https://www.mintlify.com/docs/ai/model-context-protocol)