# 奇绩创坛 Agent 接入说明

## 无需连接 MCP 的读取方式
- [llms.txt](https://www.miracleplus.com/cn/llms.txt)：公开资料导航。
- [llms-full.txt](https://www.miracleplus.com/cn/llms-full.txt)：官网公开页面合集。
- [public-documents.json](https://www.miracleplus.com/cn/public-documents.json)：带稳定文档 ID、语言、原文地址及 Markdown 正文的目录；`languages` 提供各语言目录地址。
- [facts.json](https://www.miracleplus.com/facts.json)：官网公开事实。
- [skill.md](https://www.miracleplus.com/cn/skill.md)：查询与引用流程。

## 只读 MCP
配套服务部署并验证后，支持远程 Streamable HTTP 的客户端可显式连接：

```json
{
  "mcpServers": {
    "miracleplus-public": {
      "type": "http",
      "url": "https://apply.miracleplus.com/mcp"
    }
  }
}
```

配置格式因客户端而异，请在其远程 MCP 设置中填写该地址。提供 `search_public_content` 与 `get_public_document` 两个只读工具；不提供申请提交、后台查询或管理功能。官网为静态站，MCP 由申请站服务承载，官网文件上线不代表配套服务已经上线。

## Skill 安装与发现
可直接将 skill.md 作为参考资料读取；若客户端支持 Agent Skills，将其保存到该客户端技能目录下的 `miracleplus-official-research/SKILL.md`。公开文件不会自动安装，也不会自动授予 agent 权限。

## 事实与权限边界
官网负责品牌和项目说明；当前申请状态以申请站业务数据及当前申请页面为准。两者冲突时须提示用户，不隐瞒冲突。公开预览不等于完整文章。所有回答应附来源链接。