接进 AI 编辑器

习惯在 Trae、通义灵码、Cursor、Claude Code 这类 AI 编辑器里干活，也可以不打开网页，直接在编辑器里使用唯杰地图智能体平台。平台提供 MCP（Model Context Protocol）接入：在编辑器里加上一个专属的 MCP 地址，编辑器里的 AI 就能调用平台的技能、沙盒和地图服务，做地图、看图纸。推理用的是编辑器自己的模型，平台把每一轮过程实时记成一条会话，回到网页也能看到。本篇介绍怎样生成地址、按编辑器的配置方式接入、在编辑器里使用，以及怎样管理令牌。

打开 MCP 面板

1. 在浏览器打开 https://vjmap.com/agent/ 并登录，账号与官网、地图动画等应用通用。
2. 在首页标题上方点「MCP」（旁边写着「连接 AI 编辑器」），弹出「连接外部 AI · MCP」面板。

「MCP」按钮旁边的文字会随连接状态变化，不用打开面板就能看出编辑器有没有连上：

面板从上到下分成几块，后面几节逐一介绍：

1. MCP 地址：生成你的专属地址；生成后在这里显示和复制。
2. 配置方式：「JSON 配置」「命令行」「本地命令」三个页签，按编辑器支持的方式选。
3. 配置片段：按所选方式写好的配置，右上角有「复制」。
4. 其他写法：编辑器要求写明传输类型，或者不想把令牌写进地址时展开。
5. 使用提示：接好后在编辑器里怎么说。
6. 编辑器能用的工具：点开查看编辑器能调用哪些工具，数字是工具数量。
7. 下载技能包 / 管理令牌与权限：技能包教编辑器里的 AI 怎么配合平台；令牌的权限和有效期到设置页管理。

生成地址后，面板顶部会多出一条连接状态（如「等待编辑器连接」），编辑器连上后自动变绿。

生成专属地址

1. 在「MCP 地址」一栏点「生成地址」。
2. 生成后，这一栏变成地址框。令牌默认打码显示，点眼睛图标显示原文，点「复制」复制完整地址。

1. 专属地址说明：地址长期有效，之后随时能回到这里再看、再复制。默认权限是知识、上游服务、会话与文件、沙盒执行。
2. 生成地址：点一下就生成。
3. 自动填好：生成后，下面各种写法里的地址会自动填上，不用手动拼。

各项权限的含义如下。要细调权限或设有效期，到设置页新建令牌，见本篇最后一节。

加到编辑器

在「加到编辑器」里，按你的编辑器支持的方式选一个页签：

1. JSON 配置：大多数 AI 编辑器和编辑器插件用这种。
2. 命令行：在终端里运行的 AI 工具，例如 Claude Code。
3. 本地命令：只支持本地命令（stdio）的客户端。

JSON 配置

1. 切到「JSON 配置」，点配置片段右上角的「复制」。
2. 打开编辑器的 MCP 设置，选「手动添加 / 编辑 JSON」，把复制的内容粘贴进去并保存。
3. 个别编辑器的字段名和示例不一样，按编辑器的提示改即可。

1. 适用的编辑器：Trae、通义灵码、腾讯云 CodeBuddy、文心快码 Comate、Qoder、Cursor 等支持 MCP 的编辑器都可以这样加。
2. 地址：图中的 <你的专属 MCP 地址> 是占位，生成地址后，这里自动填上你的专属地址。
3. 复制：复制出来就是完整的配置，已经带着令牌。
4. 其他写法：点开后还有两种写法，见下文。

复制出来的配置结构如下，vjagent 是这个服务在编辑器里的名字：

{
  "mcpServers": {
    "vjagent": {
      "url": "<你的 MCP 地址>"
    }
  }
}

展开「其他写法」还有两种：一种多写一行 "type": "streamable-http"，给要求写明传输类型的编辑器用；另一种地址里不带令牌，令牌放进 Authorization 请求头，适合不想把令牌写进地址的场合：

{
  "mcpServers": {
    "vjagent": {
      "type": "streamable-http",
      "url": "<MCP 地址，不含末尾的令牌>",
      "headers": { "Authorization": "Bearer <令牌>" }
    }
  }
}

命令行

以 Claude Code 为例，切到「命令行」，复制命令，在终端里运行：

claude mcp add --transport http --scope user vjagent <你的 MCP 地址>

--scope user 表示对所有项目生效，去掉则只加到当前项目。其他命令行工具按各自「添加 MCP」的命令填同一个地址，传输方式选 HTTP。加好后，可以用工具自带的 MCP 列表命令确认已经连上，面板里的状态也会变绿。

本地命令

只支持本地命令（stdio）的客户端，借助 mcp-remote 把这个地址转成本地命令，需要本机装有 Node.js。切到「本地命令」，把配置合并进客户端的 MCP 配置文件，重启客户端生效：

{
  "mcpServers": {
    "vjagent": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "<你的 MCP 地址>"]
    }
  }
}

在编辑器里使用

接好后，先看一眼面板或首页的「MCP」按钮：编辑器连上后会变成绿色。然后在编辑器里直接说需求，例如「用唯杰地图智能体做一张北京各区人口分布的专题地图，做好给我预览链接」。

1. 使用提示：推理用的是编辑器自己的模型（用你自己的编辑器额度），平台把过程实时记成一条会话，在网页左侧的会话列表里也能看到。
2. 编辑器能用的工具：点开是工具清单，按类别分组，可以搜工具名或说明；点某个工具看完整说明。右侧注明按哪个令牌的权限列出。
3. 下载技能包：技能包教编辑器里的 AI 怎么配合平台工作（工作协议、能力路由表、工具参数），解压到工程根目录即可；不装也能用，只是每次要多花一轮。
4. 管理令牌与权限：跳到设置页管理令牌，见下一节。

在编辑器里发起的会话，在网页的会话列表里用代码图标标出，鼠标移上去能看到是哪个编辑器创建的。打开它，提问、工具调用、回答和成果预览都在里面。

管理令牌与权限

点面板底部的「管理令牌与权限」，或者在左侧导航点「设置」，再点「我的编辑器令牌」，打开「编辑器接入」页：

1. MCP 工具：管的是平台智能体在网页对话里使用的工具服务，和编辑器接入是两回事，见会话、设置与反馈。
2. 我的编辑器令牌：管理接进编辑器用的令牌，也就是 MCP 地址。

在「编辑器接入」页可以：

• 新建令牌：点「新建令牌」，填名称，选有效期（长期、30 天、90 天、180 天、365 天）和权限，点「创建」。创建后显示 MCP 地址和 JSON 配置片段，可以直接复制，也可以下载含这个地址的技能包。
• 查看和复制地址：每个令牌一行，写着创建、到期和最近使用的时间。点眼睛图标显示地址，点「复制地址」复制。
• 编辑选项：点调节图标能改少数高级选项；名称、权限和有效期建好后不能改，要改就新建一个，再吊销旧的。
• 吊销：点删除图标吊销令牌，用它的编辑器会立即失去访问权限。
• 下载技能包：页面下方有「通用（.agents/skills/）」和「.cursor/skills/ 目录版」两种，平台新增技能后建议重新下载。

下一步

做过的会话、用量和分享出去的链接怎么管理，接下来看会话、设置与反馈。还没在网页里做过地图，可以先看新手入门。