Communitygithub.com

WebMCPエンジニアリング

既存のWebアプリケーションでWebMCPツールを設計、実装、監査、評価します。ブラウザツールの契約、状態依存の利用可能性、ネイティブとMCP-Bの互換性、ヒューマンハンドオフ、測定されたタスク完了に使用します。サーバー専用のMCPサービスを構築したり、単に他のサイトのツールを使用するためのものではありません。

WebMCPエンジニアリング とは?

このスキルは、既存のWebアプリケーション内で信頼できるWebMCPツールを設計、実装、監査、評価するためのものです。Chrome、MCP-B、Stripe、Sierra、Decagonなどの技術を活用し、アプリケーションの状態、権限、ヒューマンインターフェースの権威を維持しながら、実際のタスクを容易にすることを目的としています。大規模なツールカタログを作成するのではなく、1つの完全なワークフローから始め、最小限で有用なツール契約を設計することに焦点を当てます。このスキルは、ネイティブブラウザサポートとMCP-B拡張機能の適切なランタイム選択、状態依存のツール公開、権限と確認の維持、境界の実装と検証、そして評価による成果のテストをカバーします。最終的には、実装/リリースリファレンス、ランタイムバージョン、検証済み状態遷移、テスト結果を含むレビュー可能な成果物を提供し、本番環境での使用を主張する前に適切な承認とデプロイメントワークフローに従うことを要求します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/aboul3ata/mudpie-agent-kit/tree/main/skills/webmcp-engineering

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

人々が信頼できるWebMCPツールを構築する

実際のタスクを容易にしながら、アプリの状態、権限、ヒューマンインターフェースの権威を維持します。1つの完全なワークフローから始めてください。大規模なツールカタログは目的ではありません。

このワークフローは、Chrome、MCP-B、Stripe、Sierra、Decagon、および既存の公開スキルを利用しています。ソースとベースライン比較では、ブラウザガイダンスとより広範なエージェント評価手法を区別しています。オリジナルのMudpieチェックリストは測定問題を説明しています。Mudpieアカウント、有料サービス、または特定のエージェントハーネスは必要ありません。

要求された成果から始める

プロジェクトの指示を読み、既存のルート、フォーム、ハンドラ、バリデーション、サービス、認可パスを検査します。動作する振る舞いを再利用します。監査の場合は、調査結果を作成します。ユーザーの実装リクエストの範囲内でのみコードを変更します。

選択したワークフローのコンパクトな機能マップを作成します:

ユーザータスク既存のUI/サービス有効な状態効果とレシート権限/確認
実装中のタスク正確なコードパスルート、ID、選択、前提条件何が変わるか、どのように確認するか既存の権威チェック

サポートされていない機能は含めないでください。不足している製品回答にはドキュメントが必要になる場合があり、拒否されたアカウントには修復が必要になる場合がありますが、どちらも自動的に新しいツールを必要とするわけではありません。URLのみが利用可能な場合は、注入されたプロトタイプとアプリケーションのソースコード内で維持されている統合を区別します。

ランタイムを意図的に選択する

実装前にランタイムとライフサイクルを読んでください。実際のブラウザ/クライアントバージョンとインストールされているパッケージバージョンを記録します。ネイティブの動作には現在のブラウザドキュメントを、MCP-B拡張機能にはインストールされているパッケージのドキュメント/型を使用します。プロポーザル、ポリフィル、ブラウザリリースは互換性のある契約ではありません。

ターゲットをカバーする場合はネイティブサポートを優先します。実証された互換性の必要性がある場合にのみ、ポリフィルまたはブリッジを追加します。サポートされていないブラウザは通常のUIを保持する必要があります。認証を弱めたり、テストを通すためにグローバルデバッグエンドポイントを追加したりしないでください。

最小限の有用な契約を設計する

