---
title: "SHOPLINE 开发者 MCP"

doc_type: static
doc_category: static
doc_version: v20270301
source_url:
  html: 'https://developer.shopline.com/zh-hans-cn/docs/apps/development-tool/shopline-developer-mcp'
  md: 'https://developer.shopline.com/zh-hans-cn/docs/apps/development-tool/shopline-developer-mcp.md'
---
# SHOPLINE 开发者 MCP

SHOPLINE 提供了一个 [Model Context Protocol](https://modelcontextprotocol.io/docs/getting-started/intro)（MCP）服务器，你可以在 Cursor 等支持 AI 编程的 IDE 或其他支持 MCP 的 AI 工具添加该 MCP。添加后，你的 AI 工具可以通过该 MCP 搜索 SHOPLINE 文档、获取 API 的参数信息和根据技术文档编写、修改代码。

## 配置 MCP 客户端

要与 SHOPLINE 开发者 MCP 服务器通信，MCP 客户端需要特定的配置。

> **备注**
>
> SHOPLINE 开发者 MCP 基于 MCP 的 STDIO（Standard Input/Output）传输机制，在本地运行，且不需要进行身份验证。

### 前提条件

- 确保你已安装版本为 18.0.0 或更高的 [Node.js](https://nodejs.org/en)。
- 安装任意一个支持 MCP 的 AI 工具，例如 Cursor。

### Cursor

如果你安装的 AI 工具为 [Cursor](https://cursor.com/)，客户端配置方式如下：

1. 打开 Cursor，然后依次进入 **Cursor** **Settings** > **Tools & MCP** > **MCP** > **New MCP Server**，并添加以下内容：

```json
{
  "mcpServers": {
      "shopline-developer-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@shoplineos/shopline-developer-mcp"
      ]
    }
  }
}
```

2. 保存配置后，终止所有 Cursor 进程并重新启动 Cursor 以应用新设置。
3. 通过查看 MCP 服务器的连接状态或提问来验证连接是否正常。

### **Claude Desktop**

如果你安装的 AI 工具为 [Claude Desktop](https://claude.ai/download)，客户端配置方式如下：

1. 打开 Claude Desktop。然后依次进入 **Settings > Developer > Edit Config**，并添加以下内容：

```json
{
  "mcpServers": {
      "shopline-developer-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@shoplineos/shopline-developer-mcp"
      ]
    }
  }
}
```

2. 保存配置后，终止所有 Claude Desktop 进程并重新启动 Claude Desktop 以应用新设置。
3. 通过查看 MCP 服务器的连接状态或提问来验证连接是否正常。

### Cline

如果你在 IDE 中安装了 [Cline 插件](https://cline.bot)，客户端配置方式如下：

1. 打开 Cline 插件，然后依次进入 **MCP Servers > Configure MCP Servers**，并添加以下内容：

```json
{
  "mcpServers": {
      "shopline-developer-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@shoplineos/shopline-developer-mcp"
      ]
    }
  }
}
```

2. 保存配置后，终止该 IDE 所有进程并重新启动以应用新设置。
3. 通过查看 MCP 服务器的连接状态或提问来验证连接是否正常。

## 使用 MCP

完成配置后，AI 工具可以通过 MCP 获取所需要技术文档或者 API 信息。

你只要告诉 AI 你想要做什么即可，示例：

- 创建商品的必填字段有哪些？
- 如何安装和使用SHOPLINE CLI？
- 如何进行应用授权？

## 可用工具

SHOPLINE Dev MCP 提供了以下工具：

| 工具                           | 描述                                                         |
| ------------------------------ | ------------------------------------------------------------ |
| shopline_readme                | 用于了解 SHOPLINE 开发者 MCP 工具的依赖关系和最佳实践。      |
| search_shopline_docs           | 搜索 [SHOPLINE 开发者文档](https://developer.shopline.com/zh-hans-cn/docs/apps/overview.md)。 |
| read_full_docs                 | 通过文档的 URL 获取一篇文档的完整内容。                      |
| search_admin_rest_endpoints    | 搜索 SHOPLINE Admin REST API 的端点。                        |
| get_rest_api_definition        | 获取 SHOPLINE Admin REST API 完整的接口规范。                |
| get_admin_rest_endpoint_detail | 通过 SHOPLINE Admin REST API 的端点获取 API 的详细信息，包括请求参数、响应参数和示例。 |
| get_graphql_schema             | 查询 SHOPLINE Storefront GraphQL API schema，返回对应的Query、Mutation和 Type。 |
| validate_graphql_codes         | 基于 SHOPLINE GraphQL API Schema 校验 GraphQL 代码。可检测语法错误、弃用字段及幻觉字段，确保代码符合 SHOPLINE API 定义与编码规范。 |
| shopline_mcp_feedback          | 发送反馈给 SHOPLINE。                                        |