MCP Tools

Profy 提供一个远程 MCP（Model Context Protocol）Server，让你在 Codex、Cursor、Claude Code 等支持 MCP 的 IDE 里完成”蒸馏 → 配置 → 发布 → 变现”全流程，不用离开编辑器。

https://mcp.profy.cn/mcp

传输方式是 Streamable HTTP，无状态（不维护 session）。

接入

.mcp.json

{
  "mcpServers": {
    "profy": {
      "type": "streamable-http",
      "url": "https://mcp.profy.cn/mcp"
    }
  }
}

鉴权复用平台的登录会话，支持两种方式：

Authorization: Bearer <token>
浏览器 Cookie（IDE 内嵌浏览器场景）

未认证时调用任何需要身份的工具会直接报错——不会降级成匿名操作。

工具全表

22 个工具，全部是对已有平台服务的薄代理，不含独立业务逻辑。

身份（2）

工具	参数	用途
`get_creator_profile`	无	查询你的创作者状态与详情
`apply_creator`	`displayName`、`bio`、`accountType`、`email`	申请成为创作者

apply_creator 提交后进入人工审核。审核结果通过站内信通知，不在 MCP 侧轮询。

专家配置（4）

工具	参数	用途
`create_expert`	`name`、`description`、`category`	创建专家草稿
`update_expert`	`identifier` + `name` / `description` / `category`	更新专家配置字段
`get_expert_detail`	`identifier`	获取某个专家的详情
`list_my_experts`	无	列出你创建的全部专家

update_expert 只覆盖基础元信息。prompt 分层（GUARD / persona / soul / agent）、subagents、caseDemos 这些字段不在 MCP 表面——它们要么涉及知识产权、要么结构复杂到不适合从 IDE 盲改。这些配置走 Studio。

技能（3）

工具	参数	用途
`install_skill`	`identifier`、`skillName`	给专家安装市场技能
`list_expert_skills`	`identifier`	列出专家已装技能
`list_marketplace_skills`	`keyword`	浏览技能市场

install_skill 是 stub，不会真正安装。当前实现只写一条日志然后返回 {"success": true, "installed": "<skillName>"}，安装服务尚未接线。也就是说：调用成功、返回成功、随后 list_expert_skills 里什么都没多。这是最危险的一类缺陷——失败态伪装成成功态，你不会收到任何错误，只会疑惑”为什么技能没生效”。安装技能请走 Studio 或 POST /api/expert-skills/install。

计费与发布（3）

工具	参数	用途
`set_billing`	`identifier`、`billingType`、`price`、`freeTrialPerUser`、`allowTrial`	设定定价与试用
`publish_expert`	`identifier`	提交发布审核
`get_submission_status`	`identifier`	查询审核状态

set_billing 的 billingType 枚举是 METERED | ONE_TIME，但这两个名字不对应真实的计费模型：

METERED → 实际写入价格 0 → 专家变成免费
ONE_TIME → 写入 price → 专家变成买断解锁

平台侧只有 FREE 与 UNLOCK 两种，没有按量计费的专家。所以传 METERED 期待”按用量收费”，得到的是”完全免费”。这是 MCP 表面命名与底层模型的漂移，命名以底层为准。

freeTrialPerUser 默认 3，allowTrial 默认 true。价格与试用的完整约束见定价与计费。 publish_expert 是提交审核，不是直接上线；已上架专家发新版时老版本保持在线。

蒸馏（2）

工具	参数	用途
`start_distillation`	`topic`、`materials[]`（`filename` + `content`）	开始蒸馏对话，可带本地素材
`continue_distillation`	`sessionId`、`message`	回答 AI 的追问，推进蒸馏

蒸馏是多轮对话：start_distillation 返回 sessionId，之后每次回答都用 continue_distillation 带着这个 id。这两个工具内部通过 SSE collector 调用 invoke 端点，把流式响应收敛成一次同步返回——所以单次调用可能耗时较长。 materials 直接传文件内容（不是路径），这样 IDE 里的本地文件不用先上传就能进蒸馏。

测试（2）

