﻿---
name: mos-developer-docs
description: >-
  在业务项目中对接 MosApp 开放平台时查阅官方文档（微应用、BOT、客服）。
  需已配置 MCP（mos-developer-docs）；先 fetch llms.txt 再 fetch 具体页面，
  禁止臆造未记载的 API。
---

# MosApp 开发者文档（MCP + Skill）

## 适用场景

当前工作区为 **MosApp 对接业务项目**，不是 mos-docs 文档仓库。

## 前置条件

1. 项目或用户目录已配置 MCP **mos-developer-docs**（`npx mcp-fetch-server`）
2. 配置说明：https://developer.mosapp.app/zh/ai-tools/index.html

## 文档根地址

`https://developer.mosapp.app`

## 推荐工作流（使用 fetch 工具）

1. **fetch** `https://developer.mosapp.app/llms.txt` — 获取全站索引
2. 根据任务 **fetch** 完整 URL（VitePress 文档页须带 `.html`），例如：
   - `https://developer.mosapp.app/zh/guide/sdk.html`
   - `https://developer.mosapp.app/zh/guide/backend.html`
   - `https://developer.mosapp.app/zh/bot/backend.html`
   - `https://developer.mosapp.app/zh/customerService/introduction.html`
3. 正文过长时用 `start_index` 分段继续 fetch 同一 URL

## 按场景优先 URL

| 场景 | URL |
|------|-----|
| 微应用客户端 API | `https://developer.mosapp.app/zh/guide/sdk.html` |
| 微应用服务端 | `https://developer.mosapp.app/zh/guide/backend.html` |
| 登录 / 支付 | `https://developer.mosapp.app/zh/guide/login.html`、`.../payment.html` |
| BOT 后端 | `https://developer.mosapp.app/zh/bot/backend.html` |
| 客服集成 | `https://developer.mosapp.app/zh/customerService/introduction.html` |

英文文档将 `/zh/` 换为对应英文路径，如 `https://developer.mosapp.app/guide/sdk.html`。

## 约束

- **禁止**编造文档未出现的接口、参数、错误码
- 只 fetch `developer.mosapp.app` 官方文档，勿使用第三方转载
- 文档正文页使用 `fetch_txt` 并访问 `.html` URL
