跳转到主要内容
Base 目前处于 beta 阶段,可能会发生变化。
Base 是 Mintlify 中的一种项目类型。它们通常用作你的团队及其协作智能体的知识库。将规范、运维手册、入职指南和其他内部团队知识保存在 Base 中。通过 MCP 将你的 Base 连接到 Claude、ChatGPT、Cursor 和其他 AI 工具,让智能体与你的团队使用相同的信息开展工作。 Base 使用与文档项目相同的编辑器和智能体。相同的工作流程适用于这两种项目类型。

Base 与文档有何不同

Base 是两种项目类型之一。由于 Base 没有站点,仅适用于站点的设置(例如自定义域名、助手、导出和分析)在 Base 中不可用。部分 AI 功能在 Base 中不可用,包括 Autopilot 和自动化。 Base 还提供文档项目所没有的功能。你可以验证页面,让团队了解哪些页面是最新的,还可以为页面添加属性,例如其负责人。 你只能使用页面和分组来组织 Base。你无法使用 tabs、anchors、versions、languages 或其他导航元素。

页面的存储位置

Base 中的编辑器侧边栏包含三种类型的页面。
  • Teamspace:整个组织共享的页面。Mintlify 将 Teamspace 页面作为 MDX 文件存储在 Git 仓库中,并自动提交你的编辑。
  • Personal:用于存放草稿或仅供你自己使用的内容的私有页面。私有页面不存储在 Git 中。除非你与同事共享,否则它们只对你可见。如果你想共享私有页面,请打开其选项菜单,选择 Move,然后选择 Teamspace 或其中的某个分组。
  • Shared with me:同事直接与你共享的页面。
新的 Base 使用由 Mintlify 为你托管的 Git 仓库。若要使用你自己的工具在本地处理 Base,请在 Git 设置中连接 GitHub、GitLab、Bitbucket 或 Azure Repos 仓库。你推送到已连接仓库的提交会更新你的 Base。

人员和智能体如何参与贡献

你的团队可以在任何工作场所更新 Base:
  • Editor:在浏览器或桌面应用中编写和组织页面,并获得智能体的帮助。
  • MCP:将 Claude、ChatGPT、Cursor 或其他 AI 工具连接到 admin MCP,即可在对话中阅读、搜索和编辑你的 Base。
  • Slack:向 Slack 中的 Mintlify 智能体提问,它会根据你的 Base 作答,你也可以让它更新页面。
  • Git:克隆 Base 的仓库,并使用任意编辑器或编码智能体编辑 MDX 文件。

将页面分享到网络

公开链接需要你的 base 使用 Pro 或 Enterprise 套餐。
你可以通过公开链接与组织外部的人员分享 base 页面。任何拥有该链接的人无需登录即可查看页面,但无法编辑。 公开链接默认处于关闭状态。管理员必须先开启该设置,其他人才能分享页面。
  1. 前往你的 Security 设置。
  2. 在 Sharing 部分中,开启 Allow public links。
如果管理员关闭 Allow public links,所有公开链接都会失效,直到管理员重新开启该设置。

分享页面

如果你拥有编辑者或管理员角色,可以分享 Teamspace 页面。如果你对私有页面拥有 Full Access 权限,可以分享该私有页面。
  1. 在编辑器中打开该页面。
  2. 打开 页面选项菜单。
  3. 开启 Share to web。
  4. 点击 Copy public link。
页面选项菜单。页面选项菜单。
当你分享页面时,顶部栏会显示一个 地球按钮。点击该图标即可再次复制链接。公开页面显示该页面的当前内容。 每个公开页面还提供一个供 AI 工具使用的 Markdown 版本。在公开链接末尾添加 .md 即可查看,或在请求该链接时附带 Accept: text/markdown 请求头。

停止分享页面

  1. 打开 页面选项菜单。
  2. 关闭 Share to web。
  3. 点击 Stop sharing 进行确认。
链接会立即失效。如果你再次分享该页面,Mintlify 会生成一个新链接。

功能和套餐

Base 拥有独立的 Starter、Pro 和 Enterprise 套餐,与文档项目的套餐分开。若要查看 Base 的套餐,请打开你的 Base 并前往 Billing 设置。若要升级到 Pro 或 Enterprise,管理员可以点击套餐上的 Contact us,或联系销售团队。 每个套餐都包含编辑器、Git 同步和 admin MCP。 Pro 还包含智能体和公开链接。 Enterprise 包含 Pro 的所有功能,并额外提供 SSO、SCIM、基于角色的访问控制以及其他功能。有关更多信息,请参阅定价页面。

开始使用

设置 Base

创建 Base、邀请你的团队,并连接你的 AI 工具。