工具	参数	用途
`test_expert`	`identifier`、`message`	给专家发一条消息看回复
`open_expert_chat`	`identifier`	拿到浏览器里和专家对话的 URL

test_expert 会真实执行并真实计费。想免费看效果就用 open_expert_chat 在浏览器里试。

可视化（1）

工具	参数	用途
`open_profy_page`	`page`（`studio` / `chat` / `marketplace` / `earnings`）	拿到四个检查点页面的 URL

它只返回 URL，不打开浏览器——具体怎么打开由 IDE 决定。

自进化（3）

工具	参数	用途
`list_evolution_suggestions`	`identifier`	列出待处理的进化建议
`accept_evolution`	`suggestionId`	采纳一条建议
`get_evolution_stats`	`identifier`	查看进化统计与趋势

accept_evolution 采纳后立即生效，无需重新审核——技能文档是运行时读取的。这也意味着采纳前应当先读建议内容，机制见自进化。

收益（2）

工具	参数	用途
`get_earnings`	无	收益汇总（钻石余额与待提现）
`browse_marketplace`	`keyword`、`category`、`page`、`pageSize`	浏览已发布专家

browse_marketplace 是全表唯一不要求登录身份的工具。

典型流程

在 IDE 里从零做出一个专家：

get_creator_profile          确认创作者状态
apply_creator                （若尚未入驻）
start_distillation           带上本地素材开始蒸馏
continue_distillation × N    回答追问直到蒸馏完成
get_expert_detail            核对生成的配置
set_billing                  定价与试用
test_expert                  实测一条（会计费）
publish_expert               提交审核
get_submission_status        跟进审核结果

边界与失败态

症状	原因	处理
工具报未认证	没带 Bearer token 或 Cookie 失效	重新登录后重连 MCP
`install_skill` 成功但技能没装上	该工具是 stub	改走 Studio 或 REST 端点
`set_billing` 传 `METERED` 后专家免费	枚举名与底层模型漂移	想收费用 `ONE_TIME` + `price`
`publish_expert` 成功但线上没变	提交的是审核，不是上线	用 `get_submission_status` 跟进
蒸馏工具长时间无响应	内部同步消费 SSE 流，耗时较长	提高 IDE 的 MCP 超时设置
`test_expert` 扣了积分	它是真实执行	免费预览用 `open_expert_chat`

验证接入

在 IDE 里让模型调一次 list_my_experts。返回你的专家列表说明鉴权与传输都通了；报未认证说明 token 没传到。不确定工具是否被发现时，看 IDE 的 MCP 面板里 profy 这一项下有没有 22 个工具——数量对不上通常是传输层（streamable-http）配错成了 stdio。

端点速查

直接走 REST 的等价能力

蒸馏

蒸馏的完整机制

自进化

进化建议怎么读

定价与计费

价格与试用的真实约束

核对日期 2026-08-11。来源：services/core/src/routes/mcp/tools/index.ts（22 处 registerTool）、services/core/src/routes/mcp/index.ts（传输层）、services/core/src/routes/mcp/auth.ts（鉴权）。

开始使用

认证与密钥

API 能力指南

SDK

集成

Cookbook

参考

MCP Tools

MCP Tools

接入

工具全表

身份（2）

专家配置（4）

技能（3）

计费与发布（3）

蒸馏（2）

测试（2）

可视化（1）

自进化（3）

收益（2）

典型流程

边界与失败态

验证接入

相关页面

端点速查

蒸馏

自进化

定价与计费

​MCP Tools

​接入

​工具全表

​身份（2）

​专家配置（4）

​技能（3）

​计费与发布（3）

​蒸馏（2）

​测试（2）

​可视化（1）

​自进化（3）

​收益（2）

​典型流程

​边界与失败态

​验证接入

​相关页面

端点速查

蒸馏

自进化

定价与计费

MCP Tools

接入

工具全表

身份（2）

专家配置（4）

技能（3）

计费与发布（3）

蒸馏（2）

测试（2）

可视化（1）

自进化（3）

收益（2）

典型流程

边界与失败态

验证接入

相关页面