# Circow 开发者文档

> Circow（圈牛）是一个「AI 员工」平台：用户在平台上编排工作流（Flow，即一个 AI 员工），通过网页、桌面客户端、微信客服、HTTP API 等渠道使用它。本文档面向要把 AI 员工接入自己系统、或为员工扩展新工具的外部开发者。所有能力共用同一套账号与计费。

四种接入方式：
1. HTTP API —— 服务端调用工作流：同步 / 流式（SSE）/ 文件上传，Bearer Key 鉴权，session_id 多轮续接
2. Deep Link（桌面唤起）—— 本机软件通过自定义 URL 协议拉起桌面客户端，指定工作流、预填 prompt、可选自动发送
3. Skill 开发 —— 一个 SKILL.md + 本机 CLI 工具，为员工扩展本机能力，可发布到技能市场
4. MCP Server 开发 —— 按 Model Context Protocol 开发工具服务，绑定到工作流后即可被 AI 调用

站点：国内 https://circow.cn （应用 https://app.circow.cn）· 海外 https://circow.com （应用 https://app.circow.com）。
本文档为中文。全文单文件版：https://circow.cn/docs/llms-full.txt

## 文档

- [概览与术语](https://circow.cn/docs/index.md)：平台概念（Flow / 员工 / Skill / MCP / 市场）、四种接入方式如何选
- [HTTP API](https://circow.cn/docs/api.md)：鉴权、请求体、同步调用、SSE 流式、文件上传、会话列表、消息历史、错误码，含 curl / Python 示例
- [桌面唤起 Deep Link](https://circow.cn/docs/deep-link.md)：协议结构、scheme、run-flow / install-skill / install-mcp / manage-mcp / install-template 各 action 参数、安全模型
- [Skill 开发](https://circow.cn/docs/skills.md)：目录结构、SKILL.md frontmatter、description 编写规范、skill-manager 命令、注入的环境变量、发布
- [MCP Server 开发](https://circow.cn/docs/mcp.md)：mcp.json schema、server.py 要点、mcp_tool.py 安装/列表/发布、npx 预热、分发
- [发布渠道](https://circow.cn/docs/channels.md)：微信客服 / API / Deep Link 已可用，网页嵌入 / Webhook 规划中

## 可选

- [完整文档单文件版 llms-full.txt](https://circow.cn/docs/llms-full.txt)：以上全部内容拼接，适合一次性喂给 AI