Conectar um agente de IA
Reconstruct expõe dados capturados por servidor MCP. Escolha seu agente para configurar:
- Codex
- Claude
- Cursor
- Cline
- GitHub Copilot no VS Code
- Gemini CLI
- MiMo
- Muse Code
- Grok Build
- Hermes Agent
- OpenClaw
- OpenMausBot
- Outros clientes MCP
Antes de começar
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
Não é necessário emitir token pessoal antes de conectar por OAuth.
- Adicione
https://reconstruct.dev/mcpcomo servidor HTTP MCP remoto. - Escolha OAuth ou login no navegador. Se forem pedidos ajustes, use os valores abaixo.
- Inicie Sign in (Entrar), Connect (Conectar) ou o comando de login MCP. A ação depende do cliente.
- Entre com sua conta Reconstruct no navegador e aprove o acesso. Sem cadastro disponível, contate suporte para acesso à conta.
- Volte e atualize as ferramentas. Peça uma chamada a
list_productspara 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, Claude Code, Cursor, Cline, OpenMausBot ou outro cliente. Use o retorno documentado para o cliente. Se pedir novo login, repita seu fluxo MCP.
Compatibilidade de clientes
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. 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
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 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
- Entre em Reconstruct Platform e abra Settings → API tokens (Configurações → Tokens API).
- Crie token com escopo MCP (
mcp) e copie o segredo ao aparecer. - Configure
Authorization: Bearer <token>. Se ler de variável, useCR_RECONSTRUCT_MCP_TOKEN. - 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
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.
Solução de problemas
| 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 ou veja o catálogo MCP.
Solicitar captura nova ou atualização
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.