MCP接入指南

开发指南

开发前必读

MCP服务正式地址：https://commercial-licensed-music-mcp--kanjian-ai.run.tools

MCP服务名称：kanjian-commercial-music-mcp

MCP用于将看见音乐的商用音乐检索、曲目详情、试听链接和授权信息能力接入到AI客户端中。

MCP不是安装到某一个模型中，而是安装或配置到支持MCP协议的AI客户端中，例如Codex、Claude Code、Cursor等。

安装完成后，需要先完成MCP授权，AI客户端才可以通过MCP调用看见音乐能力，完成音乐搜索、曲目信息查询、试听链接获取、授权链接获取等操作。

支持的客户端

Codex

Claude Code

Cursor

Dify

其他支持Streamable HTTP MCP的AI客户端

接入流程

第一步：在AI客户端中添加看见音乐MCP服务。

第二步：根据客户端提示完成MCP授权。所有客户端首次使用该MCP前都需要完成授权。

第三步：重新进入客户端或新开会话。

第四步：在会话中明确要求使用kanjian-commercial-music-mcp进行音乐检索。

接入信息

MCP服务名称：kanjian-commercial-music-mcp

MCP服务地址：https://commercial-licensed-music-mcp--kanjian-ai.run.tools

传输方式：Streamable HTTP

适用客户端：Codex、Claude Code、Cursor、Dify及其他支持MCP协议的AI客户端

主要能力：商用音乐搜索、曲目详情查询、试听链接获取、授权链接获取

MCP服务名称，用于在客户端中标识该MCP服务。建议统一使用kanjian-commercial-music-mcp。

MCP服务地址，用于客户端连接看见音乐MCP服务。

传输方式，当前服务使用Streamable HTTP。

适用客户端，表示可接入该MCP服务的AI客户端。

主要能力，表示AI客户端接入后可调用的看见音乐能力。

Codex接入

安装MCP

在终端中执行以下命令：

授权MCP

安装完成后，执行以下命令进行授权：

授权时会打开浏览器或在终端中显示授权链接，请按页面提示完成授权。

查看MCP列表

可以通过以下命令查看MCP是否安装成功：

如果列表中出现kanjian-commercial-music-mcp，表示添加成功。

使用示例

完成安装和授权后，重新进入Codex，建议新开一个会话，然后输入：

使用kanjian-commercial-music-mcp 帮我找两首中国风的歌曲

也可以输入更详细的需求：

使用kanjian-commercial-music-mcp 帮我找5首适合古风短视频配乐的商用授权音乐，要求中国风、节奏不要太快，并返回试听链接和授权链接。

Codex接入步骤说明

安装MCP，通过codex mcp add命令将看见音乐MCP服务添加到Codex。

授权MCP，通过codex mcp login命令完成账号或服务授权。

新开会话，确保Codex加载最新MCP工具。

发起请求，在提示词中明确指定使用kanjian-commercial-music-mcp。

Claude Code接入

安装MCP

在终端中执行以下命令：

查看MCP列表

可以通过以下命令查看MCP是否安装成功：

如果显示needs authentication或Failed to connect，通常表示MCP服务已经添加到本地配置，但还没有完成授权。

授权MCP

进入Claude Code后，在会话中输入：

/mcp

Claude Code会打开MCP管理菜单，例如：

Manage MCP servers

Local MCPs
> kanjian-commercial-music-mcp · needs authentication

使用方向键选中kanjian-commercial-music-mcp，然后按Enter进入授权流程。

如果客户端打开浏览器，请在浏览器中完成授权；如果终端中显示授权链接，请复制链接到浏览器打开并完成授权。

授权成功后，Claude Code会显示类似以下内容：

Authentication successful. Connected to kanjian-commercial-music-mcp.

授权完成后，建议重新打开Claude Code会话，使MCP工具状态刷新。

使用示例

完成安装和授权后，可以输入：

使用kanjian-commercial-music-mcp 帮我找两首中国风的歌曲

也可以输入：

请调用kanjian-commercial-music-mcp，帮我找适合国风品牌宣传片的商用授权音乐，返回歌曲名、艺人、推荐理由、试听链接和授权链接。

Claude Code接入步骤说明

安装MCP，通过claude mcp add --transport http添加远程MCP服务。

查看列表，通过claude mcp list确认服务是否添加成功。

进入MCP菜单，通过/mcp打开MCP管理菜单。

选择服务，选中kanjian-commercial-music-mcp并按Enter。

完成授权，根据浏览器或终端授权链接完成授权。

确认连接，看到Authentication successful. Connected to kanjian-commercial-music-mcp.表示授权成功。

