常见问题

为什么 MCP 创建/编辑笔记时，总是参数错误？

能否顺利理解用户的意图，根据文章素材（文字、图片、音频等），组装出 MCP 所需的参数，这个很大程度取决于大模型的能力，如果你正在使用的模型就是无法组装出正确参数，其实可以尝试让大模型学习一下墨问的 API 文档。

墨问的 API 文档是部署在 Apifox 的，而 Apifox 也贴心的为文档提供了 MCP 服务。所以我们可以同时安装 Apifox 的文档 MCP，在请求墨问 MCP 报错时，让大模型到 Apifox 的 MCP 服务中，学习一下 API 文档，然后再进行重试。

墨问 API 文档的 MCP 配置如下：

{
  "mcpServers": {
    "墨问API文档助手": {
      "command": "npx",
      "args": [
        "-y",
        "apifox-mcp-server@latest",
        "--site-id=5448779"
      ]
    }
  }
}

这个 MCP 依赖了 npx 指令，这个指令通常包含在 nodejs 的发行版中。关于 nodejs 的安装，可以参考官方的安装指引

配置好的 MCP Tools 如图：

最后在我们跟大模型互动的过程中，可以添加这样一句：

通过这样的方式，大模型在学习过 API 文档之后，会在一定程度上增强理解力，组装出正确参数的几率就更大了一些。

学习过 API 文档之后，还是不行，怎么办？

Prompt 的设计原则有一条叫Step By Step，也就是把复杂的问题进行拆解，让大模型一步一步的完成。

如果学习了 API 文档之后还是不行，可以尝试“训练”一下它，譬如先创建一条只包含一个段落的简单笔记，然后不断的编辑笔记，增加新的段落，增加插图等等，最终完成整篇笔记。

大模型以及部分 IDE 的 CodeBase 都有会记住正确 case 的能力，有了上面“训练”的过程，后面再逐步让大模型做更复杂的事情，可能效果会好很多。

如果还是不行，就换更聪明的模型吧... -_-#

为什么 MCP 创建/编辑笔记时，总是参数错误？#

学习过 API 文档之后，还是不行，怎么办？#

为什么 MCP 创建/编辑笔记时，总是参数错误？

学习过 API 文档之后，还是不行，怎么办？