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 路径不构成官方目录批准。

安装 / 设置

在 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 创作适配器。

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 调用，而不是健康检查占位符，并且不会写入记忆。

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

预期响应（字面结构）

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

### 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 目录批准。