# Kiro

memory:read 및 knowledge:read 범위를 사용하여 Kiro OAuth MCP 클라이언트를 구성합니다.

- Canonical: https://docs.xmemo.dev/ko/docs/mcp/kiro
- Locale: ko-KR
- Content-Locale: ko-KR
- Canonical-Content-Digest: 4490e36d835d142b56e1fc6dc21a68943c1cc15407e3df6dabc7c9aa237970e6
- Edition-Digest: 9188211446b6a94c4d3c5c88b2a24216bee53431b5779dfccee029203496b420
- 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 경로는 공식 카탈로그 승인이 아닙니다.

## 설치 / 설정

~/.kiro/settings/mcp.json의 mcpServers 아래에 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를 통해 연결됩니다. 일반적인 오류는 인증 부여(authorization grant) 또는 범위 승인과 관련이 있습니다.

- 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"
        ]
      }
    }
  }
}
```