Kiro

사전 요구 사항

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)을 복제하거나 설치합니다.

npx @xmemo/client mcp add kiro

자격 증명 설정

OAuth 경로: 설정에 정적 키가 없습니다. Kiro가 memory:read 및 knowledge:read 범위에 대한 액세스를 요청할 때 브라우저 OAuth 동의를 완료합니다.

XMEMO_AGENT_INSTANCE_ID 생성 / 확인

로컬 Kiro 설치당 안정적인 비기밀 인스턴스 식별자를 생성하여 세션 전반에 걸쳐 귀속이 일관되게 유지되도록 합니다.

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

기존 구성 블록 유지

이 페이지에 렌더링된 기존 Kiro 구성 블록을 사용합니다. OAuth 범위를 보존하며 @xmemo/client에서 설치한 신뢰할 수 있는 구성과 일치합니다.

{
  "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 호출은 읽기 전용으로 수행합니다. 이것은 헬스체크 플레이스홀더가 아닌 실제 회상 호출이며 메모리를 작성하지 않습니다.

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

예상 응답 (리터럴 형태)

성공적인 호출은 아래의 공개 순위 지정 텍스트 형태를 반환합니다. 참조 및 콘텐츠는 승인된 메모리 공간의 실제 값입니다.

### 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 카탈로그 승인을 구성하지 않습니다.