AI Agent 连接指南 (AI Agent Integration Portal)

AMC Growth 提供标准化的 Model Context Protocol (MCP) 端点及 RESTful APIs，支持任何符合规范的 AI 智能体（如 Claude Desktop、Cursor、Gemini Agent）直接对接获取品牌知识数据，并执行自动化增长策略诊断。

🛠️ MCP 接口配置 (Model Context Protocol Configuration)

如果您使用的是 Claude Desktop 或 Cursor 等客户端，可以将以下 JSON 配置片段添加至您的 mcpServers 设置中：

1. 线上云端 HTTP 代理连接 (推荐)

复制配置{
  "mcpServers": {
    "amc-growth": {
      "url": "https://amc-growth.onrender.com/v1/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_KANBAN_TOKEN>"
      }
    }
  }
}

2. 本地 Node.js 命令行直连

复制配置{
  "mcpServers": {
    "amc-growth": {
      "command": "node",
      "args": ["${ROOT}/scripts/serve-api.mjs"],
      "env": {
        "AMC_KNOWLEDGE_TOKEN": "<YOUR_KANBAN_TOKEN>"
      }
    }
  }
}

🧠 Agent 可用技能表 (Exposed MCP Tools & Skills)

Agent 在连接后能够感知并使用以下原子工具：

工具名称 (Tool)	输入参数 (Params)	功能描述 (Description)
knowledge_index	{}	读取 AMC Growth 全局知识库索引目录、品类标签与市场区域划分。
merchant_profile	{ "merchantId": "string" }	读取指定商家的完整诊断清单、战略重点和 30/90/180 天计划配置。
brand_story	{ "merchantId": "string" }	获取指定商家的品牌故事详情、门店分店名录、招牌菜品及用餐预约攻略。

🔌 REST 接口讲解 (RESTful API Documentation)

除 MCP 协议外，还支持使用以下标准化 HTTP APIs 进行数据提取与触发编译：

方法	请求路径 (Path)	说明 (Explanation)
GET	/v1/knowledge/index	获取编译好的知识库索引 JSON 字典。
GET	/v1/knowledge/file?path=<path>	获取指定相对路径 Markdown 文件的原始纯文本内容。
GET	/v1/merchants	列出当前托管的所有商家精简属性列表。
GET	/v1/merchants/:id	获取指定商家的核心 manifest json。
GET	/v1/merchants/:id/brand-story	获取指定商家的品牌故事汇编结果 JSON。
POST	/v1/merchants/:id/export	触发执行增长文件编译流程并导出 JSON。
POST	/v1/merchants/:id/page	触发编译并生成商家的静态落地 HTML 文件。