Skip to main content
把 MapX 集成到外部代理不需要按代理逐个适配。Claude Code、Codex、OpenCode、OpenClaw、Hermes、WorkBuddy 以及其他 LLM 工具循环都可以使用同一个 skill 文件。代理下载它并按其中说明完成自我配置。

​
一步接入

把 skill 下载链接给代理，让它安装并遵循该 skill：
这个 skill 文件是自包含的。它说明如何：
  • 为 Linux、macOS 或 Windows 下载对应的 mapx 二进制；
  • 用 mapx auth login <mkx_...> 本地保存 key（或回退到 MAPX_API_KEY 环境变量）；
  • 用 mapx auth status 验证配置；
  • 使用项目、图层、样式、地图控制、视图 URL 和报告相关命令；
  • 用 mapx skill 按需读取 CLI 命令参考。

​
代理无法安装 skill 时的兜底方案

有些纯对话代理无法创建 skill 文件。这种情况下，把完整的 SKILL.md 内容粘贴进对话即可。它是纯 Markdown，设计上可以直接从上下文遵循。

​
获取 API key

让用户打开 https://app.mapxagent.com?open=api-keys，创建 API key 并复制 mkx_... 值（只显示一次）。然后保存：

​
验证集成

让代理确认连接：
然后运行一个简单的端到端检查：
如果三步都成功，代理就可以端到端驱动 MapX 项目了。