Phyll について
Phyllは、CodexやClaude CodeなどMCP対応エージェントに、ブラウザベースのUXレビュー機能を追加します。エージェントがアプリの主要タスクを試し、デザインを保ったまま使いにくい点を報告します。
主な機能
- 01ブラウザでアプリの主要タスクをレビュー
- 02PC・スマートフォン画面での撮影とページ調査
- 03ソースコード内のAI特有表現のスキャン
- 04リンク付きレビュー報告の保存
- 05対応エージェントや他のMCPクライアント向け設定
活用シーン
- 01アプリの主要なユーザーフローのレビュー
- 02ボタンの不具合など使いにくい点の発見
- 03ソースコード内のAI特有表現のスキャン
MCP 対応
Phyllはエージェント用のMCPコネクターとして動作し、ブラウザー操作、レビュー、スキャン、アカウント、アップグレードのツールを提供します。setupコマンドで対応エージェントに登録するか、他のMCPクライアント用設定を出力できます。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
18掲載時のツール一覧 · 2 週間前に更新
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| url | string | はい | アプリが稼働し、応答するアドレス(例:http://localhost:3000)。アプリが起動していない場合は、先に起動してください。 |
| jobs | array | いいえ | エンドユーザーがアプリで行う 2、3 個のことを、本人の言葉で記入します(例:Book a haircut)。本人が述べていない場合は省略してください。 |
| name | string | いいえ | agentphyll.com のレポートでプロジェクト名として使う製品名です。省略すると、まず .phyll/config.json から、次にフォルダー名から取得します。 |
| user | string | いいえ | 誰がアプリを使うかを、本人の言葉で記入します(例:スマートフォンで予約する理髪店の顧客)。本人が述べていない場合は省略してください。 |
| language | string | いいえ | レポートの言語コード(例:en、pt-BR)。ユーザーが文章を書く言語を使用します。省略すると、まずプロジェクトの .phyll/config.json から、次にこのコンピューターの言語設定から取得します。 |
| project_dir | string | いいえ | プロジェクトフォルダーがエージェントの実行フォルダーと異なる場合に、そのパスを指定します。相対パスはそのフォルダーを起点とします。 |
詳細
phyll
すでにお使いのエージェント内で、AI で構築したアプリの UX をレビューします。
Phyll は Codex、Claude Code、または MCP に対応するエージェントに接続します。エージェントは初めて使うユーザーのようにアプリを開き、実際のブラウザーで主要なタスクを実行して、妨げになるものをレポートにまとめます。タスクに必要以上の情報を求めるフォーム、サインアップを求める画面、機能しないボタン、薄すぎて読みにくいテキストなどです。修正では、デザインを維持します。
AI による作業は、お使いのプランでエージェント内で実行されます。このパッケージでは、ブラウザー、ページプローブ、ソーススキャナー、Phyll のエンジンへの接続機能を追加します。エンジンはレビュー手法を提供し、レポートを確認して、リンクとともに保存します。
はじめる
npx phyll signup [email protected]
npx phyll setup codex # or claude, cursor, windsurf, gemini
その後、エージェントに「http://localhost:3000 のアプリをレビューして」と依頼してください。
setup は、Codex の config.toml にコネクターを登録し、claude mcp add を実行するか、Cursor の ~/.cursor/mcp.json、Windsurf の ~/.codeium/windsurf/mcp_config.json、または Gemini CLI の ~/.gemini/settings.json の mcpServers に登録します。ファイル内のほかの内容はそのまま保持されます。また、コネクターが使用する Chromium ビルドもインストールします。MCP サーバーに対応するほかのエージェントでは、npx phyll setup other を実行すると、貼り付ける設定項目が表示されます。Node 20 以降が必要です。
レポート、キー、プランはサイトでも確認できます。npx phyll account を実行すると、サインイン済みの状態でアカウントが開きます。キーを紛失した場合は、メールアドレスを使って agentphyll.com/login にサインインし、新しいキーを作成してください。
コマンド
| コマンド | 機能 |
|---|---|
signup <email> | 無料アカウントを作成します。フルレビューを5回利用できます。キーは ~/.phyll に保存されます |
login <key> | このコンピューターですでにお持ちのアカウントを使用します |
setup <agent> | Phyll を codex、claude、cursor、windsurf、または gemini に接続し、ブラウザーをインストールします。setup other を実行すると、ほかのエージェント向けの設定が表示されます |
status | プランと残りのレビュー回数を表示します |
account | サインイン済みの状態で agentphyll.com のアカウントを開きます。レポート、利用状況、キー、プランを確認できます |
pro | Phyll Pro に登録します。月額 R$ 9 で、レビューを無制限に利用できます |
billing | カードを変更するか、Phyll Pro を解約します |
scan [folder] | アカウントも AI も使わずに、ソースに含まれる AI らしさを示す表現をスキャンします。スクリプト向けには --format json、README バッジ向けには --format badge を指定します |
mcp | エージェント用のコネクターを実行します。コネクターは setup で登録できます |
logout | このコンピューターに保存されているキーを削除します |
エージェントが利用できるツール
start_review はプロジェクトをスキャンし、レポート用フォルダーを作成して、レビュー手法を返します。capture は、各ルートのスクリーンショットとページプローブを、ノート PC とスマートフォンの画面サイズで保存します。open、snapshot、click、fill、select、check、press、back、screenshot、probe、resize はブラウザーを操作します。ブラウザーはアプリを表示したままになります。guide は手法の一部を返し、finish_review はレポートをエンジンに送信して report.md に書き込みます。scan、account、upgrade は、それぞれ名前のとおりの処理を行います。
コンピューターの外部に送信されるデータ
ソースコード、スクリーンショット、エージェントとの会話は、すべてコンピューター上にとどまります。レビューの開始時に、コネクターはアプリのアドレス、プロジェクト名、スキャンの概要を送信します。概要には、検出された内容、検出回数、ルートとフォームのパスが含まれます。レビューの終了時には、エージェントが作成したレポートを送信します。エンジンはリンクが機能するよう、このレポートを保存します。
詳細
スキャナー、プラグイン、4つのサンプルアプリはリポジトリにあります。MIT ライセンスです。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。