跳转到内容
Aptos 文档

使用 Claude Code 配置 Aptos MCP
  1. 安装 Claude Code。npm 包仍然可用：
Terminal window
npm install -g @anthropic-ai/claude-code

  1. 从 Geomi 获取 APTOS_BOT_KEY（账户菜单中的 Bot Keys）。完整步骤见 Aptos MCP。

  2. 进入你的项目目录：

Terminal window
cd your-awesome-project
  1. 使用 Claude CLI 添加 Aptos MCP 服务器。把 Claude 自己的参数放在服务器名称之前，把启动命令放在 -- 之后：
Terminal window
claude mcp add --scope local --env APTOS_BOT_KEY=<your_bot_key> --transport stdio aptos-mcp -- npx -y @aptos-labs/aptos-mcp

将 <your_bot_key> 替换为第 2 步生成的密钥。

--scope local 只对当前项目生效。使用 --scope user 可在本机所有项目中启用，或使用 --scope project 写入可共享的 .mcp.json（不要提交 Bot Key）。

传输方式、作用域和 --env 语法见 Claude Code MCP 文档。

  1. 确认服务器已注册：
Terminal window
claude mcp list

列表中应出现 aptos-mcp。

  1. 启动 Claude Code：
Terminal window
claude
  1. 向代理询问 what aptos mcp version are you using? 以验证连接。它应返回 MCP Server Card 中当前发布的 @aptos-labs/aptos-mcp 版本。

备选：JSON 配置

Section titled “备选：JSON 配置”

如果 CLI 命令失败，可以用 JSON 添加同一个 stdio 服务器：

Terminal window
claude mcp add-json aptos-mcp '{"command": "npx", "args": ["-y", "@aptos-labs/aptos-mcp"], "type": "stdio", "env": {"APTOS_BOT_KEY": "<your_bot_key>"}}'

故障排查

Section titled “故障排查”
  • 修改 MCP 配置后请完全退出并重新启动 Claude Code，以便重新加载服务器列表。
  • 如果 Aptos 工具没有出现，运行 claude mcp list。
  • 确认 APTOS_BOT_KEY 是有效的 Geomi Bot Key。