发起请求，在新会话中指定使用kanjian-commercial-music-mcp。

Cursor接入

命令方式接入

可以通过Cursor命令添加MCP服务：

配置文件方式接入

也可以在Cursor的MCP配置文件中添加服务。

全局配置文件：

~/.cursor/mcp.json

项目级配置文件：

.cursor/mcp.json

配置内容如下：

{
  "mcpServers": {
    "kanjian-commercial-music-mcp": {
      "url": "https://commercial-licensed-music-mcp--kanjian-ai.run.tools"
    }
  }
}

保存配置后，重启Cursor或重新打开会话，使配置生效。

授权MCP

首次使用该MCP前，需要在Cursor中完成授权。

如果Cursor在工具列表或会话中提示需要授权，请按客户端提示打开授权页面并完成授权。授权完成后，建议重启Cursor或新开会话，使MCP工具状态刷新。

使用示例

在Cursor Agent或Chat中输入：

使用kanjian-commercial-music-mcp 帮我找两首中国风的歌曲

也可以输入：

调用kanjian-commercial-music-mcp，帮我找5首适合武侠游戏PV的商用授权音乐，要求中国风、史诗感，并返回试听链接。

Cursor接入步骤说明

添加MCP，可以使用命令方式，也可以手动编辑mcp.json。

重启客户端，确保Cursor加载最新MCP配置。

完成授权，首次使用该MCP前，根据Cursor提示完成授权。

检查MCP状态，在Cursor设置或Agent工具列表中确认MCP是否可用。

发起请求，在会话中指定使用kanjian-commercial-music-mcp。

Dify接入

当前状态

当前看见音乐Dify应用已可通过运行地址体验：

https://udify.app/chat/pZpCDElxhCxf40mT

可在Dify应用市场或对应发布入口中使用。

使用方式

打开运行地址后，在对话框中输入音乐检索需求：

帮我找两首中国风的歌曲

也可以输入更详细的需求：

帮我找5首适合古风短视频配乐的商用授权音乐，要求中国风、节奏不要太快，并返回试听链接和授权链接。

帮我找适合国风品牌宣传片的商用授权音乐，返回歌曲名、艺人、推荐理由、试听链接和授权链接。

授权说明

首次使用看见音乐MCP能力前，需要根据Dify页面或应用提示完成授权。

如果页面提示登录、授权或连接工具，请按提示完成操作。授权完成后，即可通过Dify应用调用看见音乐能力。

Dify接入步骤说明

打开运行地址，访问https://udify.app/chat/pZpCDElxhCxf40mT。

完成授权，首次使用前根据页面提示完成授权。

输入需求，在对话框中描述需要的音乐场景、风格、情绪、时长、BPM、人声或语种。

查看结果，应用会返回推荐曲目、推荐理由、试听链接和授权链接等信息。

等待审核，Dify Apps审核完成后，可通过正式应用入口使用。

通用客户端接入

如果使用其他支持MCP协议的AI客户端，可以按以下信息配置。

服务名称：kanjian-commercial-music-mcp

服务类型：Remote MCP / Streamable HTTP MCP

服务地址：https://commercial-licensed-music-mcp--kanjian-ai.run.tools

如客户端支持JSON配置，可参考以下格式：

{
  "mcpServers": {
    "kanjian-commercial-music-mcp": {
      "url": "https://commercial-licensed-music-mcp--kanjian-ai.run.tools"
    }
  }
}

如果客户端中出现以下字段，请填写同一个地址：

Server URL
MCP URL
Remote MCP URL
Streamable HTTP URL

填写内容：

https://commercial-licensed-music-mcp--kanjian-ai.run.tools

授权说明

所有客户端首次使用kanjian-commercial-music-mcp前都需要完成授权。

不同客户端的授权入口可能不同，常见方式包括：

在MCP管理菜单中选择kanjian-commercial-music-mcp并点击授权。

在首次调用工具时，根据客户端提示打开授权页面。

在终端中执行客户端提供的MCP登录命令。

授权完成后，建议重启客户端或新开会话，使MCP工具状态刷新。

可用工具

当前看见音乐MCP提供以下工具：

工具名称	说明
`search_music`	根据自然语言需求搜索商用授权音乐，可按场景、情绪、风格、乐器、BPM、时长、人声、语种等条件检索
`preview_track`	根据曲目ID获取试听链接、波形图、曲目页和授权页
`get_track_metadata`	根据曲目ID获取完整曲目信息、标签信息和授权相关链接

工具调用能力说明

search_music适合用于音乐搜索和推荐，例如短视频配乐、广告片配乐、游戏PV配乐、发布会开场音乐等。

preview_track适合在已知曲目ID时获取试听地址和授权页面。

