Perfly MCP

Perfly Agent

Perfly Agent は、コーディングアシスタントを Perfly に接続します。これにより、エージェントにソースコード、課題本文、プルリクエスト、ドキュメント、社内 SaaS アカウントへのアクセスを与えることなく、承認済みの作業概要を Perfly の Today タイムラインに記録できます。

このリポジトリには、Perfly Agent Sync の公開エージェント向けパッケージが含まれています。

パッケージ	目的
mcp/	ホスト型 MCP サーバーのメタデータ、セットアップ手順、クライアントの例。
skill/	Codex、Claude Code、および互換性のあるコーディングエージェント向けの英語の標準 Skill 指示。

機能

Perfly Agent Sync は、コーディングエージェントに限定的な書き込み専用ワークフローを提供します。

1. 簡潔な作業概要の項目をプレビューします。
2. 無人送信が明示的に有効になっていない場合、確認を求めます。
3. 選択した概要を、レビュー可能な Today エントリーとして Perfly に書き込みます。

MCP サーバーでは、次のツールを利用できます。

ツール	目的
perfly_check_connection	接続を確認し、秘密情報を含まないトークンとクライアントのメタデータを返します。
perfly_get_ingestion_policy	Perfly のプライバシー規則と書式規則を返します。
perfly_preview_work_items	項目を検証し、レコードを書き込まずに送信内容をプレビューします。
perfly_add_work_items	選択した概要を、レビュー可能な Today の未加工エントリーとして Perfly に書き込みます。

推奨セットアップ

ホスト型 MCP エンドポイントを使用してください。

https://api.perfly.dev/mcp

Perfly は、サーバーから認証情報を取得するクライアント向けに MCP OAuth をサポートしています。ブラウザーの OAuth フローを完了できないクライアントや環境向けには、Perfly アプリで作成できる書き込み専用のベアラートークンもサポートしています。

まず、MCP パッケージを確認してください。

• MCP のセットアップ
• Claude Code の例
• Codex 設定の例
• Cursor 設定の例

次に、Skill の指示をインストールするかコピーしてください。

• Perfly Agent Sync Skill

プライバシーの境界

Perfly Agent Sync は、概要のメタデータのみを扱うよう設計されています。

次の情報は送信しないでください。

• ソースコードや差分
• 秘密情報や認証情報
• 顧客データ
• 課題本文やプルリクエスト本文
• ドキュメント本文や添付ファイル
• 端末出力やログの全内容

エージェントが送信するのは、短いタイトル、任意のメモ、タイムスタンプ、ソースラベル、簡潔なメタデータ参照のみとしてください。

パッケージとレジストリ

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