VerbindenVerbindenKiro

MCP Client

Kiro

Konfigurieren Sie den Kiro OAuth-MCP-Client mit den Scopes memory:read und knowledge:read.

Voraussetzung

Verwenden Sie Kiro mit MCP-Einstellungsunterstützung oder Kiro Power. Kiro verbindet sich als OAuth-Client und fordert die Scopes memory:read und knowledge:read an.

  • Endpunkt: https://xmemo.dev/mcp.
  • Authentifizierungsmodus: OAuth-Client mit den Scopes memory:read und knowledge:read.
  • Konfigurationsdatei: ~/.kiro/settings/mcp.json.
  • Kiro Power-Repository: yonro/xmemo-kiro-power @ 2fcccbce60 (plugin.json) stellt den gehosteten MCP- und Knowledge-Authoring-Adapter bereit.
  • Bereitschaftsstatus: Belege erforderlich (geplanter Marktplatz, nicht zertifiziert). Ein benutzerdefinierter Kiro-Power-Pfad auf GitHub stellt keine offizielle Katalogfreigabe dar.

Installation / Einrichtung

Fügen Sie den XMemo-Serverblock zu ~/.kiro/settings/mcp.json unter mcpServers hinzu oder installieren Sie ihn automatisch mit dem XMemo-Client-Befehl. Alternativ installieren Sie die benutzerdefinierte Kiro Power aus yonro/xmemo-kiro-power @ 2fcccbce60.

  • OAuth-Client: Konfigurieren Sie in ~/.kiro/settings/mcp.json.
  • Unterstützt OAuth mit den Scopes memory:read und knowledge:read.
  • Führen Sie npx @xmemo/client mcp add kiro aus, um die Installation automatisch durchzuführen.
  • Kiro Power-Installation: Klonen oder installieren Sie yonro/xmemo-kiro-power @ 2fcccbce60 (plugin.json) mit gehostetem MCP und explizitem Knowledge-REST-Authoring-Adapter.
npx @xmemo/client mcp add kiro

Anmeldedaten festlegen

OAuth-Pfad: Kein statischer Schlüssel in den Einstellungen. Schließen Sie die OAuth-Zustimmung im Browser ab, wenn Kiro Zugriff auf die Scopes memory:read und knowledge:read anfordert.

XMEMO_AGENT_INSTANCE_ID generieren / bestätigen

Generieren Sie eine stabile, nicht geheime Instanzkennung pro lokaler Kiro-Installation, damit die Zuordnung über Sitzungen hinweg konsistent bleibt.

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

Bestehenden Konfigurationsblock beibehalten

Verwenden Sie den auf dieser Seite gerenderten bestehenden Kiro-Konfigurationsblock. Er behält die OAuth-Scopes bei und entspricht der autoritativen Konfiguration, die von @xmemo/client installiert wird.

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

Client neu starten

Starten Sie Kiro nach der Aktualisierung von ~/.kiro/settings/mcp.json oder der Installation von Kiro Power neu, damit beim ersten Aufruf der OAuth-Handshake initiiert wird.

Mit einem echten recall-Aufruf testen

Führen Sie den ersten MCP-Aufruf rein lesend aus. Dies ist ein tatsächlicher recall-Aufruf, kein Platzhalter für eine Statusprüfung, und er schreibt keine Daten in den Speicher.

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

Erwartete Antwort (wörtliche Struktur)

Ein erfolgreicher Aufruf gibt die unten dargestellte öffentliche strukturierte Textform zurück; Referenz und Inhalt sind echte Werte aus dem autorisierten Speicherbereich.

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

Häufige Fehler

Kiro verbindet sich über OAuth; häufige Fehler beziehen sich auf Autorisierungsgewährung oder Scope-Genehmigung.

  • invalid_grant — Der OAuth-Autorisierungscode ist ungültig, abgelaufen oder wurde bereits verwendet: Verbinden Sie Kiro erneut und autorisieren Sie neu.
  • 403 insufficient_scope — Die genehmigten Scopes enthalten nicht memory:read: Stellen Sie sicher, dass memory:read und knowledge:read genehmigt sind.
  • Ungültige XMEMO_AGENT_INSTANCE_ID-Werte werden normalisiert, sodass keine Instanzzuordnung erfolgt, anstatt einen Authentifizierungsfehler auszulösen.

Zertifizierung und Bereitschaft

Zertifizierungsstatus: Belege erforderlich. Marktplatzstatus: Geplant. Integrationsnachweise sind erforderlich, bevor eine vollständige Zertifizierung erteilt wird.

  • Zertifizierungsstatus: Belege erforderlich.
  • Marktplatzstatus: Geplant.
  • Hinweis zur Bereitschaft: Siehe /product/docs#client-capability-matrix; dies entspricht der autoritativen Konfiguration, die von @xmemo/client installiert wird.
  • Kiro Power-Status: Der benutzerdefinierte Pfad von yonro/xmemo-kiro-power @ 2fcccbce60 stellt keine offizielle Freigabe im Kiro-Katalog dar.

MCP-Konfiguration für Kiro

Konfigurationsdatei: ~/.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"
        ]
      }
    }
  }
}

Client-Bereitschaft

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

Quelle: Client-Funktionsmatrix