# Kiro

memory:read および knowledge:read スコープを使用して Kiro OAuth MCP クライアントを構成します。

- Canonical: https://docs.xmemo.dev/ja/docs/mcp/kiro
- Locale: ja-JP
- Content-Locale: ja-JP
- Canonical-Content-Digest: 4490e36d835d142b56e1fc6dc21a68943c1cc15407e3df6dabc7c9aa237970e6
- Edition-Digest: 7ae59341a709f75dd964497caf8fc911c8063a5c14c8db691ff0e380328994ed
- Source-Revision: sha256:4cd528a003a4ee8764b960f58472f1ca85d93e56125d0b16a950f442dbc73e30

## 前提条件

MCP 設定サポートまたは Kiro Power を備えた Kiro を使用します。Kiro は memory:read および knowledge:read スコープを要求する OAuth クライアントとして接続します。

- Endpoint: https://xmemo.dev/mcp。
- Auth mode: memory:read および knowledge:read スコープを持つ OAuth クライアント。
- Config file: ~/.kiro/settings/mcp.json。
- Kiro Power リポジトリ: yonro/xmemo-kiro-power @ 2fcccbce60 (plugin.json) はホストされた MCP および Knowledge オーサリングアダプターを提供します。
- 準備状況ステータス: 証拠が必要（マーケットプレイス計画中、未認定）。GitHub のカスタム Power パスは公式カタログの承認ではありません。

## インストール / セットアップ

mcpServers の下の ~/.kiro/settings/mcp.json に XMemo サーバーブロックを追加するか、XMemo クライアントコマンドを使用して自動的にインストールします。または、yonro/xmemo-kiro-power @ 2fcccbce60 からカスタム Kiro Power をインストールします。

- OAuth クライアント: ~/.kiro/settings/mcp.json で構成します。
- memory:read および knowledge:read スコープを持つ OAuth をサポートします。
- npx @xmemo/client mcp add kiro を実行して自動的にインストールします。
- Kiro Power インストール: ホストされた MCP および明示的な Knowledge REST オーサリングアダプターを備えた yonro/xmemo-kiro-power @ 2fcccbce60 (plugin.json) をクローンまたはインストールします。

```bash
npx @xmemo/client mcp add kiro
```

## 認証情報を設定する

OAuth パス: 設定に静的キーはありません。Kiro が memory:read および knowledge:read スコープのアクセスを要求したときに、ブラウザでの OAuth 同意を完了します。

## XMEMO_AGENT_INSTANCE_ID を生成 / 確認する

ローカルの Kiro インストールごとに安定した非シークレットのインスタンス識別子を生成し、セッション間で帰属が一貫して保たれるようにします。

```bash
export XMEMO_AGENT_INSTANCE_ID='<stable-local-kiro-instance-id>'
# Persist and reuse this value for the same local install
```

## 既存の構成ブロックを保持する

このページに表示された既存の Kiro 構成ブロックを使用します。OAuth スコープを保持し、@xmemo/client によってインストールされる正式な構成と一致します。

```json
{
  "mcpServers": {
    "XMemo": {
      "url": "https://xmemo.dev/mcp",
      "headers": {
        "X-Memory-OS-Agent-ID": "kiro",
        "X-Memory-OS-Agent-Instance-ID": "${XMEMO_AGENT_INSTANCE_ID}"
      },
      "oauth": {
        "oauthScopes": [
          "memory:read",
          "knowledge:read"
        ]
      }
    }
  }
}
```

## クライアントを再起動する

~/.kiro/settings/mcp.json を更新するか Kiro Power をインストールした後に Kiro を再起動して、最初のリクエストで OAuth ハンドシェイクを開始できるようにします。

## 実際の recall 呼び出しでテストする

最初の MCP 呼び出しは読み取り専用にします。これはヘルスチェック用のプレースホルダーではなく実際のリコール呼び出しであり、メモリへの書き込みは行いません。

```text
recall({ query: "connection check", limit: 1 })
```

## 期待される応答（リテラル形式）

成功した呼び出しは、以下の公開されたランク付けされたテキスト形式を返します。参照とコンテンツは、承認されたメモリ空間からの実際の値です。

```text
### XMemo Memory Results:
1. Reference: <opaque-memory-id> | Location: <location>
   > <memory content>
```

## よくあるエラー

Kiro は OAuth 経由で接続します。一般的なエラーは認可グラントまたはスコープの承認に関連しています。

- invalid_grant — OAuth 認可コードが無効、期限切れ、または既に使用されています: Kiro を再接続して再認可してください。
- 403 insufficient_scope — 承認されたスコープに memory:read が含まれていません: memory:read および knowledge:read が承認されていることを確認してください。
- 無効な XMEMO_AGENT_INSTANCE_ID 値は、認証エラーを発生させるのではなくインスタンス帰属なしとして正規化されます。

## 認定と準備状況

認定ステータス: 証拠が必要。マーケットプレイスステータス: 計画中。完全な認定が付与される前に統合の証拠が必要です。

- 認定ステータス: 証拠が必要。
- マーケットプレイスステータス: 計画中。
- 準備状況に関する注意: /product/docs#client-capability-matrix を参照してください。これは @xmemo/client によってインストールされる正式な構成と一致します。
- Kiro Power ステータス: yonro/xmemo-kiro-power @ 2fcccbce60 のカスタム Power パスは公式の Kiro カタログ承認を構成するものではありません。

## Kiro

OAuth client: configure in ~/.kiro/settings/mcp.json. Supports OAuth with memory:read and knowledge:read scopes. Run npx @xmemo/client mcp add kiro to install automatically.

```
{
  "mcpServers": {
    "XMemo": {
      "url": "https://xmemo.dev/mcp",
      "headers": {
        "X-Memory-OS-Agent-ID": "kiro",
        "X-Memory-OS-Agent-Instance-ID": "${XMEMO_AGENT_INSTANCE_ID}"
      },
      "oauth": {
        "oauthScopes": [
          "memory:read",
          "knowledge:read"
        ]
      }
    }
  }
}
```