文档中心
1、注册快递100API开放平台 2、获取授权key 3、配置MCP服务 3.1、STDIO方式(推荐) 3.2、SSE方式(因客户端不同可能会不稳定) 4、使用第三方MCP客户端配置教程 4.1 在Cherry Studio中使用快递100 MCP Server 4.1.1 在Cherry Studio中添加一个新的MCP服务器 4.1.2 配置MCP服务器 4.1.3 在聊天框底部选择快递100 MCP服务 4.1.4 开始使用 4.2 在Trae中使用快递100 MCP Server 4.2.1 下载安装Trae 4.2.2 配置MCP服务器 4.3 在Dify中使用快递100 MCP Server 4.3.1 安装mcp插件 4.3.2 配置mcp服务 4.3.3 使用案例

1、注册快递100API开放平台

为了使用快递100服务,您需要先注册一个快递100账户,如果已经注册过,可以直接跳转到第二步。

image-20250515103019061

2、获取授权key

注册快递100账户后,进入企业管理后台。在授权参数位置可以看到快递100的授权key。

image-20250515103717769

3、配置MCP服务

您需要通过MCP客户端才可以使用MCP服务,快递100支持所有可以使用MCP-SSE模式的MCP客户端。您需要按以下格式进行配置。

{
  "mcpServers": {
    "kuaidi100-server": {
      "url": "http://api.kuaidi100.com/mcp/sse?key=***********"
    }
  }
}

需要根据您在快递100企业管理后台中获取的key,把url中的key进行替换。例如您在快递100企业管理后台中获取的key为A1234321,您需要配置的url地址为http://api.kuaidi100.com/mcp/sse?key=A1234321

3.1、STDIO方式(推荐)

安装python,最低版本要求为3.11; 下载安装uv组件; 通过uvx命令一步获取kuaidi100_mcp并使用

{
  "mcpServers": {
    "kuaidi100": {
      "command": "uvx",
      "args": [
        "kuaidi100-mcp"
      ],
      "env": {
        "KUAIDI100_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

3.2、SSE方式(因客户端不同可能会不稳定)

{
  "mcpServers": {
    "kuaidi100-server": {
      "url": "http://api.kuaidi100.com/mcp/sse?key=<YOUR_API_KEY>"
    }
  }
}

需要例如您在快递100企业管理后台中获取的key为A1234321,您需要配置的url地址为http://api.kuaidi100.com/mcp/sse?key=A1234321

4、使用第三方MCP客户端配置教程

4.1 在Cherry Studio中使用快递100 MCP Server

Cherry Studio 是一款集多模型对话、知识库管理、AI 绘画、翻译等功能于一体的全能 AI 助手平台。您可以在Cherry Studio中使用快递100 MCP Server。

4.1.1 在Cherry Studio中添加一个新的MCP服务器

4.1.2 配置MCP服务器

(stdio模式配置),命令输入uvx,参数输入kuaidi100-mcp,环境变量输入KUAIDI100_API_KEY=<YOUR_API_KEY>,注意替换成你自己的key。stdio模式需要安装uv,检查cherry studio配置页面右上角是否有绿色对号。 (SSE模式配置)类型选择【服务器发送事件(sse)】,URL输入http://api.kuaidi100.com/mcp/sse?key=<YOUR_API_KEY>

4.1.3 在聊天框底部选择快递100 MCP服务

4.1.4 开始使用

4.2 在Trae中使用快递100 MCP Server

4.2.1 下载安装Trae

登录https://www.trae.com.cn/,下载安装包安装。

4.2.2 配置MCP服务器

打开Trae,登录。Ctrl+U打开AI对话页,点击右上角齿轮设置页面,选择mcp。 点击添加按键。 选择手动配置。 在弹出来的配置项中,按以下格式进行配置,示例为sse模式。

//sse模式配置
{
  "mcpServers": {
    "kuaidi100-server": {
      "url": "http://api.kuaidi100.com/mcp/sse?key=***********"
    }
  }
}
//stdio模式配置
{
  "mcpServers": {
    "kuaidi100": {
      "command": "uvx",
      "args": [
        "kuaidi100-mcp"
      ],
      "env": {
        "KUAIDI100_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

选择bulid with MCP,开始使用。

4.3 在Dify中使用快递100 MCP Server

4.3.1 安装mcp插件

dify需要先安装MCP插件之后才可以使用MCP服务,我们以MCP SSE插件为例,需要先在Dify Marketplace选择插件并安装。

4.3.2 配置mcp服务

dify MCP服务配置格式如下:

{
	"kd100": {
    	"url": "http://api.kuaidi100.com/mcp/sse?key=<YOUR_API_KEY>"
    }
}
4.3.3 使用案例