企业官网建设流程全解析

1. 先搞清楚我们要搭的这条链路

Agent 这个词听起来玄乎，拆开看其实就三件事：一个会思考的大模型、一堆能干活的外部工具、一个把两者串起来的协议。MCP（Model Context Protocol）就是那个协议，它让大模型能像插 U 盘一样接入外部数据源。高德地图 MCP Server 则是把地理编码、路径规划、周边搜索这些能力封装成标准接口，Agent 调用它就能拿到真实的景点坐标和路线数据。

这篇教程面向的是零基础 Agent 开发者，你不需要懂什么 RAG、Function Calling 底层原理，只要会复制粘贴配置文件、能跑几条命令就行。最终我们要交付的东西很具体：一个能对话的 Agent，你告诉它「帮我规划杭州三日游」，它自动调用高德地图 MCP 拉取景点和路线，然后生成一个可以直接在浏览器打开的旅行攻略网页。

整个链路里有两个关键节点需要提前准备好。第一是高德开放平台的应用 Key，这个去高德官网申请就行，免费额度够个人开发用。第二是大模型的 API 通道，这里我用 TaoToken 来统一接入，原因是它兼容 OpenAI 格式的接口规范，配置起来省事，而且一个 Key 可以切换不同模型，调试 Agent 的时候不用来回改环境变量。

你可能会问，为什么不用本地模型？实测下来，Agent 场景对模型的指令遵循能力要求比较高，本地小模型在解析 MCP 返回的 JSON 结构时经常出错，导致工具调用失败。用 API 通道虽然有一点成本，但调试效率高很多，等流程跑通了再考虑换模型也不迟。

下面我会按「配环境 → 写配置 → 启动 Agent → 验证调用 → 排错」的顺序一步步来，每一步都有可复制的代码和命令。你跟着做，半小时内应该能看到攻略网页跑起来。

2. TaoToken 前置准备：拿 Key 和确认通道

在配置 MCP 之前，先把大模型的 API 通道准备好。TaoToken 的接入方式跟 OpenAI 兼容，你只需要一个 API Key 和一个 Base URL 就能调通。

2.1 获取 API Key

打开 TaoToken 官网（https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=），注册登录后进入控制台。在左侧菜单找到「API Keys」页面，点「创建新 Key」，给它起个名字比如agent-travel-demo，权限选默认的即可。创建完成后复制那串sk-开头的 Key，注意它只显示一次，先粘贴到记事本里存着。

如果你之前没用过这类服务，可以把它理解成一个「模型网关」：你的 Agent 代码只认一个 Base URL 和一个 Key，具体背后调的是哪个模型，在请求参数里指定就行。这样切换模型不用改代码，只改一个字符串。

2.2 确认 API 通道地址

TaoToken 的 API 基础地址是https://taotoken.net/api，注意这个地址后面不加 UTM 参数，直接用在代码里。完整的请求端点就是https://taotoken.net/api/v1/chat/completions，跟 OpenAI 的格式完全一致。

你可以先用 curl 测一下通道是否通：

curl https://taotoken.net/api/v1/chat/completions \ -H "Content-Type: application/json" \ -H "Authorization: Bearer sk-你的Key" \ -d '{ "model": "gpt-4o-mini", "messages": [{"role": "user", "content": "回复ok"}], "max_tokens": 10 }'

如果返回的 JSON 里choices[0].message.content有内容，说明通道没问题。这一步很重要，因为后面 Agent 调 MCP 的时候，如果模型通道不通，报错信息会混在一起，很难排查。

2.3 申请高德地图 Key

高德开放平台的应用创建流程不复杂：登录后进「应用管理」→「我的应用」→「创建新应用」，应用类型选「Web 服务」，然后添加 Key。创建完你会拿到一个 32 位的字符串，这就是AMAP_MAPS_API_KEY。

注意高德 MCP Server 用的是 Web 服务类型的 Key，不是 Web 端（JS API）的 Key，选错了调用会返回INVALID_USER_SCODE错误。这个坑我踩过，当时排查了半天以为是 MCP 配置问题，其实是 Key 类型不对。

3. 可复制的 MCP 配置文件骨架

现在进入核心部分。MCP 的配置本质上就是告诉 Agent：「有一个叫 amap-maps 的工具，你用 npx 启动它，启动的时候把高德 Key 传进去」。不同 Agent 客户端的配置文件位置不一样，但结构大同小异。

3.1 通用 MCP 配置骨架

先看最核心的配置块，你可以直接复制：

