Kiro Web にローカルの .kiro 設定をアップロードしてみた

Kiro Web にローカルの .kiro 設定をアップロードしてみた

ローカルの Kiro グローバル設定をクラウドセッションに反映できる
2026.09.26

いわさです。

9月上旬に Kiro Web が GA になっています。

https://kiro.dev/changelog/web/kiro-web-is-now-generally-available/

これまで何度か触ったことがあったのですが Kiro Web はクラウドのサンドボックスでセッションが動くもので、普段 Kiro CLI や Kiro IDE などローカル環境でカスタマイズが十分されていてそこでセッションを動かしていると、Kiro Web は別環境になるため同じ使用感で使うのが難しかったです。

そんな中、Kiro Web が GA する少し前に、ローカルの Kiro グローバル設定を Kiro Web に持ち込む機能が追加されていました。

https://kiro.dev/changelog/web/cloud-configuration/

上記アップデートは同期というよりは、ローカルの設定をクラウド側へ一方向でアップロードする機能です。
これとは別で、逆にクラウドの設定を新規のローカルセッションに読み込ませる方向の機能もあります。

これによってローカルのカスタマイズ環境をある程度 Kiro Web に適用できそうです。
今日はこのローカルからクラウドへのアップロード側を試してみたので紹介します。

アップロードしてみる

まず Kiro Web のグローバル設定ですが、アカウントメニューの Settings にある Steering / Skills / Agents / Hooks / Powers で管理することが出来ます。

50277B5E-495F-4274-B39B-9A7F86179463_1_105_c.jpeg

そしてそれらの上の「Sync」が今回使うローカルとクラウドの同期機能です。
こちらからアップロードできるインターフェースになってます。

1BDE3202-AFD7-4B17-8C46-B8D14B2A259A.png

上の「Apply your cloud configuration to local sessions」がクラウド→ローカルの読み込み、下の「Upload local configuration to the cloud」がローカル→クラウドのアップロードです。
今日使うのは下側です。

ローカル環境では~/.kiroフォルダにグローバル設定が保存されています。

312B6B69-BF95-436D-8FCD-146D59497A37.png

以下のドキュメントによると、この.kiroを同期できるっぽいので、まずはこのフォルダをまるっとアップロードしてみますか。

https://kiro.dev/docs/web/cloud-configuration/

07094EE1-AA34-4C39-B5F3-8FDFA3984EFC.png

アップロードしようとしたところ次のようにエラーメッセージが表示されました。
どうやら.kiroフォルダのアップロードはサポートされていないようです。

0A62EFAD-5E54-4272-8E67-74D1C37B449B.png

エラーメッセージによると.kiroフォルダの中の以下がサポートされているようです。なるほど。

19284A54-99F6-4F83-9844-0AEDFABC9723.png

まずはsteeringフォルダをアップロードしてみますか。
アップロード操作をしたところ、その中のどのステアリングファイルを取り込むか選択できるようになっていました。デフォルトは全部選択された状態です。

4B3A45E0-CD56-489A-B5C0-F50015F716AD_1_105_c.jpeg

これらのグローバルステアリングファイルはすべての作業横断で適用したいルールとか私の好みとかなんかその辺りが定義されてます。
あと私のローカル端末固有の制限とかもあってそれのワークアラウンドとかも定義されてたりします。詳しくは秘密なんですが。

Upload 8 filesボタンを押すとこれらの取り込みが開始され、すぐに処理が完了しました。

EE415683-17E3-4A42-A483-9916F7C8627E_1_105_c.jpeg

ステアリング画面を見てみると、取り込まれていることがわかります。これが Kiro Web でのグローバルステアリングってことですね。

57F73D2E-6563-48BD-92F9-4185DD2D6D3C.png

続いて他のフォルダもどんどん取り込んでいきましょう。
settingsフォルダってなんだっけと思っていたのですが、グローバル MCP 定義が含まれているフォルダでした。なるほどね。

789D4F08-9057-4740-8216-53A2F75B2B95.png

取り込もうとしたのですが最初いくつかの MCP 設定がエラーになりました。

5E5048BD-3EE5-45FA-A5A3-7013D298037A_1_105_c.jpeg

