文档首页/ CodeArts代码智能体 / 用户指南/ MCP
更新时间：2026-02-02 GMT+08:00
查看PDF
分享

MCP

CodeArts代码智能体可依托模型上下文协议（MCP）与MCP服务器通信，借助服务器提供的额外工具和资源实现功能扩展。

什么是MCP

模型上下文协议（Model Context Protocol，简称MCP）是一种开放协议，定义应用程序与大语言模型（LLM）之间的上下文提供规范，为LLM连接外部数据源、工具系统提供统一的交互标准。MCP服务器的核心功能是允许LLM请求外部工具协助回答查询或完成任务。如需了解更多关于MCP的详细信息，请参考MCP官方文档。

配置MCP服务器并在智能体中使用

按照MCP服务器与MCP客户端（CodeArts代码智能体）之间的通信方式来划分，目前支持两类MCP服务器。

类型

传输协议

执行环境

基于stdio（标准输入输出）的MCP服务器

stdio

本地

基于HTTP协议的MCP服务器

SSE

本地/远程

Streamable HTTP

本地/远程
  1. 参考安装并登录操作，登录CodeArts代码智能体。
  2. 打开CodeArts代码智能体聊天窗口。

    • CodeArts代码智能体IDE：单击IDE顶部菜单栏中的切换辅助侧栏图标 ，打开CodeArts代码智能体聊天窗口。
    • Visual Studio Code：单击Visual Studio Code侧边栏图标 ，打开CodeArts代码智能体聊天窗口。
    • JetBrains：以IntelliJ IDEA为例，单击IntelliJ IDEA侧边栏图标 ，打开CodeArts代码智能体聊天窗口。

    不同工具中CodeArts代码智能体的界面风格有所差异，本章以其在IDE工具中的界面为例进行介绍，实际操作请以所用工具的显示为准。

  3. 在聊天界面的输入框下方选择“智能体”，切换到智能体模式。

    图1 智能体模式

  4. 单击聊天界面右上方的MCP图标，进入MCP设置页面。
  5. 单击“配置MCP服务器”，打开“mcp_settings.json”文件，对MCP服务器的JSON配置文件进行自定义编辑。

    MCP配置的通用模板如下：

    {
  "mcpServers": {
    "服务器名称": {
      "command": "启动进程的命令",
      "args": [
        "参数数组"
      ],
      "env": {
        "环境变量"
      }
    }
  }
}
    表1 配置参数说明

    参数

    说明

    服务器名称

    服务器的唯一名称/标识符，用于区分不同的MCP服务器。

    command

    必填，要执行的命令或程序路径，用于指定启动MCP服务器所需的程序。

    args

    选填，传递给命令的参数列表，配合command使用，指定如何运行MCP服务器。

    env

    选填，传递给MCP服务器的环境变量集合，所有环境变量值均需为字符串类型。
    例如，您想通过Playwright直接操控浏览器完成网页导航、点击、输入、截图、数据提取等自动化操作。mcp_settings.json文件配置如下： 
    {
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": [
        "@playwright/mcp@latest"
      ]
    }
  }
}

    此示例用户需要本地安装node.js环境，推荐node-v24.x版本。您也可以通过与智能体交互，让智能体为您直接安装。

  6. 配置完成后按快捷键“Ctrl+S”保存，等待工具启动完成。

    图2 MCP工具启动完成

    如果在配置中遇到问题，可以返回到聊天界面，与智能体进行交互，帮助您修复问题。

  7. 在CodeArts代码智能体的输入框中，输入如下内容，单击 图标。 

    打开https://www.huaweicloud.com/product/codearts/ai.html，单击“查看所有下载选项”按钮

    智能体调用Playwright MCP服务器的方法，打开对应网页，并单击相应的按钮，跳转到对应的下载页。

    图3 查看调用结果

  1. 参考安装并登录操作，登录CodeArts代码智能体。
  2. 打开CodeArts代码智能体聊天窗口。

    • CodeArts代码智能体IDE：单击IDE顶部菜单栏中的切换辅助侧栏图标 ，打开CodeArts代码智能体聊天窗口。
    • Visual Studio Code：单击Visual Studio Code侧边栏图标 ，打开CodeArts代码智能体聊天窗口。
    • JetBrains：以IntelliJ IDEA为例，单击IntelliJ IDEA侧边栏图标 ，打开CodeArts代码智能体聊天窗口。

    不同工具中CodeArts代码智能体的界面风格有所差异，本章以其在IDE工具中的界面为例进行介绍，实际操作请以所用工具的显示为准。

  3. 在聊天界面的输入框下方选择“智能体”，切换到智能体模式。

    图4 智能体模式

  4. 单击聊天界面右上方的MCP图标，进入MCP设置页面。
  5. 单击“配置MCP服务器”，打开“mcp_settings.json”文件，对MCP服务器的JSON配置文件进行自定义编辑。

    MCP配置的通用模板如下：

    {
  "mcpServers": {
    "服务器名称": {
      "url": "https://example.com/mcp"
    }
  }
}
    表2 配置参数说明

    参数

    说明

    服务器名称

    服务器的唯一名称/标识符，用于区分不同的MCP服务器。

    url

    用于访问远程MCP服务器的地址，需确保是合法的HTTP或HTTPS类型URL。
    例如，您想通过高德MCP服务器与高德地图APP对接。mcp_settings.json文件配置如下： 
    {
  "mcpServers": {
    "amap-maps-streamableHTTP": {
      "url": "https://mcp.amap.com/mcp?key=您在高德官网上申请的key"
    }
  }
}

  6. 配置完成后按快捷键“Ctrl+S”保存，等待工具启动完成。

    如果在配置中遇到问题，可以返回到聊天界面，与智能体进行交互，帮助您修复问题。

相关文档