OneMCP 使用指南

[TOC] ### 什么是 OneMCP？ OneMCP是 ShowAPI（万维易源）提供的一项创新服务。它允许您根据特定的业务需求，将平台上的多个独立 API 接口灵活地打包成一个统一、强大的多能力平台（MCP）服务。 ### 核心价值 对于大语言模型（LLM）应用（如 [Chatbox](https://chatboxai.app/zh "Chatbox")、[Cherry Studio](https://www.cherry-ai.com/ "Cherry Studio") 等）而言，OneMCP 极大地简化了在特定场景下获取和编排 API 数据的流程。您只需集成一个 OneMCP 服务，就能让大模型在处理相关问题时，自动、智能地调用多个后台接口，获取实时、准确的业务数据，从而提供更精准、更全面的回答。 **例如**，您可以创建一个“智慧出行” OneMCP，将天气查询、景点推荐、空气质量和节假日信息等多个 API 打包在一起。当用户提问“周末去北京旅游有什么建议”时，AI 便能通过此 MCP 一次性获取所有相关数据，为用户提供综合性的出行规划。  ## 2. 快速开始：核心概念 在开始之前，请确保您已了解以下核心概念： - **MCP 服务地址 (Endpoint URL)**：这是您创建的 OneMCP 服务的唯一调用地址，您需要将其配置到大模型工具中。 - **AppKey**：这是您在 ShowAPI 平台的个人身份凭证，用于认证您的 API 调用。[去获取AppKey](https://www.showapi.com/console#/myApp "去获取AppKey") - **计费方式**：OneMCP服务本身免费，接口按原套餐计费被调用时才计费 **服务地址示例（仅参考）**： ``` http://www.showapi.com.cn/private_mcp/68d900000000000000001/{your_appKey} ``` **【重要】** 在后续配置中，您必须将服务地址中的 `{your_appKey}` 占位符替换为您自己的真实 AppKey。 ## 3. 创建 OneMCP 服务 您可以通过自定义创建或使用预置模板两种方式来获取 OneMCP 服务。 ### 3.1 自定义创建 如果您希望创建一个高度定制化的场景服务，请按以下步骤操作： 1. 登录 ShowAPI 控制台，进入 [AI服务 -> OneMC管理](https://www.showapi.com/console#/onemcp "AI服务->OneMCP") 。 2. 点击“去创建OneMCP”按钮，输入您的 OneMCP **名称**和**描述**，以便于识别和管理。 3. 从接口列表中，根据您的场景需求，勾选一个或多个需要打包的 API 接口（**注意您订购且有余量的接口OneMcp才能调用成功**）。 4. 点击“创建 OneMCP”，系统将为您生成一个唯一的 OneMCP 服务及其配置信息。  5.创建后即可在右侧看到配置信息，实际使用按需调整MCP服务名称 `showapi-one-mcp` 避免重复  ### 3.2 使用预置模板 为了方便您快速上手，ShowAPI 预置了两个常用的 OneMCP 场景服务，您可以直接选用： - **个人生活服务助手**：集成了天气预报 、全国城市空气质量查询、全球快递查询、节假日查询、黄历运势、生肖运势、笑话大全、周公解梦等常用生活服务接口。 - **汽车服务助手**：集成了今日油价、车辆限行查询、车型大全、车架号 VIN 查询、国际原油价格查询、天气查询、地震信息、台风最新坐标轨迹接口（出行安全提醒）相关服务接口。 您可以直接使用或编辑这两个预置的OneMCP服务  ## 4. 在大模型工具中配置 创建成功后，您需要将 OneMCP 服务地址配置到您所使用的大模型工具中，下面以 [Chatbox](https://chatboxai.app/zh "Chatbox") 为例进行说明，**注意需使用chatbox本地应用才能使用MCP服务**。 1. 在 OneMCP 管理界面，找到您刚刚创建的服务，并复制其**服务地址**。  2. 打开您本地的chatbox，点击左下的设置选项。  3. 点击左侧MCP菜单，新增一个自定义 MCP 服务，将已替换好真实 `appKey` 的服务地址粘贴到指定位置，测试后保存。   4.确保**启用**该 MCP 服务。  ## 5. 启用并进行对话测试 配置完成后，您可以开始在聊天中验证 OneMCP 的效果。 1. 确保您刚刚配置的 OneMCP 服务处于“启用”状态。 2. 向大模型发起与您配置场景相关的提问。 **例如**，如果您配置了包含“手机归属地”、“ip归属地”的 OneMCP，可以提问： > “手机号13888888888是哪里的？” > “106.57.233.123 的ip来自哪里” 模型应能自动通过 OneMCP 获取归属地数据，并将结果自然地融合在回答中。  ## 6. 最佳实践与高级技巧 - **接口选择**：以“覆盖核心数据”为原则，避免一次性纳入过多不相关的接口，保持场景的专注性。 - **错误处理**：当对话返回异常时，可关注工具调用中错误信息： - `showapi_res_code=-1004`、`showapi_res_code=-1006`：通常是 `appKey` 错误或权限不足。 - `showapi_res_code=-1007`：没有在ShowAPI订购相应接口，无法调用 - **安全管控**：您的 `appKey` 是重要凭证，请妥善保管，切勿泄露或硬编码在客户端代码中。 ## 7. 常见问题 (FAQ) **Q1: 配置后为什么没有生效？** **A:** 请按以下步骤排查： 1. **检查 AppKey**：确认您填入的 `appKey` 是否正确无误，且服务地址中不应包含花括号 `{}`。 2. **检查启用状态**：确保在大模型工具中，该 MCP 服务已处于“启用”状态。 3. **检查场景相关性**：您的提问是否与 OneMCP 中包含的 API 功能相关。不相关的问题不会触发调用。 4. **检查工具调用中的错误信息**：没有在ShowAPI订购接口或者接口资源包余量不足等错误。 **Q2: 在哪里可以找到我的 AppKey？** **A:** 您可以登录 [ShowAPI官网](https://www.showapi.com)，在[“用户中心” -> “我的应用”](https://www.showapi.com/console#/myApp "“用户中心” -> “我的应用”")中找到您的 AppKey。 **Q3: 如何确认 MCP 已被正确调用？** **A:** 部分大模型工具提供插件调用日志或调试模式，您可以开启相关功能，观察当您提问时，工具是否发起了对 OneMCP 服务地址的网络请求。 感谢您使用 OneMCP 服务，如有任何疑问，欢迎随时联系我们的技术支持。