MCP 接入指南

功能介绍

小白配置

接入这一步，也有 AI 帮你

不用刚看懂 MCP 是什么，就转头研究一页配置。

接入这件事，也可以请 Codex 帮忙。

发送配置话术

打开你正在使用的 Codex，复制下面整段话发过去。

服务地址、要用的工具和检查要求都写在里面了，你不用自己逐项填写。

请帮我在当前使用的 Codex 中配置 MaoMaoToken 文档 MCP，并检查是否能正常查阅文档。

服务名称：maomaotoken_docs
服务地址：https://docs.maomaotoken.com/mcp
连接方式：Streamable HTTP
身份验证：无需登录，无需 API Key
启用工具：list_documents、search_documents、read_document

请先确认当前 Codex 实际使用的配置位置，保留已有配置和其他 MCP 服务，只添加或更新这个服务，不要重复添加。
它是远程文档服务，不需要下载本站源码，也不需要部署服务端或配置模型密钥。

配置完成后，请通过 MCP 协议检查连接和上述三个工具是否可用，再浏览文章目录，搜索一个模型并读取对应文档，给我文章标题和来源链接，确认能够正常使用。不要只凭配置已写入就说接入成功，也不要用浏览器直接打开接口来判断连接是否正常。

如果需要我授权、重新加载或重启 Codex，请用简单的话告诉我下一步怎么操作；如果当前环境无法修改配置或完成连接验证，请说明具体原因和已经完成的步骤。

确认接入成功

Codex 会尝试帮你配置并检查连接。如果弹出授权提示，先看清它要改什么，确认只是添加或更新这个文档服务，再允许。

文档接入不需要模型密钥，看到要求提供密钥时，先让它说明原因。

如果它提示需要重新加载或重启，照着做，再回来让它继续检查。

哪一步看不懂，就直接问：“这一步我要点哪里？请一次只教我一步。”

等它确认能找到文章、读到正文，并给出来源链接，就可以开始问自己的问题了。

只看到“配置已保存”还不算完成，可以接着说：“请继续帮我确认，能不能实际读到一篇文档。”

下面这些问题，就是很好的开始。手动配置和接入参数放在文章后面，需要时再看。

提问示例

像平时说话一样，告诉 AI 你想做什么、手里有什么、卡在哪里。

下面的例句可以直接复制，按自己的需求修改。知道模型或通道名称时带上名称，不知道就先让 AI 帮你找。

视频模型太多了，我该选哪个？

请使用 maomaotoken_docs 查阅视频生成文档。

我手里有一张图片，想生成 720p 的视频，但分不清这些厂商、模型和通道。请先帮我找出文档里符合条件的选项，用简单的话对比它们的区别和限制，再给我选择建议。如果还缺什么条件，先问我；文档没写的不要猜，并附上来源链接。

都是 SD2.5，这几个通道到底差在哪？

请使用 maomaotoken_docs 查阅 SD2.5 相关文档，把不同版本和通道分开比较。我主要想知道：能不能传图片、支持哪些视频时长和分辨率、调用步骤有没有区别。请整理成一张容易看懂的表，列出准确名称和来源链接。没有写明的地方标注“未说明”，不要因为名字相似就当成一样。

异步、轮询、回调……能说人话吗？

请使用 maomaotoken_docs 查阅我选定的视频模型文档，如果我还没告诉你具体模型和通道，请先问我。我不懂异步、轮询、回调这些词，请结合这个通道的实际流程，用日常语言解释从提交请求到拿到视频要做什么。每一步告诉我要准备什么、会得到什么，并附上来源链接。

照着填了还是报错，能帮我看看吗？

我会贴出使用的模型和通道名称、请求内容以及报错，先去掉密钥和个人信息。请使用 maomaotoken_docs 对照对应文档检查，看看是不是漏填了内容、填错了格式，或用了这个通道不支持的参数。请用简单的话告诉我哪里有问题、为什么，以及应该怎么改。如果单靠文档不能确定原因，请明确告诉我还需要什么信息。

如果回答还是太专业，可以继续说：“请按第一次用的人能听懂的方式解释，一次只讲下一步。”

常见问题

手动配置

接入信息

这个地址用于连接 AI 工具，不是普通网页，请填写到客户端的 MCP 设置中。

Codex 配置

Codex 的默认配置文件是 ~/.codex/config.toml。如果你使用了自定义配置位置，请以当前 Codex 实际使用的文件为准。

在配置文件中追加以下内容，保留原有配置。如果已经有同名服务，更新对应配置即可，不要重复添加。

[mcp_servers.maomaotoken_docs]
url = "https://docs.maomaotoken.com/mcp"
enabled_tools = ["list_documents", "search_documents", "read_document"]
startup_timeout_sec = 20
tool_timeout_sec = 60

保存后重新加载 Codex，确认 maomaotoken_docs 已连接，并能看到浏览、搜索和读取文档三个工具，即可开始提问。

更多配置方式可参考 Codex 官方 MCP 文档。

其他客户端

使用支持远程 MCP 和 Streamable HTTP 的客户端，在 MCP 设置中添加服务：

1. 服务名称填写 maomaotoken_docs。
2. 服务地址填写 https://docs.maomaotoken.com/mcp。
3. 如果需要选择连接方式，选择 Streamable HTTP；身份验证选择无。
4. 保存并启用服务，确认连接成功。

不同客户端的设置入口可能不同。

如果只支持通过命令启动 MCP 服务，不支持填写远程地址，则不能直接按上述方式接入。

部分纯网页工具会因浏览器跨域限制无法直接连接，并不一定是你配置错了。

遇到这种情况，建议使用 Codex 等支持远程 MCP 的桌面客户端，或由服务端代为连接 MCP 的工具。

文档工具

文档会以便于 AI 阅读的 Markdown 返回，包含文章标题和来源链接。

表格、代码块、不同语言的代码 TAB、步骤和提示内容都会转换为文本，方便 AI 结合上下文理解。

搜索结果是文章片段。涉及完整参数或调用流程时，建议要求 AI 继续阅读对应章节；

文章较长时，也可以要求它继续读取，直到内容完整。