SHOPLINE 开发者 MCP

SHOPLINE 提供了一个 Model Context Protocol(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
  • 安装任意一个支持 MCP 的 AI 工具,例如 Cursor。

Cursor

如果你安装的 AI 工具为 Cursor,客户端配置方式如下:

  1. 打开 Cursor,然后依次进入 Cursor Settings > Tools & MCP > MCP > New MCP Server,并添加以下内容:
{
"mcpServers": {
"shopline-developer-mcp": {
"command": "npx",
"args": [
"-y",
"@shoplineos/shopline-developer-mcp"
]
}
}
}
  1. 保存配置后,终止所有 Cursor 进程并重新启动 Cursor 以应用新设置。
  2. 通过查看 MCP 服务器的连接状态或提问来验证连接是否正常。

Claude Desktop

如果你安装的 AI 工具为 Claude Desktop,客户端配置方式如下:

  1. 打开 Claude Desktop。然后依次进入 Settings > Developer > Edit Config,并添加以下内容:
{
"mcpServers": {
"shopline-developer-mcp": {
"command": "npx",
"args": [
"-y",
"@shoplineos/shopline-developer-mcp"
]
}
}
}
  1. 保存配置后,终止所有 Claude Desktop 进程并重新启动 Claude Desktop 以应用新设置。
  2. 通过查看 MCP 服务器的连接状态或提问来验证连接是否正常。

Cline

如果你在 IDE 中安装了 Cline 插件,客户端配置方式如下:

  1. 打开 Cline 插件,然后依次进入 MCP Servers > Configure MCP Servers,并添加以下内容:
{
"mcpServers": {
"shopline-developer-mcp": {
"command": "npx",
"args": [
"-y",
"@shoplineos/shopline-developer-mcp"
]
}
}
}
  1. 保存配置后,终止该 IDE 所有进程并重新启动以应用新设置。
  2. 通过查看 MCP 服务器的连接状态或提问来验证连接是否正常。

使用 MCP

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

你只要告诉 AI 你想要做什么即可,示例:

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

可用工具

SHOPLINE Dev MCP 提供了以下工具:

工具描述
shopline_readme用于了解 SHOPLINE 开发者 MCP 工具的依赖关系和最佳实践。
search_shopline_docs搜索 SHOPLINE 开发者文档
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。
这篇文章对你有帮助吗?