# Conectar um agente de IA {/* #connect-an-ai-agent */}

Reconstruct expõe dados capturados por servidor MCP. Escolha seu agente para configurar:

- [Codex](/docs/pt/agents/codex)
- [Claude](/docs/pt/agents/claude)
- [Cursor](/docs/pt/agents/cursor)
- [Cline](/docs/pt/agents/cline)
- [GitHub Copilot no VS Code](/docs/pt/agents/vscode-copilot)
- [Gemini CLI](/docs/pt/agents/gemini-cli)
- [MiMo](/docs/pt/agents/mimo)
- [Muse Code](/docs/pt/agents/muse-code)
- [Grok Build](/docs/pt/agents/grok-build)
- [Hermes Agent](/docs/pt/agents/hermes)
- [OpenClaw](/docs/pt/agents/openclaw)
- [OpenMausBot](/docs/pt/agents/openmausbot)
- [Outros clientes MCP](/docs/pt/agents/other-mcp-clients)

## Antes de começar {/* #before-you-start */}

O endpoint Reconstruct MCP é **`https://reconstruct.dev/mcp`**, usando **Streamable HTTP**. Conecte com OAuth no navegador ou token pessoal.

| Método | Como funciona | Quando usar |
|---|---|---|
| **Login OAuth pelo navegador** | O cliente abre o login Reconstruct no navegador. Entre, aprove e volte ao cliente. Não precisa criar nem copiar token da plataforma. | Agentes interativos e editores com OAuth. |
| **Token de acesso pessoal** | Crie token MCP na plataforma e adicione às credenciais do cliente. | Clientes sem OAuth ou automação sem login pelo navegador. |

Ambos conectam ao mesmo MCP e usam a assinatura e a franquia da conta Reconstruct.

## Login OAuth pelo navegador {/* #oauth-browser-sign-in */}

Não é necessário emitir token pessoal antes de conectar por OAuth.

1. Adicione `https://reconstruct.dev/mcp` como servidor HTTP MCP remoto.
2. Escolha OAuth ou login no navegador. Se forem pedidos ajustes, use os valores abaixo.
3. Inicie **Sign in** (Entrar), **Connect** (Conectar) ou o comando de login MCP. A ação depende do cliente.
4. Entre com sua conta Reconstruct no navegador e aprove o acesso. Sem cadastro disponível, contate suporte para acesso à conta.
5. Volte e atualize as ferramentas. Peça uma chamada a `list_products` para confirmar.

| Ajuste | Valor |
|---|---|
| URL do servidor | `https://reconstruct.dev/mcp` |
| Transporte | Streamable HTTP |
| ID do cliente OAuth | `reconstruct-mcp` para clientes predefinidos; Claude Desktop registra automaticamente |
| Escopos | `openid aud-mcp` |
| Segredo de cliente | Deixar vazio |
| Emissor OAuth | `https://reconstruct.dev/sso/realms/reconstruct` |
| Endpoint de autorização | `https://reconstruct.dev/sso/realms/reconstruct/protocol/openid-connect/auth` |
| Endpoint de token | `https://reconstruct.dev/sso/realms/reconstruct/protocol/openid-connect/token` |

O cliente obtém e armazena credenciais OAuth após o login e as usa no MCP. Não precisa copiar token nem definir `CR_RECONSTRUCT_MCP_TOKEN`. Remova `Authorization` ou ajustes bearer manuais ao migrar conexão existente para OAuth.

