다른 MCP 클라이언트 연결
여기에 전용 가이드가 없지만 원격 MCP 서버를 지원하는 AI 에이전트나 편집기에는 이 절차를 적용하세요. 먼저 시작하기 전에 설명된 대로 OAuth 또는 개인 토큰을 선택하세요.
서버 추가
- 클라이언트의 MCP 서버 설정을 열고 이름이
reconstruct인 서버를 추가하세요. - Streamable HTTP를 선택하세요. HTTP 또는 remote HTTP로 표시되기도 합니다.
- 서버 URL을
https://reconstruct.dev/mcp로 설정하세요.
브라우저에서 OAuth 로그인
클라이언트가 OAuth 검색과 동적 클라이언트 등록(DCR)을 지원한다면 https://reconstruct.dev/mcp만 추가하고 OAuth를 선택하여 연결하세요. 클라이언트가 자체 콜백을 등록하고 Reconstruct 로그인을 연 다음 액세스 승인 후 콜백을 자동 수신합니다. Client ID나 콜백 포트를 직접 입력할 필요가 없습니다.
호스팅 앱은 https://app.example.com/mcp/callback처럼 공개 도메인의 정확한 HTTPS 콜백을 등록할 수 있습니다. 네이티브 앱은 명시적 포트를 사용해 127.0.0.1 또는 localhost의 정확한 HTTP 콜백을 등록할 수 있습니다. 콜백은 MCP 서버가 아닌 클라이언트가 소유하고 처리합니다. 등록에는 PKCE S256, 사용자 동의 및 MCP 전용 범위가 필요합니다. 와일드카드, 루프백이 아닌 HTTP 주소, 프래그먼트 및 원격 키 URL은 거부됩니다.
자동 등록이 없는 클라이언트
앱이 자체 등록할 수 없다면 사전 등록된 공개 클라이언트를 사용하세요:
- 클라이언트 ID는
reconstruct-mcp, 범위는openid aud-mcp로 설정하고 클라이언트 보안 비밀은 비워 두세요. - 로컬 OAuth 콜백 포트를
58234, 경로를/callback으로 설정하세요. - 저장하고 연결한 다음 브라우저 로그인을 완료하고 액세스를 승인한 후 클라이언트로 돌아오세요.
사용자 지정 클라이언트의 로컬 콜백
클라이언트가 사용자 컴퓨터의 포트 58234에서 수신하도록 설정하고 다음의 정확한 리디렉션 URI 중 하나를 사용하세요:
http://127.0.0.1:58234/callbackhttp://localhost:58234/callback
클라이언트는 PKCE(S256)를 사용하는 Authorization Code 방식을 지원해야 합니다. 클라이언트 ID reconstruct-mcp와 범위 openid aud-mcp를 사용하고 클라이언트 보안 비밀은 사용하지 마세요. 로그인 및 토큰 교환에 전송하는 리디렉션 URI는 설정된 URI와 정확히 일치해야 합니다.
포트 58234는 로컬 브라우저 콜백 전용입니다. 원격 MCP 서버 URL은 HTTPS의 https://reconstruct.dev/mcp로 유지됩니다. 콜백 리스너는 루프백 인터페이스에 바인딩하고 네트워크에 포트를 노출하지 마세요. 이 포트에서는 한 번에 하나의 로그인 흐름만 수신할 수 있으므로 다른 로그인을 시작하기 전에 기존 로그인을 마치세요.
클라이언트로 자동 복귀
MCP 클라이언트는 브라우저를 열기 전에 로컬 콜백 리스너를 시작해야 합니다. 로그인과 동의 후 Keycloak이 브라우저를 해당 리스너로 리디렉션합니다. 클라이언트는 인증 응답을 받아 PKCE로 코드를 교환하고 MCP 연결을 재개합니다. 사용자가 콜백 URL이나 인증 코드를 직접 복사할 필요가 없어야 합니다.
Muse Code, Grok Build, Codex 및 Claude Code는 각 가이드와 같이 공통 포트를 사용할 수 있습니다. Cursor나 Claude Desktop처럼 자체 고정 콜백이 있는 클라이언트는 지원되는 콜백 주소를 유지합니다.
사용자 지정 C# 앱에서는 ClientOAuthOptions.RedirectUri를 설정하고 AuthorizationCallbackHandler를 구현하여 브라우저를 열고 code, state, iss를 수집하세요. 리디렉션 URI 설정만으로 리스너가 생성되지는 않습니다. SDK 기본 핸들러는 리디렉션 URL을 수동으로 요청합니다. 공식 C# SDK OAuth 옵션을 참고하세요.
발급자는 https://reconstruct.dev/sso/realms/reconstruct입니다. 루트의 /authorize, /token URL을 직접 만들지 말고 검색된 인증 및 토큰 엔드포인트를 사용하세요.
OAuth 선택 시 수동으로 설정한 Authorization 헤더를 제거하세요. 로그인 중 콜백 오류가 발생하면 클라이언트에 표시된 콜백 URI로 지원팀에 문의하세요.
개인 액세스 토큰
OAuth를 지원하지 않는 클라이언트에서는 Platform 설정에서 MCP 토큰을 만들고 HTTP 헤더 Authorization을 Bearer <your MCP token>으로 설정하세요. 지원된다면 클라이언트의 비밀 저장소 또는 CR_RECONSTRUCT_MCP_TOKEN 환경 변수를 사용하세요.
연결 확인
클라이언트를 다시 연결하거나 재시작하세요. 도구 목록에 list_products가 있는지 확인한 다음 에이전트에 호출을 요청하세요.
모든 클라이언트가 공유하는 단일 JSON 형식은 없습니다. 일부는 mcpServers, 다른 일부는 servers 또는 mcp를 사용하며 type 필드가 필요한 경우도 있습니다. 정확한 필드 이름과 토큰 치환 문법은 클라이언트 문서를 따르세요. 이전 SSE 전송만 지원하는 클라이언트는 Reconstruct의 HTTP /mcp 엔드포인트를 SSE로 사용할 수 없습니다.