> ## Documentation Index
> Fetch the complete documentation index at: https://docs.profy.cn/llms.txt
> Use this file to discover all available pages before exploring further.
# MCP Server
> 在 Cursor、Codex 等 IDE 中使用袋袋 MCP Server
袋袋提供 MCP（Model Context Protocol）Server，让你在 Cursor、Codex 或任何 MCP 兼容的 IDE 中，无需离开编辑器即可完成专家的全生命周期管理。
## 快速连接
在你的项目根目录创建或编辑 `.mcp.json` 文件：
```json theme={null}
{
"mcpServers": {
"profy": {
"url": "https://mcp.profy.cn/mcp"
}
}
}
```
MCP Server 使用你的袋袋浏览器登录态进行认证。首次使用时，IDE 会引导你在浏览器中登录袋袋。
## 可用工具（22 个）
袋袋 MCP Server 提供 22 个工具，覆盖专家创建到变现的完整流程。所有工具都是对已有袋袋服务的轻量代理，不引入新的业务逻辑。
### Identity（身份，2 个）
| 工具 | 说明 | 参数 |
| --------------------- | ------------ | -------------------------------------------- |
| `get_creator_profile` | 获取你的创作者资料和状态 | 无 |
| `apply_creator` | 申请成为袋袋市场创作者 | `displayName`, `bio`, `email`, `accountType` |
### 专家 Config（专家配置，4 个）
| 工具 | 说明 | 参数 |
| ------------------- | ---------- | -------------------------------------------------- |
| `create_expert` | 创建新的专家草稿 | `name`, `description?`, `category?` |
| `update_expert` | 更新专家的配置字段 | `identifier`, `name?`, `description?`, `category?` |
| `get_expert_detail` | 获取专家的详细信息 | `identifier` |
| `list_my_experts` | 列出你创建的所有专家 | 无 |
### Skills（技能，3 个）
| 工具 | 说明 | 参数 |
| ------------------------- | ---------- | ------------------------- |
| `install_skill` | 为专家安装市场技能 | `identifier`, `skillName` |
| `list_expert_skills` | 列出专家已安装的技能 | `identifier` |
| `list_marketplace_skills` | 浏览技能市场 | `keyword?` |
### Billing & Publish（计费与发布，3 个）
| 工具 | 说明 | 参数 |
| ----------------------- | -------------- | ------------------------------------------------------------------------- |
| `set_billing` | 设置专家的定价模式和试用配置 | `identifier`, `billingType`, `price?`, `freeTrialPerUser?`, `allowTrial?` |
| `publish_expert` | 提交专家进行审核和发布 | `identifier` |
| `get_submission_status` | 查看专家的审核状态 | `identifier` |
### 蒸馏（2 个）
| 工具 | 说明 | 参数 |
| ----------------------- | ---------------------- | ---------------------- |
| `start_distillation` | 开始蒸馏对话，将你的专业知识注入 AI 专家 | `topic?`, `materials?` |
| `continue_distillation` | 继续蒸馏对话，回答 AI 的提问 | `sessionId`, `message` |
蒸馏工具使用同步 SSE 收集模式，可能需要 \~30 秒完成。请耐心等待响应。
### Testing（测试，2 个）
| 工具 | 说明 | 参数 |
| ------------------ | ---------------- | ----------------------- |
| `test_expert` | 发送测试消息给专家并获取回复 | `identifier`, `message` |
| `open_expert_chat` | 获取专家的浏览器对话页面 URL | `identifier` |
### Navigation（导航，1 个）
| 工具 | 说明 | 参数 |
| ----------------- | ---------- | ------------------------------------------------------- |
| `open_profy_page` | 生成袋袋页面 URL | `page`（studio/chat/marketplace/earnings）, `identifier?` |
### Evolution（进化，3 个）
| 工具 | 说明 | 参数 |
| ---------------------------- | ------------- | -------------- |
| `list_evolution_suggestions` | 列出 AI 生成的改进建议 | `identifier` |
| `accept_evolution` | 接受某条进化建议 | `suggestionId` |
| `get_evolution_stats` | 获取专家的进化统计 | `identifier` |
### Earnings（收益，2 个）
| 工具 | 说明 | 参数 |
| -------------------- | -------------------- | --------------------------------------------- |
| `get_earnings` | 获取创作者收益摘要（钻石余额、待提现等） | 无 |
| `browse_marketplace` | 浏览市场中已发布的专家 | `keyword?`, `category?`, `page?`, `pageSize?` |
## 典型工作流
### 从零创建专家
```
你: 用 create_expert 创建一个名为"代码审查助手"的专家
AI: [调用 create_expert] 已创建，identifier 为 code-review-helper
你: 开始蒸馏，我是一名有 10 年经验的代码审查专家
AI: [调用 start_distillation] 蒸馏开始，AI 正在提问...
你: (回答 AI 的问题)
AI: [调用 continue_distillation] 继续对话...
你: 设置为 METERED 计费，允许 5 次免费试用
AI: [调用 set_billing] 已设置
你: 发布到市场
AI: [调用 publish_expert] 已提交审核
```
### 查看和优化专家
```
你: 列出我的所有专家
AI: [调用 list_my_experts] 你有 3 个专家...
你: 查看 code-review-helper 的进化建议
AI: [调用 list_evolution_suggestions] 有 2 条建议...
你: 接受第一条建议
AI: [调用 accept_evolution] 已接受，技能已更新
你: 查看收益
AI: [调用 get_earnings] 本月收益...
```
## 认证方式
MCP Server 使用袋袋的 Session 认证（Browser Cookie / Bearer Token）。
* **Cursor / Codex IDE 插件**：IDE 会自动处理认证流程，首次使用时弹出浏览器登录
* **手动配置**：如果你的 IDE 不自动处理，确保在浏览器中已登录 `app.profy.cn`
## 袋袋 Plugin（IDE 插件）
袋袋提供 Cursor 和 Codex 的 IDE 插件，包含预配置的 MCP Server 和 4 个专用 Skill：
| Skill | 说明 |
| -------------------- | ------------ |
| **蒸馏** | 引导蒸馏流程 |
| **quick-start** | 快速创建和配置专家 |
| **publish-and-earn** | 发布到市场并开始赚取收益 |
| **evolution** | 查看和管理专家进化 |
插件的 MCP 配置（`.mcp.json`）指向 `mcp.profy.cn/mcp`，与手动配置方式相同。
## 传输协议
袋袋 MCP Server 使用 **Streamable HTTP** 传输（无状态模式），基于 `@modelcontextprotocol/server` SDK 的 `WebStandardStreamableHTTPServerTransport`。
关键特性：
* **无状态**：不维护 Session，每个请求独立处理
* **CORS**：支持跨域请求（MCP 必需的头部）
* **超时**：服务端 300 秒超时（适配蒸馏等耗时操作）
* **路径**：所有 MCP 请求发送到 `/mcp`
## 注意事项
`start_distillation` 和 `continue_distillation` 内部通过 SSE Collector 同步调用 invoke 端点，可能需要 20-60 秒。这是正常的——蒸馏涉及多轮 AI 交互。
`test_expert` 同样通过 SSE Collector 同步等待专家回复。简单对话通常在 5-15 秒内完成。
大部分工具需要登录的袋袋账号。创建和发布专家需要先通过 `apply_creator` 申请创作者资格。
除 `browse_marketplace` 和 `list_marketplace_skills` 外，所有工具都需要认证。未登录时调用会返回认证错误提示。
## 下一步
使用 API 进行第一次调用
构建一个完整的袋袋 App