ConectarConectarKiro

MCP Client

Kiro

Configure el cliente MCP OAuth de Kiro con los ámbitos memory:read y knowledge:read.

Requisito previo

Use Kiro con soporte de configuración MCP o Kiro Power. Kiro se conecta como un cliente OAuth solicitando los ámbitos memory:read y knowledge:read.

  • Endpoint: https://xmemo.dev/mcp.
  • Modo de autenticación: Cliente OAuth con los ámbitos memory:read y knowledge:read.
  • Archivo de configuración: ~/.kiro/settings/mcp.json.
  • Repositorio de Kiro Power: yonro/xmemo-kiro-power @ 2fcccbce60 (plugin.json) proporciona el adaptador de autoría de Knowledge y MCP alojado.
  • Estado de preparación: Pruebas requeridas (mercado planificado, no certificado). Una ruta personalizada de GitHub Power no constituye aprobación en el catálogo oficial.

Instalación / configuración

Añada el bloque del servidor XMemo a ~/.kiro/settings/mcp.json en mcpServers, o instálelo automáticamente mediante el comando de cliente de XMemo. De forma alternativa, instale la Kiro Power personalizada desde yonro/xmemo-kiro-power @ 2fcccbce60.

  • Cliente OAuth: configure en ~/.kiro/settings/mcp.json.
  • Admite OAuth con los ámbitos memory:read y knowledge:read.
  • Ejecute npx @xmemo/client mcp add kiro para instalar automáticamente.
  • Instalación de Kiro Power: clone o instale yonro/xmemo-kiro-power @ 2fcccbce60 (plugin.json) con MCP alojado y adaptador explícito de autoría REST de Knowledge.
npx @xmemo/client mcp add kiro

Configurar la credencial

Ruta OAuth: sin clave estática en la configuración. Complete el consentimiento OAuth en el navegador cuando Kiro solicite acceso para los ámbitos memory:read y knowledge:read.

Generar / confirmar XMEMO_AGENT_INSTANCE_ID

Genere un identificador de instancia no secreto y estable por instalación local de Kiro para que la atribución se mantenga coherente entre sesiones.

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

Conserve el bloque de configuración existente

Use el bloque de configuración existente de Kiro que aparece en esta página. Conserva los ámbitos de OAuth y coincide con la configuración autoritativa instalada por @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"
        ]
      }
    }
  }
}

Reiniciar el cliente

Reinicie Kiro tras actualizar ~/.kiro/settings/mcp.json o instalar Kiro Power para que inicie el protocolo de enlace OAuth en la primera solicitud.

Probar con una llamada real a recall

Haga que la primera llamada MCP sea de sólo lectura. Es una invocación real de recall, no un marcador de verificación de estado, y no escribe en la memoria.

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

Respuesta esperada (forma literal)

Una llamada correcta devuelve la forma pública de texto clasificado que aparece abajo; la referencia y el contenido son valores reales del espacio de memoria autorizado.

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

Errores comunes

Kiro se conecta mediante OAuth; los errores comunes están relacionados con la concesión de autorización o la aprobación de ámbitos.

  • invalid_grant — el código de autorización de OAuth no es válido, ha caducado o ya se utilizó: vuelva a conectar Kiro y autorice de nuevo.
  • 403 insufficient_scope — los ámbitos aprobados no incluyen memory:read: asegúrese de que memory:read y knowledge:read estén aprobados.
  • Los valores no válidos de XMEMO_AGENT_INSTANCE_ID se normalizan para no atribuir ninguna instancia en lugar de generar un error de autenticación.

Certificación y estado de preparación

Estado de certificación: Pruebas requeridas. Estado en el mercado: Planificado. Se requieren pruebas de integración antes de otorgar la certificación completa.

  • Estado de certificación: Pruebas requeridas.
  • Estado en el mercado: Planificado.
  • Nota de preparación: Consulte /product/docs#client-capability-matrix; coincide con la configuración autoritativa instalada por @xmemo/client.
  • Estado de Kiro Power: la ruta de Power personalizada yonro/xmemo-kiro-power @ 2fcccbce60 no constituye aprobación oficial en el catálogo de Kiro.

Configuración MCP de Kiro

Archivo de configuración: ~/.kiro/settings/mcp.json

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

Disponibilidad del cliente

  • Evidence required
  • Planned
  • See /product/docs#client-capability-matrix; this matches the authoritative config installed by @xmemo/client.

Fuente: Matriz de capacidades del cliente