MCP Server

袋袋提供 MCP（Model Context Protocol）Server，让你在 Cursor、Codex 或任何 MCP 兼容的 IDE 中，无需离开编辑器即可完成专家的全生命周期管理。

快速连接

在你的项目根目录创建或编辑 .mcp.json 文件：

{
  "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`

工具	说明	参数
`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 也是同步的

test_expert 同样通过 SSE Collector 同步等待专家回复。简单对话通常在 5-15 秒内完成。

需要创作者身份

大部分工具需要登录的袋袋账号。创建和发布专家需要先通过 apply_creator 申请创作者资格。

所有写操作需认证

除 browse_marketplace 和 list_marketplace_skills 外，所有工具都需要认证。未登录时调用会返回认证错误提示。

概览

Platform API

认证与密钥

集成

SDK

Cookbook

参考

快速连接

可用工具（22 个）

Identity（身份，2 个）

专家 Config（专家配置，4 个）

Skills（技能，3 个）

Billing & Publish（计费与发布，3 个）

蒸馏（2 个）

Testing（测试，2 个）

Navigation（导航，1 个）

Evolution（进化，3 个）

Earnings（收益，2 个）

典型工作流

从零创建专家

查看和优化专家

认证方式

袋袋 Plugin（IDE 插件）

传输协议

注意事项

下一步

快速开始

App 开发指南

​快速连接

​可用工具（22 个）

​Identity（身份，2 个）

​专家 Config（专家配置，4 个）

​Skills（技能，3 个）

​Billing & Publish（计费与发布，3 个）

​蒸馏（2 个）

​Testing（测试，2 个）

​Navigation（导航，1 个）

​Evolution（进化，3 个）

​Earnings（收益，2 个）

​典型工作流

​从零创建专家

​查看和优化专家

​认证方式

​袋袋 Plugin（IDE 插件）

​传输协议

​注意事项

​下一步

快速开始

App 开发指南

快速连接

可用工具（22 个）

Identity（身份，2 个）

专家 Config（专家配置，4 个）

Skills（技能，3 个）

Billing & Publish（计费与发布，3 个）

蒸馏（2 个）

Testing（测试，2 个）

Navigation（导航，1 个）

Evolution（进化，3 个）

Earnings（收益，2 个）

典型工作流

从零创建专家

查看和优化专家

认证方式

袋袋 Plugin（IDE 插件）

传输协议

注意事项

下一步