跳转到主要内容
袋袋专家可以作为 SkillMCP Server 被主流 AI 编程工具调用,开发者在 IDE 中直接获取专家的专业能力。

支持的工具

前置条件

  • 袋袋账号 + Developer 角色
  • API Key(在 开发者控制台 创建,格式 profy_sk_*
  • 专家需要开启 API 访问(apiAccess: "open"

方式一:Skill 接入(推荐,零基础设施)

Skill 是一个 Markdown 文件,教 AI 编程工具如何调用袋袋 API。安装后,agent 会自动识别何时调用袋袋专家。

Claude Code

配置 API Key:
安装后在 Claude Code 中直接说:
“用袋袋的 react-architect 专家审查一下这段代码”
Claude Code 会自动按 Skill 指引调用 POST https://api.profy.cn/v1/experts/react-architect/chat

Cursor

Codex / Cline / Gemini CLI

SKILL.md 放到项目根目录的 agent skills 目录(具体路径因工具而异),确保环境变量 PROFY_API_KEY 已设置。

方式二:MCP Server 接入

MCP (Model Context Protocol) 提供更强的集成能力,让 AI 工具以结构化工具调用的方式使用袋袋专家。

配置 .mcp.json

在项目根目录创建 .mcp.json

Claude Code 注册

可用 Tools(MCP Server 上线后)

MCP Server 端点 mcp.profy.cn 正在开发中。当前请先使用 Skill 方式接入。

API 端点速查

所有请求均需 Authorization: Bearer $PROFY_API_KEY Base URL: https://api.profy.cn

调用专家示例

响应:SSE 流(text/event-stream),Header 中 X-Session-Id 用于多轮对话。

多轮对话

OpenAI 兼容


创作者:如何让你的专家被 AI 编程工具调用

  1. 在 Studio 中编辑你的专家
  2. 设置 API 访问开放(任何持有 API Key 的开发者可调用)
  3. 发布新版本
设置后,你的专家就能被全球开发者在 Claude Code、Cursor、Codex 中直接调用。

常见问题

  • Skill:纯文本指令,教 AI 如何 curl 你的 API。零基础设施,跨平台兼容。
  • MCP Server:结构化工具协议,AI 以 function call 方式调用。更强但需要服务端支持。
推荐从 Skill 开始,MCP Server 上线后可无缝升级。
专家的 api_access 字段为 off(默认值)。联系专家创作者开启 API 访问,或换一个 api_access: open 的专家。
响应为标准 Server-Sent Events 格式。每行以 data: 开头,最终以 data: [DONE] 结束。大多数 HTTP 客户端和 AI 工具原生支持 SSE 解析。
通过 /v1/chat/completions 端点,支持平台已接入的所有模型(DeepSeek、Qwen 等)。具体可用模型取决于平台配置。
按 token 计费(METERED),从 API Key 所属用户的积分中扣除。可在开发者控制台查看用量。

下一步