{ "mcpServers": { "amap-maps": { "command": "npx", "args": ["-y", "@amap/amap-maps-mcp-server"], "env": { "AMAP_MAPS_API_KEY": "你申请的高德Key" } } } }

这段配置的含义是：Agent 启动时，会执行npx -y @amap/amap-maps-mcp-server这个命令，把高德 Key 通过环境变量传进去。-y参数表示自动确认安装，避免 npx 卡在交互提示上。

如果你用的是 Claude Code 或类似的客户端，配置文件通常叫settings.json或mcp.json，放在项目根目录的.claude或.config文件夹下。下面是一个完整的settings.json示例，把 TaoToken 的模型通道和高德 MCP 放在一起：

{ "model": { "provider": "openai", "baseUrl": "https://taotoken.net/api", "apiKey": "sk-你的TaoToken Key", "modelName": "gpt-4o-mini" }, "mcpServers": { "amap-maps": { "command": "npx", "args": ["-y", "@amap/amap-maps-mcp-server"], "env": { "AMAP_MAPS_API_KEY": "你的高德Key" } } } }

这里baseUrl填https://taotoken.net/api，不要加/v1，因为客户端会自动拼接路径。modelName可以先填gpt-4o-mini，等流程跑通后你可以换成更强的模型来提升攻略生成质量。

3.2 环境变量方式（推荐）

把 Key 写在配置文件里有泄露风险，尤其是你要把代码传到 Git 仓库的时候。更稳妥的做法是用环境变量：

export TAOTOKEN_API_KEY="sk-你的Key" export AMAP_MAPS_API_KEY="你的高德Key"

然后配置文件里改成引用变量：

{ "mcpServers": { "amap-maps": { "command": "npx", "args": ["-y", "@amap/amap-maps-mcp-server"], "env": { "AMAP_MAPS_API_KEY": "${AMAP_MAPS_API_KEY}" } } } }

不同客户端对环境变量语法的支持不一样，有的用${VAR}，有的用$VAR，具体看你用的工具文档。如果启动时报「env not found」，先检查语法。

3.3 验证 MCP Server 能否独立启动

在接入 Agent 之前，先单独跑一下 MCP Server，确认它能正常启动：

AMAP_MAPS_API_KEY=你的高德Key npx -y @amap/amap-maps-mcp-server

如果看到类似MCP server running on stdio的输出，说明 Server 本身没问题。如果报command not found: npx，先装 Node.js（建议 18 以上版本）。如果报401或INVALID_USER_SCODE，回去检查高德 Key 的类型和是否启用了 Web 服务。

这一步能帮你把「MCP Server 本身的问题」和「Agent 接入的问题」分开，排错效率高很多。

4. 启动 Agent 并调用高德 MCP 的逐步验证

配置写好了，接下来要验证整条链路能不能跑通。我建议分三步走：先确认 Agent 能连上模型，再确认能列出 MCP 工具，最后跑一个完整的旅行攻略生成任务。

4.1 第一步：确认 Agent 能连上 TaoToken

启动你的 Agent 客户端（以 Claude Code 为例），在对话里输入：

请用一句话介绍你自己，并告诉我你当前使用的模型名称。

如果 Agent 正常回复，说明 TaoToken 通道配置正确。如果报401 Unauthorized，检查 API Key 是否复制完整；如果报model not found，检查modelName拼写。

4.2 第二步：确认 MCP 工具已加载

在对话里输入：

列出你当前可用的所有 MCP 工具，并说明每个工具的作用。

正常情况下，Agent 会返回类似这样的工具列表：

如果 Agent 说「没有可用工具」或只列出了内置工具，说明 MCP 配置没生效。常见原因是配置文件路径不对，或者客户端没有重启。改完配置一定要完全退出客户端再重新打开，热重载有时候不生效。

4.3 第三步：跑一个完整的旅行攻略任务

这是最关键的一步。在对话里输入下面这段提示词：

用高德地图 MCP 帮我规划一个杭州三日游攻略，要求： 1. 第一天西湖周边，第二天西溪湿地+宋城，第三天灵隐寺+龙井村 2. 每天给出具体的景点顺序、建议游玩时间、交通方式 3. 查询每个景点的经纬度坐标 4. 最后生成一个 HTML 旅行攻略网页，包含地图链接和行程表格

Agent 的执行过程大致是这样的：先调用maps_search_poi搜索「西湖」「西溪湿地」等关键词拿到 POI ID 和坐标，再调用maps_direction_driving或maps_direction_walking计算景点之间的路线，最后把结果整理成 HTML。

你会在终端里看到类似这样的工具调用日志：

