Kiro

Prérequis

Utilisez Kiro avec sa prise en charge des paramètres MCP ou Kiro Power. Kiro se connecte en tant que client OAuth demandant les portées memory:read et knowledge:read.

• Endpoint : https://xmemo.dev/mcp.
• Mode d'authentification : client OAuth avec les portées memory:read et knowledge:read.
• Fichier de configuration : ~/.kiro/settings/mcp.json.
• Référentiel Kiro Power : yonro/xmemo-kiro-power @ 2fcccbce60 (plugin.json) fournit l'adaptateur de création Knowledge et MCP hébergé.
• État de préparation : Preuves requises (marketplace planifiée, non certifiée). Une solution personnalisée Kiro Power sur GitHub ne constitue pas une approbation au catalogue officiel.

Installation / configuration

Ajoutez le bloc serveur XMemo dans ~/.kiro/settings/mcp.json sous mcpServers, ou installez-le automatiquement via la commande client XMemo. Vous pouvez également installer la Kiro Power personnalisée depuis yonro/xmemo-kiro-power @ 2fcccbce60.

• Client OAuth : configurez dans ~/.kiro/settings/mcp.json.
• Prend en charge OAuth avec les portées memory:read et knowledge:read.
• Exécutez npx @xmemo/client mcp add kiro pour l'installer automatiquement.
• Installation de Kiro Power : clonez ou installez yonro/xmemo-kiro-power @ 2fcccbce60 (plugin.json) avec MCP hébergé et adaptateur explicite de création REST Knowledge.

npx @xmemo/client mcp add kiro

Définir l'identifiant

Parcours OAuth : aucune clé statique dans les paramètres. Complétez le consentement OAuth dans le navigateur lorsque Kiro sollicite l'accès pour les portées memory:read et knowledge:read.

Générer / confirmer XMEMO_AGENT_INSTANCE_ID

Générez un identifiant d'instance stable et non secret par installation locale de Kiro pour préserver la cohérence de l'attribution entre les sessions.

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

Conserver le bloc de configuration existant

Utilisez le bloc de configuration Kiro existant affiché sur cette page. Il préserve les portées OAuth et correspond à la configuration faisant autorité installée par @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"
        ]
      }
    }
  }
}

Redémarrer le client

Redémarrez Kiro après avoir mis à jour ~/.kiro/settings/mcp.json ou installé Kiro Power afin d'initialiser l'établissement de liaison OAuth dès la première requête.

Tester avec un appel de rappel (recall) réel

Effectuez le premier appel MCP en lecture seule. Il s'agit d'une véritable invocation de recall, et non d'un indicateur de contrôle d'état, et elle n'écrit aucune mémoire.

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

Réponse attendue (format littéral)

Un appel réussi renvoie le format de texte classé public ci-dessous ; la référence et le contenu sont des valeurs réelles issues de l'espace de mémoire autorisé.

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

Erreurs fréquentes

Kiro se connecte via OAuth ; les erreurs courantes concernent l'octroi d'autorisation ou l'approbation de portées.

• invalid_grant — Le code d'autorisation OAuth est invalide, expiré ou a déjà été utilisé : reconnectez Kiro et autorisez à nouveau.
• 403 insufficient_scope — Les portées approuvées n'incluent pas memory:read : assurez-vous que memory:read et knowledge:read soient approuvées.
• Les valeurs invalides de XMEMO_AGENT_INSTANCE_ID sont normalisées en l'absence d'attribution d'instance plutôt que de lever une erreur d'authentification.

Certification et état de préparation

État de certification : Preuves requises. État sur la marketplace : Planifié. Des preuves d'intégration sont nécessaires avant qu'une certification complète ne soit octroyée.

• État de certification : Preuves requises.
• État sur la marketplace : Planifié.
• Remarque sur la préparation : Voir /product/docs#client-capability-matrix ; correspond à la configuration faisant autorité installée par @xmemo/client.
• État de Kiro Power : la solution personnalisée yonro/xmemo-kiro-power @ 2fcccbce60 ne constitue pas une approbation officielle au catalogue Kiro.