HypAware

HypAware プラグイン

Claude Code、Cursor、またはスキルを読み込める任意のエージェントを、ホスト型の HypAware MCP サーバーに接続します。エージェントからチームの AI コーディング履歴を照会し、HypAware の推奨事項に基づいて動作できるようになります。

このプラグインには、次の 2 つが含まれています。

• https://api.hypaware.ai/v1/mcp に接続する MCP 接続。Authorization ヘッダーにエージェントトークンを付けて送信します。
• 2 つのスキル： hypaware-query（履歴を照会して推奨事項に基づいて動作する方法）と hypaware-reference（HypAware の概要とデータの流れ）。これらは、このプラグインが固定されている HypAware リリースに含まれるスキルのコピーです。

このプラグインは読み取りと操作のみを行います。フック、コマンド、エージェント、バイナリは含まず、何も記録せず、マシン上で何も実行しません。記録は hyp CLI と hyp attach が担当します。

トークンを取得する

このプラグインは HYPAWARE_AGENT_TOKEN 環境変数からトークンを読み込みます。まだ発行したことがない場合は、次の手順を実行してください。

1. CLI をインストールします：npm install -g hypaware。
2. 照会のみを行うサインインをします：hyp remote login --no-forward。ブラウザーでサインイン画面が開き、記録は有効になりません。
3. トークンを発行します：hyp remote mint --scope query --label <where-it-runs>。現在はサーバーのデフォルトである 21 日間有効です。より長い有効期間が必要な場合は、サーバーの上限（デフォルトでは 90 日）まで --expires-days <n> で指定できます。
4. シェルのプロファイルで export HYPAWARE_AGENT_TOKEN=<token> と設定するか、クライアント独自のシークレットストアに保存するなど、クライアントの起動時に使われる環境に設定します。コミットするファイルには絶対に記載しないでください。
5. 使用をやめるときは、トークンを取り消します。hyp remote tokens でトークンを一覧表示し、hyp remote tokens revoke <jti> で取り消せます。

トークンでできること。 トークンは、有効期限が切れるか取り消されるまで、発行した本人として機能します。組織の記録済み履歴の読み取り、推奨事項のステータス変更、レポートの公開と削除ができます。設定の変更、セッションの記録やアップロード、組織の管理、トークンの追加発行はできません。トークンを持つ人は誰でも同じ操作を行えるため、秘密にしてください。

インストール

Claude Code

Claude Code で次を実行します。

/plugin marketplace add hyparam/hypaware-plugin
/plugin install hypaware@hypaware

または、シェルから次を実行します。

claude plugin marketplace add hyparam/hypaware-plugin
claude plugin install hypaware@hypaware

HYPAWARE_AGENT_TOKEN を設定したシェルから Claude Code を起動します。claude mcp list で hypaware サーバーが HTTP 401 の「Failed to connect」と表示される場合は、トークンが設定されていないか、無効になっています。

Cursor、チームで使う場合

チーム管理者が Cursor ダッシュボードを開き、「Plugins & MCPs」、「Add Marketplace」、「Import from Repo」の順に選択して、hyparam/hypaware-plugin を入力します。次に、管理者が「Plugins」、「Configure」で HYPAWARE_AGENT_TOKEN を設定します。Cursor でプラグイン変数を設定できるのはチーム管理者のみです。

Cursor、個人で使う場合

Cursor には個人向けのプラグインインストール機能がないため、次の 2 つの手順で設定します。

1. MCP ガイドの Cursor セクションにあるリモート hypaware ブロックを ~/.cursor/mcp.json（またはプロジェクトの .cursor/mcp.json）に追加します。トークンは ${env:HYPAWARE_AGENT_TOKEN} として読み込まれるため、Cursor の起動前にトークンを環境変数として設定してください。
2. スキルを追加します：npx skills add hyparam/hypaware-plugin -a cursor。

その他のエージェント

skills CLI が認識する任意のエージェント（Pi、Codex、OpenCode など）では、次を実行します。

npx skills add hyparam/hypaware-plugin

この手順でインストールされるのは 2 つのスキルのみです。クライアントに応じた MCP ガイドに従って、MCP サーバーに接続してください。

すでに hyp attach を実行している場合

hyp attach でも同じスキルがインストールされます。この場合、このプラグインが必要なのは MCP 接続のためだけです。Claude Code では両方のコピーが並行して読み込まれます（プラグイン側は hypaware:hypaware-query などの名前です）。そのため、何かが上書きされることはありません。

MCP レジストリのエントリー

registry/server.json には、サーバーの実行方法が 2 つ記載されています。

• リモートはホスト型サーバーです。エージェントトークンを持っている場合に選択してください。
• npm パッケージは、自分のローカル HypAware データに対して hyp mcp serve を実行します。マシン上で HypAware コレクターを実行している場合に選択してください。コレクターがなければ、表示できるデータはありません。

スキルの更新

skills/ 配下のファイルは手作業で編集しないでください。 hypaware でスキルを変更してリリースした後、ここで node scripts/sync-skills.js <version> を実行し、結果をコミットしてください。 skills/ の内容がそのリリースと異なる場合、またはいずれかのバージョン項目が一致しない場合、CI は失敗します。

ライセンス

MIT です。LICENSE を参照してください。