Consulte OAuth para [Codex](/docs/pt/agents/codex#oauth-browser-sign-in), [Claude Code](/docs/pt/agents/claude-code#oauth-browser-sign-in), [Cursor](/docs/pt/agents/cursor#oauth-browser-sign-in), [Cline](/docs/pt/agents/cline#oauth-browser-sign-in), [OpenMausBot](/docs/pt/agents/openmausbot#oauth-browser-sign-in) ou [outro cliente](/docs/pt/agents/other-mcp-clients#oauth-browser-sign-in). Use o retorno documentado para o cliente. Se pedir novo login, repita seu fluxo MCP.

### Compatibilidade de clientes {/* #client-compatibility */}

Os exemplos de navegador cobrem Claude, Cursor, Claude Code, Codex, Grok Build e Muse Code com retornos registrados. Gemini CLI, VS Code, MiMo Code, MiMo Desktop, Hermes Agent e OpenClaw usam tokens; VS Code também oferece instalação com um clique e registro automático. Claude Desktop e web admitem registro automático com retorno HTTPS exato aprovado. Outros clientes com descoberta OAuth/DCR conectam só pela URL, registrando e tratando seu retorno HTTPS ou loopback exato. Ajustes de cliente público predefinidos continuam alternativa sem DCR.

Endpoints OAuth vêm da descoberta, sob o realm SSO, não `/authorize` ou `/token` na raiz. Se abrir endpoint raiz, recarregue a configuração e repita o login para atualizar a descoberta em cache.

Para nuvem Claude, siga o [guia Claude Desktop](/docs/pt/agents/claude-desktop). Antes de outra integração em nuvem, informe ao suporte o URI exato. Não insira segredo para `reconstruct-mcp`.

## Descoberta de agentes e login por dispositivo {/* #agent-discovery-and-device-sign-in */}

A descoberta pública começa em `https://reconstruct.dev/mcp/server-card`. `/.well-known/api-catalog` lista documentação pública e `/.well-known/agent-skills/index.json`, fluxos e arquivos instaláveis. Veja [Habilidades Reconstruct](/docs/pt/skills) para os nove fluxos, recursos MCP sem instalação, instalação web/GitHub CLI, downloads manuais e plugins de cliente. MCP remoto não exige .NET SDK no computador.

Páginas públicas e documentação aceitam `Accept: text/markdown`. Páginas do workspace ainda exigem acesso à conta.

Clientes com OAuth Device Authorization podem ler `https://reconstruct.dev/auth.md` e enviar POST `{"type":"anonymous"}` a `https://reconstruct.dev/agent/register`. A resposta contém autorização pendente, URL/código de verificação, validade, intervalo de consulta e PKCE `code_verifier` privado. Mostre as instruções ao usuário, que precisa entrar e aprovar. O agente consulta o endpoint de token do emissor usando device-code grant e o `code_verifier` retornado. Respeite intervalo e respostas `slow_down`. Registrar não emite token nem cria conta. Papéis, limites e consentimento existentes continuam válidos.

Mantenha códigos, verificadores e tokens privados. Nunca aprove pelo usuário. O fluxo serve aos clientes que o implementam; não substitui código de autorização + PKCE do editor.

## Token de acesso pessoal {/* #personal-access-token */}

1. Entre em [Reconstruct Platform](https://reconstruct.dev/platform/) e abra **Settings → API tokens** (Configurações → Tokens API).
2. Crie token com escopo **MCP** (`mcp`) e copie o segredo ao aparecer.
3. Configure `Authorization: Bearer <token>`. Se ler de variável, use `CR_RECONSTRUCT_MCP_TOKEN`.
4. Conecte e peça ao cliente para chamar `list_products`.

Guarde o token em segredo local/cofre do cliente. Se expirar ou for revogado, crie substituto na plataforma e atualize as credenciais.

## Selecionar dados capturados {/* #select-captured-data */}

Comece com `list_products`, `list_platforms` e `list_versions`. Escolha tipos/ambientes de `list_platforms.options.platforms[]` pelos IDs retornados. `list_platforms.platforms[]` contém pares com dados reais. Use a chave exata `view` de `list_pages.views[]` nas ferramentas de página. Passe `environment` explicitamente se houver vários. Ferramentas de contexto exigem franquia e consomem uma leitura ao aceitar a chamada, incluindo cache. Chamada aceita conta mesmo se falhar depois. Descoberta, imagens e downloads não consomem leituras. Veja [limites de uso](/docs/pt/mcp-tools#usage-limits).

## Solução de problemas {/* #troubleshooting */}

| Sintoma | Verificação |
|---|---|
| `401 Unauthorized` | Conclua OAuth ou confira token pessoal; substitua expirados/revogados. |
| `/authorize` retorna 404 | Atualize metadados e repita o login; autorização fica sob `https://reconstruct.dev/sso/realms/reconstruct`. |
| `invalid_scope` | Solicite `openid aud-mcp`; Grok Build pode pedir `offline_access` opcional. |
| Autenticação exigida após login | Atualize o servidor e repita OAuth. Remova credenciais bearer manuais conflitantes. |
| Redirecionamento OAuth incompatível | Use a porta documentada. Se persistir, informe ao suporte o URI exibido. |
| Registro dinâmico rejeitado | Escolha registro automático OAuth e tente após um minuto. O cliente exige retorno HTTPS ou loopback exato e PKCE S256. Sem autorregistro, use ajustes predefinidos do guia. |
| Servidor não conecta | Confirme acesso a `https://reconstruct.dev/mcp` pela máquina do agente. |
| Ferramentas negam acesso | Entre na conta Reconstruct e confira a assinatura. Contate suporte se continuar. |
| Cota ou uso indisponível | Confira uso nas configurações e a página de status. Tente quando disponível. |
| Vários ambientes capturados | Informe `environment` de `list_versions`. |
| Plataforma/vista indisponível | Use pares capturados e chaves exatas `list_pages.views[]`; opções suportadas não garantem armazenamento. |
| Nenhuma ferramenta aparece | Reinicie o agente ou atualize a lista MCP e confira o servidor. |

Após conectar, teste os [exemplos de prompts](/docs/pt/prompt-examples) ou veja o [catálogo MCP](/docs/pt/mcp-tools).

### Solicitar captura nova ou atualização {/* #request-a-new-capture-or-update */}

O servidor inclui `get_request_options`, `create_product_request`, `get_product_request`, `list_product_requests` e `wait_product_request`. Entre por OAuth ou token MCP. A assinatura precisa permitir solicitações e você só vê as enviadas pela conta. Peça ao agente para enviar URL nova ou atualizar chave publicada conhecida; ele deve reter `requestId` e esperar alterações na revisão. Aprovação não significa captura pronta. Consulte parâmetros nas [ferramentas de solicitação](/docs/pt/mcp-tools#product-requests).