Keyless AIをインストール
OSごとに正規ルートは1つです。MacとWindowsの手順を混ぜず、そのまま進めてください。
通常のKeylessAIプラグイン + このページ
発行済みAPI keyを下の公式入力欄へ1回入力し、短期コマンドを実行します。
Windows用bridge plugin + このページでInstall ZIP
Windows用のKeylessAI bridge pluginをCoworkへ1つ追加し、発行済みAPI keyから本人専用ZIPを生成してSTART-HEREを実行します。
使うアプリ
Cowork / Claude は、下のOS別の手順どおりpluginを1つ追加してからコマンドを実行します。
macOS
- 通常のKeylessAIプラグインを追加
KeylessAI plugin v0.6.82をCoworkへ1つだけ追加します。 - pluginの追加は不要
選んだアプリ の設定への登録は、この後のコマンドが行います。選んだアプリ の設定にAPI keyは書きません。 - 発行されたKeyless API keyをここに入れて、Mac用コマンドをコピー
下の入力欄だけを使います。入力したkeyはコピーするコマンドには含まれません。 - Terminalで実行
コピーしたコマンドをTerminalへ貼り付けます。セットアップから起動中のアプリへ終了シグナルは送りません。古いKeyless登録の整理が必要と表示された場合だけ、60分以内にアプリを通常終了し、閉じたまま待ちます。1回限りの整理が安全に完了すると、同じ署名済みアプリを開き直します。古い登録がなければアプリ操作は不要です。 - 新しいセッションで確認
keyless_call、keyless_diagnose、keyless_statusが見えれば完了です。
kl_live_ または kl_test_ から始まる、発行時に表示された完全なキーを貼り付けます。
入力値は短期トークンを発行する時だけ公式KeylessサーバーへHTTPSで送り、有効性を確認します。ブラウザには保存せず、コピーするコマンドにもAPI keyを含めません。約5分で失効する短期セットアップトークンだけを使います。
~/.keyless-ai/keyless-api-key に統一します。追加のMac用pluginや別の導入ツールはありません。
Windows
- Windows用のKeylessAI bridge pluginを追加
KeylessAI Windows bridge plugin v0.6.82をCoworkへ1つだけ追加します。このpluginにMCPサーバーの設定は入っていません。skillとセッション開始時の案内を届けるためのもので、これを入れないとWindowsではskillが見えません。 - pluginの追加は不要
選んだアプリ の設定への登録は、Install ZIPのSTART-HEREが行います。選んだアプリ の設定にAPI keyは書きません。 - 発行済みAPI keyを下へ入力してInstall ZIPを保存
Dashboardへ戻らず、このページで本人専用のWindows Install ZIPを生成できます。 - ZIPを本人のPCで展開
他の利用者・案件へ使い回しません。 - START-HEREを実行
START-HERE-WINDOWS.cmdを実行します。keyの保存とMCPブリッジの登録は、このSTART-HEREが行います。Windows用bridge v0.6.82本体のダウンロードと検証もここで行われます。コマンドを手で組み替えたりしません。遅延更新が必要と表示された場合だけ、アプリを通常終了して閉じたまま待ち、1回限りの更新後に開き直されたアプリで新しいセッションを始めます。 - 新しいセッションで確認
keyless_call、keyless_diagnose、keyless_statusが見えれば接続は完了です。keyless_statusのaliases.namesに使えるaliasが並び、skill_accessに契約状態が出ます。
macOSと同じく、Windowsもpluginは手で1つ追加します。pluginはskillと案内を届ける役で、MCPブリッジの登録とkeyの保存はInstall ZIPのSTART-HEREが行います。pluginだけ入れてもSTART-HEREを実行しないとKeylessには繋がりません。
kl_live_ または kl_test_ から始まる、発行時に表示された完全なキーを貼り付けます。
入力値は短期トークンを発行する時だけ公式KeylessサーバーへHTTPSで送り、ブラウザには保存しません。ZIPにAPI keyは含まれず、約5分で失効する短期セットアップトークンだけが入ります。保存後は5分以内に展開して実行してください。
完了条件
セットアップの接続登録済み表示だけではなく、必要と表示された整理を終えた後の新しいセッションで3つのKeyless toolsが見え、keyless_statusが応答することを確認します。古い登録がなく整理不要なら、アプリの終了・再開は不要です。
接続できない場合
Mac
セットアップ自体が完了していない場合だけ、通常pluginがv0.6.82であることを確認し、最初に発行された同じAPI keyを上の入力欄へ入れ、新しい短期コマンドを一度だけ実行します。接続登録済みで古い登録の整理待ちなら再実行せず、60分以内にアプリを通常終了して閉じたまま待ちます。整理不要ならアプリ操作は不要です。
Windows
セットアップ自体が完了していない場合だけ、発行済みの同じAPI keyを上の入力欄へ入れて現在のInstall ZIPを新しく生成し、展開したZIPのSTART-HEREを一度だけ実行します。接続登録済みで遅延更新待ちなら再実行せず、アプリを通常終了して閉じたまま待ち、更新後に開き直されたアプリで新しいセッションを始めます。
WindowsでSeSecurityPrivilegeと表示される
古いInstall ZIPが監査ACLまで書き戻した時のエラーです。管理者として実行したりWindowsの権限を変更したりせず、上の入力欄で新しいInstall ZIPを生成し直して、展開したフォルダのSTART-HEREを一度だけ実行します。現行版は古い監査ACLを持ち回らず、通常ユーザー権限で本人所有・本人専用のアクセス権を新規作成します。