Kiro

Pré-requisito

Use o Kiro com suporte a configurações MCP ou Kiro Power. O Kiro conecta-se como um cliente OAuth solicitando os escopos memory:read e knowledge:read.

• Endpoint: https://xmemo.dev/mcp.
• Modo de autenticação: Cliente OAuth com os escopos memory:read e knowledge:read.
• Arquivo de configuração: ~/.kiro/settings/mcp.json.
• Repositório do Kiro Power: yonro/xmemo-kiro-power @ 2fcccbce60 (plugin.json) fornece o adaptador de autoria de Knowledge e MCP hospedado.
• Status de prontidão: Evidências necessárias (marketplace planejado, não certificado). Um caminho personalizado de Power no GitHub não constitui aprovação no catálogo oficial.

Instalação / configuração

Adicione o bloco do servidor XMemo a ~/.kiro/settings/mcp.json em mcpServers ou instale automaticamente usando o comando do cliente XMemo. Alternativamente, instale o Kiro Power personalizado de yonro/xmemo-kiro-power @ 2fcccbce60.

• Cliente OAuth: configure em ~/.kiro/settings/mcp.json.
• Suporta OAuth com os escopos memory:read e knowledge:read.
• Execute npx @xmemo/client mcp add kiro para instalar automaticamente.
• Instalação do Kiro Power: clone ou instale yonro/xmemo-kiro-power @ 2fcccbce60 (plugin.json) com MCP hospedado e adaptador explícito de autoria REST de Knowledge.

npx @xmemo/client mcp add kiro

Definir a credencial

Caminho OAuth: sem chave estática nas configurações. Conclua o consentimento OAuth no navegador quando o Kiro solicitar acesso para os escopos memory:read e knowledge:read.

Gerar / confirmar XMEMO_AGENT_INSTANCE_ID

Gere um identificador de instância estável e não secreto por instalação local do Kiro para que a atribuição permaneça consistente entre as sessões.

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

Preservar o bloco de configuração existente

Use o bloco de configuração existente do Kiro renderizado nesta página. Ele preserva os escopos OAuth e corresponde à configuração 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 o cliente

Reinicie o Kiro após atualizar ~/.kiro/settings/mcp.json ou instalar o Kiro Power para que ele inicie o handshake OAuth na primeira solicitação.

Testar com uma chamada real de recall

Faça a primeira chamada MCP somente para leitura. Esta é uma invocação real de recall, não um placeholder de verificação de integridade, e não grava memória.

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

Resposta esperada (formato literal)

Uma chamada bem-sucedida retorna o formato de texto ranqueado público abaixo; a referência e o conteúdo são valores reais do espaço de memória autorizado.

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

Erros comuns

O Kiro conecta-se por meio de OAuth; erros comuns relacionam-se à concessão de autorização ou à aprovação de escopo.

• invalid_grant — o código de autorização OAuth é inválido, expirou ou já foi utilizado: reconecte o Kiro e autorize novamente.
• 403 insufficient_scope — os escopos aprovados não incluem memory:read: certifique-se de que memory:read e knowledge:read estejam aprovados.
• Valores inválidos de XMEMO_AGENT_INSTANCE_ID são normalizados para nenhuma atribuição de instância em vez de gerar um erro de autenticação.

Certificação e prontidão

Status de certificação: Evidências necessárias. Status no marketplace: Planejado. Evidências de integração são necessárias antes que a certificação completa seja concedida.

• Status de certificação: Evidências necessárias.
• Status no marketplace: Planejado.
• Nota de prontidão: Consulte /product/docs#client-capability-matrix; corresponde à configuração autoritativa instalada por @xmemo/client.
• Status do Kiro Power: o caminho personalizado yonro/xmemo-kiro-power @ 2fcccbce60 não constitui aprovação oficial no catálogo do Kiro.