ただ、Retry failed ボタンを何度か推してると取り込めるようになりました。
これで良いのかよくわからないです。後述しますが、MCP はうまく動いてませんでした。

644740B2-D620-459F-8D55-3B6786695354.png

グローバル MCP 設定はプロファイルのサンドボックス設定から確認できあます。
Network configuration が Open internet とかの制限なしモードになっていると MCP が有効化されます。

DBA38045-2532-4BD2-9B06-4C89292A8FB0_1_105_c.jpeg

コマンドパスがめっちゃローカル端末のパスですね。これはこのままだと動かない気がしますね。まぁ今日はいいわ。

skillsもこんな感じで取り込みましょう。これもまぁ詳しくは秘密です。

706A7BED-D629-413B-A61B-FDB7DAA46A94.png

agentsがカスタムエージェントなのですが、これがちょっと苦労しました。
Kiro Crew を最近使ってるせいか、自動でエージェント関連のファイルがなんか自動で作成されているみたいで、これをポチポチと選択外すのが大変でした...フィルタリングしたり一括解除したりする機能があると良いなと思いました。

E5684C10-6600-40BD-8F38-74B2D54B434D_1_105_c.jpeg

医療ガイドライン周りのナレッジ検索エージェントとか作っていて、ローカル PDF を読み込む機能とかあったのですが、アップロードできるファイル制限が 4MB みたいで一部の PDF がアップロード出来ませんでした。
このあたりも分割するとか、ちょっと工夫が必要そうです。今回はこのまま無視して TOO LARGE なファイルは取り込まずにいきました。

2CE0F663-7AD2-4626-8A9B-71683B1B6ECF.png

アップロードされた環境を使ってみる

さて、グローバル設定が一通り取り込めたのでローカル環境と同じ使用感なのか確認してみます。
チャットで投げかけたところ早速 MCP 周りでエラーが発生しました。STDIO でも動くはずなのでシンプルに MCP 定義の問題ですね。ここは設定変更すれば治ると思います。

A23FCF9E-0A4A-45EE-8A6C-D20B5137A3E8.png

エージェントの回答を見ると、私の名前を認識してますね。
「俺はこういう人間だ」というのをグローバルステアリングファイルで定義しているので私の名前や所属や趣向などをエージェントが把握できている状態です。

8AB7CD2A-4A5B-450F-855A-74198E6CE6B5.png

また、独自のカスタムエージェントも認識されていますね。気になったのは、Kiro Web の場合は Kiro IDE や Kiro Crew などと違って、チャット欄で明示的にこのエージェントを使うよと指定が出来ないっぽいんですよね。
私は普段モデル指定する感覚でカスタムエージェント指定しているので、これはちょっとつらいかもしれないな。
普段の私のカスタムエージェントの使い方なのですが、タスクを分解してエージェントの役割に応じてオーケストレーションさせています。
ワーカーがオーケーストレーターエージェントにタスク計画を立ててもらって、それで専門エージェントに委譲しながらタスクを遂行する感じです。

まぁ...詳しくは秘密です。

さいごに

本日は Kiro Web にローカルの .kiro 設定をアップロードしてみました。

背景として、私は最近 Kiro を活用しているのですが、活用度合いが進んでくるとローカルコンテキスト・ローカルセッションだと色々なところでボトルネックを感じるようになってきました。
以下のブログでいう STAGE 1 と STAGE 2 あたりまではローカル環境で単独タスクあるいは複数タスクを並行処理で頑張るくらいでいけるのですが、STAGE 3 と STAGE 4 あたりになってくると自律性を高めるためにクラウドやパイプラインとの連携がどうしても必要になりそうで、ローカルだけだと限界を感じています。

https://kiro.dev/blog/software-factory-1000-prs/

Kiro Crew をリモート環境でホスティングしてクラウドセッション張る方法もまぁあるのですが、Kiro Web もクラウドセッションとして使えるので活用できるならしたいところなんですよね。
最終的にはパイプラインとなる基盤が必要で、GitHub リポジトリになるのかなぁという気はちょっとしているのですが、そのあたりも含めて Kiro Web 連携をもう少し試行錯誤してみたいなと最近思っています。

この記事をシェアする

AWSのお困り事はクラスメソッドへ

関連記事