get_track_metadata适合在已知曲目ID时查询曲名、艺人、专辑、ISRC、BPM、语种、标签等完整信息。

使用示例

中国风歌曲搜索

使用kanjian-commercial-music-mcp 帮我找两首中国风的歌曲

短视频配乐搜索

使用kanjian-commercial-music-mcp 帮我找5首适合城市夜景短视频的商用授权音乐，要求电子、节奏中等、不要人声。

品牌宣传片配乐搜索

调用kanjian-commercial-music-mcp，帮我找适合国风品牌宣传片的商用授权音乐，返回歌曲名、艺人、推荐理由、试听链接和授权链接。

游戏PV配乐搜索

帮我找几首适合武侠游戏PV的配乐，要求中国风、史诗感、可商用，并带试听链接。

曲目信息查询

使用kanjian-commercial-music-mcp 根据track_id查询曲目的完整信息、试听链接和授权页面。

返回结果说明

MCP工具调用后，通常会返回以下信息：

字段	说明
`title`	曲目名称
`artist`	艺人名称
`track_id`	曲目ID
`duration_sec`	曲目时长，单位为秒
`bpm`	曲目BPM
`vocals`	人声类型
`language`	语种
`genre_primary`	一级曲风
`genre_secondary`	二级曲风
`preview_url`	试听链接
`track_page_url`	曲目详情页
`license_url`	授权说明页
`reason`	推荐理由

常见问题

这是安装到模型里吗？

不是。MCP是安装或配置到AI客户端中，例如Codex、Claude Code、Cursor。模型通过客户端调用MCP工具。

不同模型需要不同命令吗？

通常不需要。MCP接入命令主要取决于客户端，而不是模型。

例如：

Codex使用 codex mcp add
Claude Code使用 claude mcp add
Cursor使用 cursor --add-mcp 或 mcp.json

为什么安装后建议新开会话？

部分客户端只会在新会话启动时加载最新MCP工具。安装或授权完成后，新开会话可以确保工具被正确识别。

安装后没有看到工具怎么办？

请检查以下内容：

MCP服务地址是否填写正确。

当前客户端是否支持远程HTTP MCP。

是否已经完成授权。

是否需要重启客户端。

是否需要新开会话。

当前网络是否可以访问MCP服务地址。

授权失败怎么办？

请重新执行授权命令或重新打开MCP授权菜单。

Codex重新授权：

Claude Code重新打开MCP菜单：

/mcp

如何删除MCP配置？

Codex删除命令：

Claude Code删除命令：

Cursor可以删除mcp.json中的对应配置：

{
  "mcpServers": {}
}

开发指南#

开发前必读#

支持的客户端#

接入流程#

接入信息#

Codex接入#

安装MCP#

授权MCP#

查看MCP列表#

使用示例#

Codex接入步骤说明#

Claude Code接入#

安装MCP#

查看MCP列表#

授权MCP#

使用示例#

Claude Code接入步骤说明#

Cursor接入#

命令方式接入#

配置文件方式接入#

授权MCP#

使用示例#

Cursor接入步骤说明#

Dify接入#

当前状态#

使用方式#

授权说明#

Dify接入步骤说明#

通用客户端接入#

授权说明#

可用工具#

工具调用能力说明#

使用示例#

中国风歌曲搜索#

短视频配乐搜索#

品牌宣传片配乐搜索#

游戏PV配乐搜索#

曲目信息查询#

返回结果说明#

常见问题#

这是安装到模型里吗？#

不同模型需要不同命令吗？#

为什么安装后建议新开会话？#

安装后没有看到工具怎么办？#

授权失败怎么办？#

如何删除MCP配置？#

推荐接入步骤#

开发指南

开发前必读

支持的客户端

接入流程

接入信息

Codex接入

安装MCP

授权MCP

查看MCP列表

使用示例

Codex接入步骤说明

Claude Code接入

安装MCP

查看MCP列表

授权MCP

使用示例

Claude Code接入步骤说明

Cursor接入

命令方式接入

配置文件方式接入

授权MCP

使用示例

Cursor接入步骤说明

Dify接入

当前状态

使用方式

授权说明

Dify接入步骤说明

通用客户端接入

授权说明

可用工具

工具调用能力说明

使用示例

中国风歌曲搜索

短视频配乐搜索

品牌宣传片配乐搜索

游戏PV配乐搜索

曲目信息查询

返回结果说明

常见问题

这是安装到模型里吗？

不同模型需要不同命令吗？

为什么安装后建议新开会话？

安装后没有看到工具怎么办？

授权失败怎么办？

如何删除MCP配置？

推荐接入步骤