# Conectar outro cliente MCP {/* #connect-another-mcp-client */}

Estes passos se aplicam a um agente de IA ou editor com MCP remoto, mas sem guia específico aqui. Primeiro escolha OAuth ou token pessoal conforme [Antes de começar](/docs/pt/connect-ai-agents#before-you-start).

## Adicionar o servidor {/* #add-the-server */}

1. Abra os ajustes de servidores MCP do cliente e adicione um servidor `reconstruct`.
2. Selecione **Streamable HTTP**, às vezes chamado **HTTP** ou **remote HTTP**.
3. Defina a URL do servidor como `https://reconstruct.dev/mcp`.

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

Se o cliente admitir descoberta OAuth e registro dinâmico de clientes (DCR), adicione apenas `https://reconstruct.dev/mcp`, escolha OAuth e conecte. O cliente registra seu retorno, abre o login Reconstruct e recebe automaticamente o retorno após você aprovar. Não é preciso informar ID ou porta manualmente.

Aplicativos hospedados podem registrar retorno HTTPS exato em domínio público, como `https://app.example.com/mcp/callback`. Aplicativos nativos podem registrar retorno HTTP exato em `127.0.0.1` ou `localhost` com porta explícita. O retorno pertence ao cliente e é tratado por ele, não pelo servidor MCP. O registro exige PKCE `S256`, consentimento e escopos apenas MCP. Curingas, HTTP fora de loopback, fragmentos e URL de chaves remotas são rejeitados.

### Clientes sem registro automático {/* #clients-without-automatic-registration */}

Use o cliente público pré-registrado se o aplicativo não puder se registrar:

1. Defina ID `reconstruct-mcp`, escopos `openid aud-mcp` e deixe o segredo vazio.
2. Defina a porta local OAuth `58234` e o caminho `/callback`.
3. Salve e conecte, conclua o login pelo navegador, aprove o acesso e volte ao cliente.

### Retorno local para clientes personalizados {/* #local-callback-for-custom-clients */}

Configure o cliente para escutar na porta `58234` do seu computador e usar um destes URI exatos:

- `http://127.0.0.1:58234/callback`
- `http://localhost:58234/callback`

O cliente deve admitir código de autorização com PKCE (`S256`). Use ID `reconstruct-mcp`, escopos `openid aud-mcp` e nenhum segredo. O URI enviado no login e na troca de token deve corresponder exatamente ao configurado.

A porta `58234` serve apenas ao retorno local do navegador. A URL remota continua `https://reconstruct.dev/mcp` por HTTPS. Vincule o receptor à interface loopback; não exponha a porta à rede. Apenas um fluxo pode escutá-la de cada vez; termine o login existente antes de iniciar outro.

### Retorno automático ao cliente {/* #automatic-return-to-the-client */}

O cliente MCP deve iniciar o receptor local antes de abrir o navegador. Após login e consentimento, Keycloak redireciona para ele; o cliente recebe a resposta, troca o código com PKCE e retoma a conexão MCP. O usuário não deve precisar copiar URL ou código de autorização manualmente.

Muse Code, Grok Build, Codex e Claude Code podem usar a porta compartilhada conforme seus guias. Clientes com retorno fixo próprio, como Cursor ou Claude Desktop, mantêm seus endereços compatíveis.

Em um aplicativo C# personalizado, configure `ClientOAuthOptions.RedirectUri` e implemente `AuthorizationCallbackHandler` para abrir o navegador e capturar `code`, `state` e `iss`. Definir apenas o URI não cria receptor; o handler padrão do SDK pede a URL manualmente. Consulte as [opções OAuth oficiais do SDK C#](https://github.com/modelcontextprotocol/csharp-sdk/blob/main/src/ModelContextProtocol.Core/Authentication/ClientOAuthOptions.cs).

O emissor é `https://reconstruct.dev/sso/realms/reconstruct`; use os endpoints descobertos de autorização/token em vez de construir `/authorize` e `/token` na raiz.

Remova `Authorization` manual ao escolher OAuth. Se houver erro de retorno no login, [informe ao suporte](https://reconstruct.dev/support) o URI exibido pelo cliente.

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

Sem OAuth, [crie um token MCP](/docs/pt/connect-ai-agents#personal-access-token) na plataforma e defina `Authorization` como `Bearer <your MCP token>`. Use o cofre do cliente ou `CR_RECONSTRUCT_MCP_TOKEN` se suportados.

## Verificar a conexão {/* #check-the-connection */}

Reconecte ou reinicie o cliente. Confirme `list_products` na lista de ferramentas e peça ao agente para chamá-lo.

Não há formato JSON único entre clientes. Alguns usam `mcpServers`, outros `servers` ou `mcp`; alguns exigem `type`. Siga a documentação para campos exatos e interpolação de tokens. Um cliente apenas SSE antigo não pode usar o endpoint HTTP `/mcp` do Reconstruct como SSE.

Se falhar, veja a [tabela de solução de problemas](/docs/pt/connect-ai-agents#troubleshooting). Após conectar, experimente os [exemplos de prompts](/docs/pt/prompt-examples).