lemon-agi 接入说明

MCPStreamable HTTP

文档目录

lemon-agi MCP 接入

lemon-agi 通过 MCP 暴露 SkillHub 中的乐檬 AGI Ability。客户端可以搜索 Ability、读取接口文档，并在完成身份验证后调用 Ability。

接入前准备

请先准备以下信息：

可以访问 https://cloud.nhsoft.cn/agi/mcp。
乐檬 AGI 个人访问令牌。前往“乐檬零售后台 → 档案 → 用户中心 → 用户 → 用户令牌管理”获取。
支持 Streamable HTTP 传输方式的 MCP 客户端。

个人访问令牌只应保存在本机环境变量或客户端的安全凭据存储中，不要写入项目文件、提交记录或截图。

仅搜索和阅读文档时可以不提供令牌；验证身份或调用 Ability 时必须提供。

连接参数

配置项	值
服务名称	`lemon-agi`
传输方式	`Streamable HTTP`
MCP 地址	`https://cloud.nhsoft.cn/agi/mcp`
SkillHub Web 地址	`https://agi.lemengcloud.com/`
鉴权方式	`Authorization: Bearer <个人访问令牌>`
请求类型	`Content-Type: application/json`
响应类型	`Accept: application/json, text/event-stream`

客户端统一连接以下地址：

https://cloud.nhsoft.cn/agi/mcp

配置 MCP 客户端

Codex

先在启动 Codex 的终端中设置令牌：

export LEMON_AGI_PERSONAL_TOKEN='<个人访问令牌>'

在 ~/.codex/config.toml 中增加：

[mcp_servers.lemon-agi]
url = "https://cloud.nhsoft.cn/agi/mcp"
bearer_token_env_var = "LEMON_AGI_PERSONAL_TOKEN"
default_tools_approval_mode = "prompt"

重新启动 Codex 后，可以在 /mcp 中查看连接状态。

Claude Code

先在启动 Claude Code 的终端中设置令牌：

export LEMON_AGI_PERSONAL_TOKEN='<个人访问令牌>'

在项目根目录的 .mcp.json 中增加：

{
  "mcpServers": {
    "lemon-agi": {
      "type": "http",
      "url": "https://cloud.nhsoft.cn/agi/mcp",
      "headers": {
        "Authorization": "Bearer ${LEMON_AGI_PERSONAL_TOKEN}"
      }
    }
  }
}

重新启动 Claude Code 后，可以使用 /mcp 查看连接状态。项目级 MCP 第一次启用时，需要确认信任该服务。

WorkBuddy

WorkBuddy 支持以下配置位置：

用户级：~/.workbuddy/mcp.json，推荐使用
项目级：<项目目录>/.workbuddy/mcp.json，必须排除版本控制

由于配置中包含个人访问令牌，建议在用户级 mcp.json 中增加以下内容，并将 <个人访问令牌> 替换为实际令牌：

{
  "mcpServers": {
    "lemon-agi": {
      "type": "http",
      "url": "https://cloud.nhsoft.cn/agi/mcp",
      "headers": {
        "Authorization": "Bearer <个人访问令牌>"
      },
      "disabled": false
    }
  }
}

也可以在 WorkBuddy 侧边栏进入“插件 → MCP 服务器 → 配置 MCP”填写以上内容。保存后确认信任该服务，并检查状态是否显示为可用。

验证连接

完成配置并重新连接服务后，直接调用 whoami 工具，无需填写参数：

工具: whoami
参数: 无

能够返回当前令牌对应的用户身份，即表示 MCP 地址和个人访问令牌均配置成功。如果工具列表中没有 whoami，请先检查令牌配置并重新连接服务。

可用工具

工具	是否需要令牌	用途
`search_agi_abilities`	否	按关键词、应用、请求方法或标签查找已发布的 Ability
`get_agi_ability_document`	否	读取指定 Ability 的完整 OpenAPI 文档
`call_agi_ability`	是	以 `GET` 或 `POST` 调用指定 Ability
`whoami`	是	查看当前令牌对应的用户身份

未提供有效令牌时，工具列表只会显示 search_agi_abilities 和 get_agi_ability_document。这可以用于只读检索，但不能调用 Ability。

常见问题

返回 404

确认客户端使用完整地址 https://cloud.nhsoft.cn/agi/mcp，不要遗漏 /agi/mcp 路径。

只能看到两个工具

客户端没有携带有效的 Bearer Token。检查 Authorization 请求头，并在修正后重新连接 MCP 服务以刷新工具列表。

返回 401 或 403

确认请求头格式为 Authorization: Bearer <个人访问令牌>，Bearer 与令牌之间必须有一个空格。令牌不能为空，也不要使用其他鉴权 scheme。

客户端无法解析响应

确认客户端支持 Streamable HTTP，并同时声明接受 application/json 和 text/event-stream。服务不提供 stdio 传输。