Conectar outro cliente MCP

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.

Adicionar o servidor

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

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

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

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

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

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 o URI exibido pelo cliente.

Token de acesso pessoal

Sem OAuth, crie um token MCP 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

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. Após conectar, experimente os exemplos de prompts.