运营商三要素实名认证 MCP 集成指南
idcard-phone-auth-mcp-integration-1389 # 运营商三要素实名认证 MCP 集成指南
> **接口**：运营商三要素 - 运营商手机号实名认证 · **apiCode**：1389 · **接入点**：1389-1
> **请求方式**：POST · **返回格式**：JSON · **计费**：按次（ret_code=0 时扣费，具体档位以官方说明为准）
> **适用人群**：AI Agent 开发者、MCP 客户端用户
> **阅读时间**：5 分钟
> **最后实测核对**：2026-09-07
---
## 核心要点
- ShowAPI 为 apiCode=1389 提供了 MCP（Model Context Protocol）服务，可在支持 MCP 的 AI 客户端中直接调用。
- MCP URL 格式：`http://www.showapi.com.cn/mcp/1389/{your_appKey}`
- 覆盖本接口全部接入点（目前仅 1389-1）。
---
## MCP 配置方法
### Cherry Studio
1. 打开 Cherry Studio，进入「设置」→「MCP 服务器」。
2. 点击「添加服务器」，填入以下配置：
```json
{
"mcpServers": {
"showapi-mcp-1389": {
"url": "http://www.showapi.com.cn/mcp/1389/YOUR_APPKEY"
}
}
}
```
3. 将 `YOUR_APPKEY` 替换为你的真实 AppKey（在 [控制台](https://www.showapi.com/console#/myApp) 获取）。
4. 保存后重启客户端，MCP 工具即可在对话中使用。
### ChatBox
1. 打开 ChatBox，进入「设置」→「MCP」。
2. 添加新的 MCP 服务器，URL 填入：
```
http://www.showapi.com.cn/mcp/1389/YOUR_APPKEY
```
3. 保存并重启。
### 其他支持 MCP 的客户端
任意支持 MCP 协议的客户端（如 Cursor、Windsurf 等）均可按上述方式配置。关键参数只有两个：
- **server name**：自定义，如 `showapi-mcp-1389`
- **server URL**：`http://www.showapi.com.cn/mcp/1389/{appKey}`
---
## MCP 工具调用示例
配置完成后，AI 客户端会自动发现 MCP 工具。典型调用方式：
### 自然语言调用
```
用户：帮我验证一下这个用户的身份：张三，身份证号 11010119900307421X，手机号 13800138000
AI：正在调用运营商三要素实名认证接口...
AI：认证结果：code=0，认证成功。归属地：山西省 临汾市，运营商：移动神州行卡。
```
### 显式工具调用（高级用户）
```json
{
"tool": "showapi_mcp_1389_auth",
"arguments": {
"name": "张三",
"idCard": "11010119900307421X",
"phone": "13800138000",
"needBelongArea": true
}
}
```
---
## OpenAPI 文档导入
除了 MCP，还可以将 OpenAPI 文档导入 Postman 或 Swagger UI，方便调试和管理。
### 下载 OpenAPI YAML
```
https://www.showapi.com/openapi/market/1389.yaml
```
### 导入 Postman
1. 打开 Postman，点击「Import」。
2. 选择「Link」标签，粘贴 YAML 地址：`https://www.showapi.com/openapi/market/1389.yaml`
3. Postman 自动识别接口并生成请求模板。
### 导入 Swagger UI
1. 打开 [Swagger Editor](https://editor.swagger.io/)。
2. 粘贴 YAML 内容或输入 URL：`https://www.showapi.com/openapi/market/1389.yaml`
3. 右侧实时预览接口文档，可直接测试调用。
---
## FAQ
**Q1：MCP 服务和直接调用 REST API 有什么区别？**
MCP 是 AI Agent 的原生协议，AI 可以直接理解和调用工具；REST API 需要手动构造 HTTP 请求。MCP 更适合 Agent 场景，REST 更适合传统应用集成。
**Q2：MCP 工具的名称是什么？**
具体工具名称由 ShowAPI MCP 服务定义，通常与接口功能对应（如 `auth_three_elements`）。配置后可在客户端的工具列表中查看。
**Q3：MCP 调用是否也按次计费？**
是的。MCP 本质上是 HTTP 调用的封装，计费规则与直接调用 REST API 一致（ret_code=0 时扣费）。
**Q4：一个 appKey 可以配置多个 MCP 服务器吗？**
可以。每个接口（apiCode）有独立的 MCP URL，你可以在同一客户端配置多个 MCP 服务器，分别对应不同的接口。
**Q5：MCP 服务支持哪些客户端？**
目前已验证 Cherry Studio、ChatBox。其他支持 MCP 协议的客户端理论上均可使用。
---
## 下一步阅读
- [快速开始：5 分钟完成第一条实名校验](https://www.showapi.com/guides/idcard-phone-auth-quickstart-1389) —— REST API 直接调用方式
- [完整错误码对照表](https://www.showapi.com/guides/idcard-phone-auth-response-codes-1389) —— MCP 调用时的错误排查
- [按次计费下的缓存策略](https://www.showapi.com/guides/idcard-phone-auth-cache-cost-1389) —— MCP 高频调用时如何省钱
---
**- 本系列共 6 篇**：查看[运营商三要素实名认证指南总目录](https://www.showapi.com/guides/idcard-phone-auth-guides-1389)
