# Kiro

配置带有 memory:read 和 knowledge:read 权限范围的 Kiro OAuth MCP 客户端。

- Canonical: https://docs.xmemo.dev/zh/docs/mcp/kiro
- Locale: zh-CN
- Content-Locale: zh-CN
- Canonical-Content-Digest: 4490e36d835d142b56e1fc6dc21a68943c1cc15407e3df6dabc7c9aa237970e6
- Edition-Digest: 9d221e4fc1eb10207f24c746e6eb800397a4194d8b84ea8941e16e7c589a4f4d
- 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 下将 XMemo 服务块添加到 ~/.kiro/settings/mcp.json，或使用 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 安装: 克隆或安装 yonro/xmemo-kiro-power @ 2fcccbce60 (plugin.json)，包含托管 MCP 和显式 Knowledge REST 创作适配器。

```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 调用应为只读。这是实际的 recall 调用，而不是健康检查占位符，并且不会写入记忆。

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

## 预期响应（字面结构）

成功调用返回以下公开排序文本结构；reference 和 content 是来自已授权记忆空间的真实值。

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