[Tool Call] maps_search_poi({ keywords: "西湖", city: "杭州" }) [Tool Result] { poi_id: "B023B0...", location: "120.15,30.25", name: "西湖风景名胜区" } [Tool Call] maps_direction_walking({ origin: "120.15,30.25", destination: "120.13,30.26" }) [Tool Result] { distance: 1200, duration: 18, steps: [...] }

如果工具调用成功返回了数据，但 Agent 最后没有生成 HTML，可能是模型的输出长度限制到了。这时候可以在提示词里加一句「先输出行程数据，再单独生成 HTML 代码」，分两步走。

4.4 渲染攻略网页

Agent 生成的 HTML 代码通常会直接输出在对话里，你把它复制出来存成travel-guide.html，双击就能在浏览器打开。如果 Agent 支持写文件，你也可以让它直接保存：

请把刚才生成的 HTML 保存到当前目录的 travel-guide.html 文件里。

打开网页后，你应该能看到一个包含行程表格、景点坐标、路线距离的攻略页面。表格里每一行对应一个景点，包含到达时间、游玩时长、交通方式。如果页面样式比较简陋，可以让 Agent 再调一版：「给这个页面加上卡片式布局和渐变背景」。

到这里，整条链路就跑通了：TaoToken 提供模型能力 → Agent 解析指令 → 调用高德 MCP 拿数据 → 生成 HTML 攻略页。

5. 本篇常见错误排查

跑不通的时候别慌，大部分问题集中在下面几个地方。我按报错信息分类整理，你对号入座。

5.1 MCP Server 启动失败

报错Error: Cannot find module '@amap/amap-maps-mcp-server'，说明 npx 没拉到包。先检查网络能不能访问 npm registry，然后手动跑一次npx -y @amap/amap-maps-mcp-server看能否安装。如果卡住不动，可能是 npm 源的问题，换成国内镜像：

npm config set registry https://registry.npmmirror.com

报错AMAP_MAPS_API_KEY is required，说明环境变量没传进去。检查配置文件里env字段的 Key 名是否拼写正确，注意大小写敏感。

5.2 高德接口返回错误码

INVALID_USER_SCODE：Key 类型不对，去高德控制台确认应用是「Web 服务」类型。

DAILY_QUERY_OVER_LIMIT：当日调用量超了，个人开发者免费额度是每天 5000 次，调试阶段一般够用。如果超了，等第二天重置，或者去控制台看能不能提额。

INVALID_PARAMS：传的参数格式不对，比如经纬度写成了120.15, 30.25（中间有空格），高德要求120.15,30.25这种紧凑格式。

5.3 Agent 不调用 MCP 工具

有时候 Agent 会「忘记」自己有 MCP 工具，直接用自己的知识回答。这时候在提示词里明确要求：「必须调用 maps_search_poi 工具查询真实坐标，不要凭记忆编造」。如果还是不行，检查客户端的 MCP 开关是否打开，有些客户端默认不启用 MCP。

5.4 TaoToken 通道报错

401 Unauthorized：Key 错了或者过期了，去控制台重新生成一个。

429 Too Many Requests：请求频率超了，等几秒重试，或者在代码里加个重试逻辑。

model not found：模型名拼错了，去 TaoToken 的模型列表页确认一下可用模型名称。不同通道支持的模型不一样，别照搬 OpenAI 的模型名。

5.5 生成的 HTML 打不开或样式错乱

如果 HTML 里引用了外部 CDN 的 CSS 或 JS，断网环境下会加载失败。让 Agent 把样式写成内联的<style>标签，不依赖外部资源。如果表格列数对不上，检查 Agent 输出的 HTML 里<td>和<th>数量是否一致，这种小错误手动改一下就行。

6. 继续往下走：把 Demo 变成常用工具

跑通这个 Demo 之后，你可以做几件事让它更实用。第一，把常用的旅行城市做成模板，每次只改城市名和天数，Agent 就能复用同一套提示词。第二，把生成的 HTML 攻略页部署到静态托管服务上，分享给朋友直接打开链接就能看。第三，如果你经常做行程规划，可以考虑用 Coding Plan 把整个流程封装成一个命令行工具，输入「杭州 3 天」就自动生成网页。

接入文档里还有更多 MCP 工具的用法，比如天气查询可以加到攻略里提示「第三天有雨，建议带伞」，距离测量可以算景点之间的步行时间。这些组合起来，你的旅行攻略网页会越来越像一个小型产品。

如果你在配置过程中遇到报错，优先去 API Keys 页面确认 Key 状态，再去接入文档对照配置格式。大部分问题都是 Key 类型不对或者配置文件路径写错，耐心对一遍就能解决。