Newtouch Code 配置 MCP 服务器

Newtouch Code MCP 配置说明

MCP（Model Context Protocol）可以把外部工具接入到 Newtouch Code，让模型在需要时调用额外能力，例如查询系统、读取外部知识库或访问内部工具。

MCP 工具会增加上下文和调用开销，建议只启用当前任务真正需要的服务器。

配置文件位置

Newtouch Code 支持在全局配置或项目配置中配置 MCP。推荐优先使用 Newtouch Code 显式配置文件名，避免在文档和项目中继续暴露旧配置名称。

全局配置：

系统	路径
macOS / Linux / WSL2	~/.config/newtouchcode/newtouchcode.jsonc

项目级配置：

位置	路径
项目根目录	newtouchcode.jsonc
项目配置目录	.newtouchcode/newtouchcode.jsonc

推荐配置格式

MCP 服务统一放在 mcp 下。每个服务使用一个自定义名称，例如 mcp-everything、Aifusion。

{
  "$schema": "https://newtouchcode/config.json",
  "mcp": {
    "server-name": {
      "type": "local",
      "command": ["npx", "-y", "your-mcp-server"],
      "enabled": true,
      "environment": {
        "YOUR_ENV_NAME": "your-env-value",
      },
      "timeout": {
        "startup": 10000,
        "request": 30000,
      },
    },
  },
}

本地 MCP 示例

本地 MCP 通过命令启动，适合接入本机脚本、企业内部 CLI 或本地服务。

{
  "$schema": "https://newtouchcode/config.json",
  "mcp": {
    "mcp-everything": {
      "type": "local",
      "command": ["npx", "-y", "@modelcontextprotocol/server-everything"],
      "enabled": true,
    },
  },
}

远程 MCP 示例

远程 MCP 通过 HTTP 地址接入，适合接入已经部署好的工具服务。这里以平台的 skill-mcp 为例子，其中token去平台的技能市场获取。

{
  "$schema": "https://newtouchcode/config.json",
  "mcp": {
    "Aifusion": {
      "type": "remote",
      "url": "http://192.168.9.185:30988/mcp",
      "enabled": true,
      "headers": {
        "Authorization": "Bearer ****",
      },
    },
  },
}

字段说明

字段	说明
mcp	MCP 服务列表，服务名称直接作为 mcp 下的一级字段。
server-name	自定义 MCP 服务名称，后续可在对话中引用。
type	MCP 类型，支持 local 和 remote。
command	本地 MCP 启动命令数组，仅 type: "local" 需要。
cwd	本地 MCP 工作目录，可选；相对路径会基于当前项目目录解析。
environment	本地 MCP 环境变量，可选。
url	远程 MCP 地址，仅 type: "remote" 需要。
headers	远程 MCP 请求头，可选。
oauth	远程 MCP OAuth 配置，可选；也可以设置为 false 禁用 OAuth 自动检测。
enabled	是否启用该 MCP。true 表示启用，false 表示停用。
timeout.startup	MCP 初始化超时时间，单位毫秒。
timeout.request	MCP 单次请求超时时间，单位毫秒。

类型说明

local

local 类型表示 MCP 服务由本地命令启动。

{
  "type": "local",
  "command": ["npx", "-y", "your-mcp-server"],
  "cwd": ".",
  "environment": {
    "YOUR_ENV_NAME": "your-env-value",
  },
  "enabled": true,
}

适合场景：

• 使用本机脚本或 CLI 暴露工具能力。
• 接入需要本地文件系统上下文的 MCP。
• 在企业内网环境中启动内部工具服务。

remote

remote 类型表示 MCP 服务通过远程 HTTP 地址接入。

{
  "type": "remote",
  "url": "http://192.168.9.185:30988/mcp",
  "headers": {
    "Authorization": "Bearer *****",
  },
  "oauth": false,
  "enabled": true,
}

适合场景：

• 使用已经部署好的 MCP 服务。
• 多人共享同一个 MCP 工具入口。
• 通过请求头或 OAuth 接入受保护的工具服务。

使用方式

配置完成后，重启 Newtouch Code。对话时可以明确告诉 Newtouch Code 使用某个 MCP 工具。

使用 Aifusion 查询这个需求关联的接口文档。

如果工具没有生效，优先检查：

• 配置文件是否放在全局配置或项目配置路径下。
• 配置结构是否为 mcp 下直接配置服务名称。
• MCP 服务名称是否唯一。
• enabled 是否为 true。
• 本地命令是否能在终端中单独启动。
• 远程地址、请求头和认证信息是否正确。
• timeout.startup 或 timeout.request 是否过短。
• 工具数量是否过多，导致上下文或请求超时。