# 快递100

查询物流轨迹、预估运费与时效，并支持获授权的上门取件下单。

- 类型：MCP · Skill
- 权限：涉及资金
- 门槛：需 API Key、需授权账号、需申请开通
- 官方入口：https://api.kuaidi100.com/document/how-to-use-mcp-service
- 官方仓库：https://github.com/kuaidi100-api/kuaidi100-MCP
- 网页详情：https://guanmo-ai.github.io/awesome-agent-mcp/s/kuaidi100/

仅供参考，官方身份核验不代表接入实测；以厂商文档为准，密钥和登录在本地完成。下单、付款前须用户确认。

## 接入前准备

查询需快递100账号及 Key；真实上门取件还需商务完成 Key 加白。该 MCP 可创建寄件订单，运费线下支付，不能因未在线扣款就按只读处理。

## 接入步骤

1. 登录官方 API 管理后台取得自己的授权 Key。 [官方入口](https://api.kuaidi100.com/blogroll/kuaidi100-mcp-ai-agent-pickup-api)
2. 要寄件时先联系商务开通加白，按本人获授权的 SSE 配置连接；通用查询 HTTP 配置不能当作已开通寄件。 [官方入口](https://api.kuaidi100.com/blogroll/kuaidi100-mcp-ai-agent-pickup-api)

## 验证方法

先执行物流查询或经额度许可的价格估算；不创建或取消真实寄件单测试连接。

指引核对于 2026-11-05，不是本项目实测结果。

## 费用

所查官方接入资料未能确认该工具的具体调用费用和免费额度；实际费用按官方产品规则核实。 [官方来源](https://api.kuaidi100.com/document/how-to-use-mcp-service)（核对日期：2026-11-05）

## 安装配置

### JSON

```
{
  "mcpServers": {
    "kuaidi100": {
      "type": "http",
      "url": "https://api.kuaidi100.com/mcp/streamable?key=${KUAIDI100_KEY}"
    }
  }
}
```

### Claude Code

```
claude mcp add --transport http 'kuaidi100' 'https://api.kuaidi100.com/mcp/streamable?key=${KUAIDI100_KEY}'
```

### Codex

```
# ~/.codex/config.toml
[mcp_servers.kuaidi100]
url = "https://api.kuaidi100.com/mcp/streamable?key=<你的快递100Key>"
```

JSON 示例用于 Claude Code 的 .mcp.json；${VAR} 从启动客户端的环境读取。Codex 的环境变量也须在启动进程中可用，不能将变量名替换成密钥值。

命令会进入 shell 历史，请在本地执行，不要分享。保留命令中的 ${VAR} 引用；Codex 不支持在 URL 或命令参数中展开这些引用，此处保留待本地处理的占位符。

- [官方 Skill](https://clawhub.ai/kuaidi100-api/kuaidi100-skill)

## 核验与来源

2026-11-05 核对官方身份：[依据](https://api.kuaidi100.com/document/how-to-use-mcp-service)。快递100官方上门取件 MCP 公告；可真实寄件下单、线下付运费，需账号 Key 及商务加白。

官方原文摘录（2026-11-05，来自上述依据）：

```
"url": "https://api.kuaidi100.com/mcp/streamable?key=YOUR_API_KEY"
```

- [厂商官方复核来源](https://api.kuaidi100.com/blogroll/kuaidi100-mcp-ai-agent-pickup-api)

[使用说明与免责声明](https://guanmo-ai.github.io/awesome-agent-mcp/#disclaimer)