Perfly MCP

Perfly Agent

Perfly Agent 将编码助手连接到 Perfly，让助手能够将经批准的工作摘要写入 Perfly Today 时间线，同时无需授予 Agent 访问源代码、问题正文、拉取请求、文档或公司 SaaS 账户的权限。

此仓库包含 Perfly Agent Sync 面向 Agent 的公开软件包：

软件包	用途
mcp/	托管 MCP 服务的元数据、设置说明和客户端示例。
skill/	适用于 Codex、Claude Code 和兼容编码 Agent 的英文标准 Skill 说明。

功能

Perfly Agent Sync 为编码 Agent 提供范围有限的只写工作流：

1. 预览简洁的工作摘要条目。
2. 除非明确启用了无人值守提交，否则请求确认。
3. 将选定的摘要写入 Perfly，作为可审核的 Today 条目。

MCP 服务提供以下工具：

工具	用途
perfly_check_connection	验证连接并返回非机密的令牌/客户端元数据。
perfly_get_ingestion_policy	返回 Perfly 的隐私和格式规则。
perfly_preview_work_items	验证条目并预览即将提交的内容，但不会写入记录。
perfly_add_work_items	将选定的摘要写入 Perfly，作为可审核的 Today 原始条目。

推荐设置

使用托管 MCP 端点：

https://api.perfly.dev/mcp

Perfly 支持 MCP OAuth，适用于可从服务发现授权信息的客户端。对于无法完成浏览器 OAuth 流程的客户端或环境，Perfly 也支持在 Perfly 应用中创建的只写 Bearer 令牌。

先从 MCP 软件包开始：

• MCP 设置
• Claude Code 示例
• Codex 配置示例
• Cursor 配置示例

然后安装或复制 Skill 说明：

• Perfly Agent Sync Skill

隐私边界

Perfly Agent Sync 专为摘要元数据而设计。

请勿提交：

• 源代码或差异
• 机密信息或凭据
• 客户数据
• 问题正文或拉取请求正文
• 文档正文或附件
• 完整的终端输出或日志

Agent 仅应提交简短标题、可选备注、时间戳、来源标签和精简的元数据引用。

软件包和注册表

MCP 注册表应指向：

mcp/

或：

mcp/manifest.json

Skill 中心应指向：

skill/

或：

skill/SKILL.md

当前的 ClawHub 条目：

https://clawhub.ai/levi840714/skills/perfly-skill

当前的 Smithery 条目：

https://smithery.ai/servers/perfly/perfly-mcp
https://smithery.ai/skills/perfly/perfly-skill

项目链接

• Perfly：https://perfly.dev
• 应用设置页面：https://app.perfly.dev/agent-setup
• MCP 端点：https://api.perfly.dev/mcp