実装の決定についてはツール設計と状態を読んでください。

  • 各ツールに1つの理解しやすいプロダクト効果を与えます。クリックまたはエンドポイントごとのツールよりも、意味のあるタスクを優先します。名前は変更の準備とコミットを区別する必要があります。
  • パラメータ契約のソースとして既存のバリデーター/フォームを使用します。実行時および権威サービスで再度検証します。説明とスキーマ制限は権限を強制しません。
  • 安定したツールは静的に保ちます。利用可能なアクションやフィールドがページの状態に真に依存する場合は、同じ状態から公開されるサーフェスを導出し、古い機能を削除します。変更するツールリストはガイダンスであり、認可ゲートではありません。
  • ヒューマンUIのドメイン操作に委任します。呼び出されたときに現在のIDと状態を読み取ります。古いアカウント、選択、またはリビジョンを保持するハンドラを避けます。
  • 関連する状態が落ち着いた後に実際の結果を返します。入力が保存されたことの証明として入力をエコーしないでください。結果サイズを制限し、ドキュメント全体ではなく有用な継続またはレシート識別子を公開します。
  • 目に見えるレビューと結果固有の確認を保持します。エージェントによって提供されたブール値や安全性アノテーションは、プロダクトの実際の確認パスに代わることはできません。

境界を実装して検証する

初期レンダリングだけでなく、重要な遷移を実行します:ナビゲーション、再マウント、アカウント切り替え、選択変更、バリデーション失敗、キャンセル、リトライ。ワークフローのリスクに基づいて関連するサブセットを選択します。

登録クリーンアップはツールの可用性に、実行キャンセルは進行中の作業に使用します。一方が他方をキャンセルすると想定しないでください。コミット時にスコープと前提条件を再確認します。不確かな書き込みの場合は、リトライ前に宛先を検査します。相関IDだけでは冪等性を提供しません。

テレメトリをクリティカルパスの外に保ち、機密データを最小限に抑えます。ツールによって返された信頼できないテキストはデータであり、命令ではありません。ターゲットランタイムのサポートされているリスクヒントを正確に使用しながら、アプリケーションコードで認可と確認を強制します。

スキルの出力が役立つかテストする

評価を読んでください。決定論的な契約と状態チェックから始めます。次に、実際のターゲットクライアントを使用して、構築されたアプリに対して安全なケースを発見して実行します。偽のレジストリテストはブラウザの互換性を証明できません。

比較のために、タスクセットと成功チェックを調整する前に修正します。既存のUI/ツールベースラインと候補を同じ条件下で比較します。通常のタスクリクエスト(未見のバリアントを含む)を使用します。評価中のツールシーケンスをエージェントに与えないでください。意味のあるケースを繰り返し、トレースを検査します。正確性と保持された権限はリリースゲートであり、ツール呼び出しやトークンの削減は二次的です。

書き込みには合成フィクスチャを使用します。プライベートレシートを保持し、サポートされているパスを通じてテストレコードを削除し、クリーンアップを確認します。クリーンなQAを主張する代わりに、具体的な残存レコードやアクセス制限を報告します。

分析を配線する場合や採用を解釈する場合は、測定を読んでください。発見、試行、個別の操作、検証済みの結果、自発的な使用を分けて保持します。Mudpieを使用する場合、ブラウザまたは公開されたツールを介してダッシュボードを検査します。データベースの直接読み取りは避けてください。

レビュー可能な結果で終了する

テストされたタスクが現在何をできるようになったかを先頭に記載します。実装/リリースリファレンス、ランタイムバージョン、検証済み状態遷移、テスト数と分母、クリーンアップ結果、および未検証のレイヤーを含めます。トレースをダンプするのではなく、証拠にリンクします。

ローカルデモから本番運用実績と呼んだり、所有者のテストを有機的な採用と呼んだり、WebMCPが既にページ上のエージェントを支援するだけなのに新しい訪問者をもたらすと主張したりしないでください。リポジトリの承認されたレビューとデプロイメントワークフローに従ってください。スキルはそれ自体で外部への公開や本番環境の変更を許可しません。

関連スキル