Help Center/ CodeArts Agent/ User Guide (CLI)/ MCP/ Default MCP Server Configuration
Updated on 2026-07-27 GMT+08:00
View PDF
Share

Default MCP Server Configuration

You can configure a project-level or user-level MCP server. Table 1 MCP server configuration paths lists the configuration paths.

Table 1 MCP server configuration paths

Level

Application Scope

Configuration Path

Project

Current project

Priority: project-level > user-level

Project root directory/.codeartsdoer/codearts_cli.jsonc or Project root directory/.codeartsdoer/codearts_cli.json

User

All projects of the current user

~/.codeartsdoer/codearts_cli.jsonc or ~/.codeartsdoer/codearts_cli.json

The tilde (~) indicates the home directory of the current user. In Windows, it is equivalent to C:\Users\Username\. In macOS, it is equivalent to /Users/Username/. In Linux, it is equivalent to /home/Username/.

Local MCP Server

You can configure a local MCP server.

Parameters

Table 2 Local MCP server parameters

Parameter

Type

Description

type

String

This parameter is mandatory. The value must be local.

command

String array

Command and input parameters for starting the MCP service. This parameter is mandatory.

environment

Object

Environment variables set for running the server

enabled

Boolean

Whether to enable the MCP server

timeout

Number

Response timeout interval for obtaining the MCP service tool, in milliseconds. The default interval is 100,000 ms.

Configuration Example

This section uses Windows as an example to describe how to configure a local MCP server in a personal environment.

  1. In the C:/Users/Username/.codeartsdoer/ directory, create the codearts_cli.jsonc file, write the following configuration to the file, and restart the CodeArts Agent CLI: 

    {
  "mcp": {
    // Custom MCP service name: character analysis tool
    "mcp-character-tools" : {
      // Mandatory. Startup command: npx is used to start the local MCP service.
      "command" : [ "npx", "mcp-character-tools" ],
      // Mandatory. Service type: local MCP server
      "type": "local"
    }
  }
}

  2. Enter the TUI development environment.

    1. Open the root directory of the target project.
    2. Right-click in the blank area and select Open Windows Terminal here.
    3. Enter /codearts in the terminal and press Enter to enter the TUI development environment.

  3. Run the following command to check whether the configuration has taken effect: 

    /mcps

    The status of mcp-character-tools is Enabled, indicating that the MCP server is enabled.

    Figure 1 Status

  4. In the TUI dialog box, enter the following instruction. 

    How do I use mcp-character-tools?

    The function description and usage method are returned, indicating that the configuration of the local MCP server has taken effect.

Remote MCP Server

You can configure a remote MCP server.

Parameters

Table 3 Remote MCP server parameters

Parameter

Type

Description

type

String

This parameter is mandatory. The value must be remote.

url

String

(Mandatory) URL of the remote MCP server

headers

Object

Request header

environment

Object

Environment variables set for running the server

oauth

Object

OAuth authentication configuration

enabled

Boolean

Whether to enable the MCP server

timeout

Number

Response timeout interval for obtaining the MCP service tool, in milliseconds. The default interval is 5,000 ms.

Configuration Example

This section uses Windows as an example to describe how to configure a remote MCP server in a personal environment.

  1. In the C:/Users/Username/.codeartsdoer/ directory, create the codearts_cli.jsonc file, write the following configuration to the file, and restart the CodeArts Agent CLI: 

    {
  "mcp": {
    // EdgeOne Pages Deploy MCP is a dedicated service that allows you to quickly deploy web applications on EdgeOne Pages and generate public access links. This enables you to instantly preview and share AI-generated web pages.
    "edgeone-pages": {
      "type": "remote",
      "url": "https://mcp-on-edge.edgeone.site/mcp-server",
      "enabled": true,
      "timeout": 45000,
      "headers": {
        // API request authentication header, which is optional
        "Authorization": "Bearer edgeone_token_your_secret"
      }
    }
  }
}

  2. Enter the TUI development environment.

    1. Open the root directory of the target project.
    2. Right-click in the blank area and select Open Windows Terminal here.
    3. Enter /codearts in the terminal and press Enter to enter the TUI development environment.

  3. Run the following command to check whether the configuration has taken effect: 

    /mcps

    The status of edgeone-pages is Enabled, indicating that the MCP server is enabled.

    Figure 2 Status

  4. In TUI development mode, enter the following instruction and press Enter: 

    Generate and release a snake game.

    AI invokes the MCP server and creates a snake game.

    Figure 3 MCP server invoked successfully

Parent Topic: MCP