# Kiro

Configure o cliente MCP OAuth do Kiro com os escopos memory:read e knowledge:read.

- Canonical: https://docs.xmemo.dev/pt-br/docs/mcp/kiro
- Locale: pt-BR
- Content-Locale: pt-BR
- Canonical-Content-Digest: 4490e36d835d142b56e1fc6dc21a68943c1cc15407e3df6dabc7c9aa237970e6
- Edition-Digest: aec6800149fa3b4b2fbbc8358671afab7b8ef38c906b3a56ecda35f4768b2f1c
- Source-Revision: sha256:4cd528a003a4ee8764b960f58472f1ca85d93e56125d0b16a950f442dbc73e30

## 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.

```bash
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.

```bash
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.

```json
{
  "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.

```text
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.

```text
### 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.

## Kiro

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