# Reconstruct 문서

> 사람, 에이전트, 애플리케이션을 위한 인터페이스 컨텍스트입니다. 인증, REST, gRPC, MCP에 관한 공개 가이드입니다.

MCP는 스트리밍 HTTP를 사용합니다. 작업 공간 데이터에 접근하려면 승인된 OAuth 또는 권한 범위가 제한된 개인 토큰이 필요합니다.

## MCP

- [MCP 엔드포인트](https://reconstruct.dev/mcp): OAuth 또는 개인 MCP 토큰을 사용하는 스트리밍 HTTP입니다.
- [MCP 서버 카드](https://reconstruct.dev/mcp/server-card): 공개 연결 메타데이터입니다.

## 가이드

- [Claude](https://reconstruct.dev/docs/ko/agents/claude.md): Claude — 사용 중인 Claude 앱에 맞는 가이드를 선택하세요. 둘 다 https://reconstruct.dev/mcp에 연결하며 Reconstruct 계정에서 이용 가능한 캡처에 Claude가 접근할 수 있게 합니다.
- [Claude Code](https://reconstruct.dev/docs/ko/agents/claude-code.md): Claude Code — 브라우저에서 Reconstruct 계정으로 로그인하세요. 플랫폼에서 개인 토큰을 만들 필요가 없습니다. 공통 연결 설정은 MCP OAuth 설정을 참고하세요.
- [Claude Desktop](https://reconstruct.dev/docs/ko/agents/claude-desktop.md): Claude Desktop — Claude Desktop에서 Customize → Connectors(버전에 따라 Settings → Connectors)를 열고 사용자 지정 원격 MCP 커넥터를 추가하세요. 웹용 Claude에도 같은 절차가 적용됩니다.
- [Cline](https://reconstruct.dev/docs/ko/agents/cline.md): Cline — Cline이 OAuth 클라이언트를 자동 등록하고 동의 후 자격 증명을 저장합니다. 클라이언트 보안 비밀이나 수동으로 복사한 토큰은 필요하지 않습니다.
- [Codex](https://reconstruct.dev/docs/ko/agents/codex.md): Codex — 브라우저에서 Reconstruct 계정으로 로그인하세요. 플랫폼에서 개인 토큰을 만들 필요가 없습니다. 공통 연결 설정은 MCP OAuth 설정을 참고하세요.
- [Cursor](https://reconstruct.dev/docs/ko/agents/cursor.md): Cursor — 브라우저에서 Reconstruct 계정으로 로그인하세요. 플랫폼에서 개인 토큰을 만들 필요가 없습니다. 공통 연결 설정은 MCP OAuth 설정을 참고하세요.
- [Gemini CLI](https://reconstruct.dev/docs/ko/agents/gemini-cli.md): Gemini CLI — 이 가이드는 개인 액세스 토큰을 사용합니다.
- [Grok Build](https://reconstruct.dev/docs/ko/agents/grok-build.md): Grok Build — 자동 OAuth 등록을 사용하려면 oauth 재정의 없이 서버 URL을 추가한 다음 /mcps에서 로그인하세요.
- [Hermes Agent](https://reconstruct.dev/docs/ko/agents/hermes.md): Hermes Agent — 이 가이드는 개인 액세스 토큰을 사용합니다.
- [MiMo](https://reconstruct.dev/docs/ko/agents/mimo.md): MiMo — 사용 중인 MiMo 앱에 맞는 가이드를 선택하세요. 둘 다 https://reconstruct.dev/mcp에 연결하며 MiMo가 Reconstruct 계정에서 이용 가능한 캡처에 접근할 수 있게 합니다.
- [MiMo Code](https://reconstruct.dev/docs/ko/agents/mimo-code.md): MiMo Code — 이 가이드는 개인 액세스 토큰을 사용합니다.
- [MiMo Desktop](https://reconstruct.dev/docs/ko/agents/mimo-desktop.md): MiMo Desktop — 이 가이드는 개인 액세스 토큰을 사용합니다. 개인 액세스 토큰에 설명된 대로 Reconstruct Platform 설정에서 MCP 범위 토큰을 만드세요.
- [Muse Code](https://reconstruct.dev/docs/ko/agents/muse-code.md): Muse Code — 이 가이드는 개인 액세스 토큰 또는 등록된 콜백 http://127.0.0.1:58234/callback을 쓰는 브라우저 OAuth를 지원합니다. 클라이언트 호환성을 참고하세요.
- [OpenClaw](https://reconstruct.dev/docs/ko/agents/openclaw.md): OpenClaw — 이 가이드는 OpenClaw의 기본 MCP 클라이언트 설정과 개인 액세스 토큰을 사용합니다.
- [OpenMausBot](https://reconstruct.dev/docs/ko/agents/openmausbot.md): OpenMausBot — MCP 토큰을 만들고 URL 서버에 다음 헤더를 설정하세요:
- [기타 MCP 클라이언트](https://reconstruct.dev/docs/ko/agents/other-mcp-clients.md): 기타 MCP 클라이언트 — 여기에 전용 가이드가 없지만 원격 MCP 서버를 지원하는 AI 에이전트나 편집기에는 이 절차를 적용하세요. 먼저 시작하기 전에 설명된 대로 OAuth 또는 개인 토큰을 선택하세요.
- [VS Code의 GitHub Copilot](https://reconstruct.dev/docs/ko/agents/vscode-copilot.md): VS Code의 GitHub Copilot — VS Code에 Reconstruct 설치는 사용자 설정에 https://reconstruct.dev/mcp 서버를 추가합니다.
- [gRPC](https://reconstruct.dev/docs/ko/api/grpc.md): gRPC — Platform API 토큰을 만들려면 API로 연결부터 시작하세요. gRPC-Web 클라이언트는 https://reconstruct.dev을 사용합니다. 네이티브 gRPC는 TLS로 reconstruct.dev:443에 연결하고 proto 서비스 이름에서 생성된 메서드 경로를 사용합니다. 모든 호출에 authorization: Bearer <token> 메타데이터가 필요합니다.
- [C++](https://reconstruct.dev/docs/ko/api/grpc/cpp.md): C++ — Platform API 토큰을 만들고 platform.proto를 받으려면 gRPC 가이드부터 시작하세요. protoc, grpc_cpp_plugin, gRPC 및 protobuf C++ 라이브러리를 설치하세요. 설치 방법은 공식 C++ 시작 가이드를 참고하세요.
- [C#](https://reconstruct.dev/docs/ko/api/grpc/csharp.md): C# — Platform API 토큰을 만들고 platform.proto를 받으려면 gRPC 가이드부터 시작하세요. 아래 명령은 해당 파일이 있는 디렉터리에서 실행하세요.
- [Go](https://reconstruct.dev/docs/ko/api/grpc/go.md): Go — Platform API 토큰을 만들고 platform.proto를 받으려면 gRPC 가이드부터 시작하세요. protoc, Go 및 Go protobuf 플러그인을 설치하세요.
- [Java](https://reconstruct.dev/docs/ko/api/grpc/java.md): Java — Platform API 토큰을 만들고 platform.proto를 받으려면 gRPC 가이드부터 시작하세요. 클라이언트 계약은 java_package = "dev.reconstruct.platform.v1"을 설정하고 메시지별 Java 클래스를 생성합니다. 이 예시는 Gradle과 gRPC Java protobuf 플러그인을 사용합니다.
- [Python](https://reconstruct.dev/docs/ko/api/grpc/python.md): Python — Platform API 토큰을 만들고 platform.proto를 받으려면 gRPC 가이드부터 시작하세요. 아래 명령은 해당 파일이 있는 디렉터리에서 실행하세요.
- [Rust](https://reconstruct.dev/docs/ko/api/grpc/rust.md): Rust — Platform API 토큰을 만들고 platform.proto를 받으려면 gRPC 가이드부터 시작하세요. 이 예시는 tonic 및 tonic-prost-build로 네이티브 HTTP/2 클라이언트를 생성합니다. 먼저 Rust와 protoc를 설치하세요.
- [TypeScript](https://reconstruct.dev/docs/ko/api/grpc/typescript.md): TypeScript — Platform API 토큰을 만들고 platform.proto를 받으려면 gRPC 가이드부터 시작하세요. 아래 명령은 해당 파일이 있는 디렉터리에서 실행하세요.
- [REST](https://reconstruct.dev/docs/ko/api/rest.md): REST — Platform API 토큰을 만들려면 API로 연결부터 시작하세요. 공개 REST 기본 URL은 https://reconstruct.dev/api/v1/platform입니다. 아래 경로는 이 URL에 대한 상대 경로입니다.
- [C++](https://reconstruct.dev/docs/ko/api/rest/cpp.md): C++ — Platform API 토큰을 받으려면 REST 가이드부터 시작하세요. 이 예시는 HTTPS에 libcurl, JSON 파싱에 nlohmann/json을 사용합니다. 먼저 C++ 개발 패키지를 설치하세요.
- [C#](https://reconstruct.dev/docs/ko/api/rest/csharp.md): C# — Platform API 토큰을 만들려면 REST 가이드부터 시작하세요. 이 예시는 HttpClient와 내장 JSON API를 사용하며 생성된 gRPC 클라이언트가 필요하지 않습니다.
- [curl](https://reconstruct.dev/docs/ko/api/rest/curl.md): curl — Platform API 토큰을 만들려면 REST 가이드부터 시작하세요.
- [Go](https://reconstruct.dev/docs/ko/api/rest/go.md): Go — Platform API 토큰을 받으려면 REST 가이드부터 시작하세요. 이 예시는 Go 표준 라이브러리를 사용하므로 클라이언트 생성이나 추가 패키지가 필요하지 않습니다.
- [Java](https://reconstruct.dev/docs/ko/api/rest/java.md): Java — Platform API 토큰을 받으려면 REST 가이드부터 시작하세요. 이 예시는 Java의 HttpClient와 JSON 파싱용 Jackson을 사용합니다.
- [Python](https://reconstruct.dev/docs/ko/api/rest/python.md): Python — Platform API 토큰을 만들려면 REST 가이드부터 시작하세요. 이 예시는 Python 표준 라이브러리를 사용하며 생성된 클라이언트가 필요하지 않습니다.
- [Rust](https://reconstruct.dev/docs/ko/api/rest/rust.md): Rust — Platform API 토큰을 받으려면 REST 가이드부터 시작하세요. 이 예시는 reqwest 동기 클라이언트와 Serde를 사용합니다.
- [TypeScript](https://reconstruct.dev/docs/ko/api/rest/typescript.md): TypeScript — Platform API 토큰을 만들려면 REST 가이드부터 시작하세요. 이 예시는 Node.js 18 이상처럼 fetch가 있는 서버에서 실행됩니다. 토큰은 브라우저 코드가 아닌 서버에 보관하세요.
- [로그인 및 계정 액세스](https://reconstruct.dev/docs/ko/auth.md): 로그인 및 계정 액세스 — Reconstruct Platform을 열고 Sign in을 선택하세요. 로그인 절차를 완료하면 워크스페이스로 돌아갑니다. 처음 사용한다면 로그인 페이지의 Register로 계정을 만드세요.
- [AI 에이전트 연결](https://reconstruct.dev/docs/ko/connect-ai-agents.md): AI 에이전트 연결 — Reconstruct는 MCP 서버를 통해 캡처된 인터페이스 데이터를 제공합니다. 설정 안내를 보려면 에이전트를 선택하세요:
- [API로 연결](https://reconstruct.dev/docs/ko/connect-api.md): API로 연결 — 공개 API로 자체 앱에서 캡처 카탈로그를 나열하고 상세 정보를 읽으세요. 생성형 클라이언트에는 gRPC(브라우저용 gRPC-Web 포함), HTTP의 JSON에는 REST를 선택하세요.
- [Scene 데이터 형식](https://reconstruct.dev/docs/ko/data-format.md): Scene 데이터 형식 — 등록, 로그인 및 Chrome 확장 프로그램 흐름은 수동 기록 및 검토를 참고하세요. 기록 도구는 같은 Scene 계약을 사용하며 Admin 검토 후에만 이미지를 공개합니다.
- [시작하기](https://reconstruct.dev/docs/ko/getting-started.md): 시작하기 — Reconstruct는 AI 코딩 에이전트에게 실제 웹 인터페이스의 모습과 동작에 대한 컨텍스트를 제공합니다.
- [수동 Chrome 확장 프로그램 시나리오](https://reconstruct.dev/docs/ko/manual-recording.md): 수동 Chrome 확장 프로그램 시나리오 — 수동 기록은 Desktop → Web Extension Admin 캡처 작업으로 실행됩니다. 내부 환경은 WebExtension, 캡처 메타데이터와 공개 MCP는 web-extension을 사용합니다. 에이전트는 선택된 Chrome 웹 스토어 확장을 다운로드하고 해당 확장과 Reconstruct 캡처 확장을 넣은 일회용 Chromium 프로필을 엽니다. 운영자가 탐색하며 Reconstruct는 화면과 관찰된 전환을 reconstruct.scene.v1으로 저장합니다.
- [MCP 도구](https://reconstruct.dev/docs/ko/mcp-tools.md): MCP 도구 — 다음 MCP 도구로 제품을 검색하고 캡처 인터페이스 컨텍스트를 읽고 에셋을 다운로드하고 제품 요청을 제출하세요. 도구 이름은 snake_case입니다.
- [요금제 한도](https://reconstruct.dev/docs/ko/pricing-limits.md): 요금제 한도 — Settings → Subscription → Usage에서 남은 월간 한도를 확인하세요.
- [프롬프트 예시](https://reconstruct.dev/docs/ko/prompt-examples.md): 프롬프트 예시 — 이 프롬프트는 연결된 MCP 에이전트에서 사용하세요. 대괄호 값을 캡처 제품, 버전 및 페이지 식별자로 바꾸세요. 브라우저와 네이티브 환경을 포함한 list_platforms.options.platforms[]에서 플랫폼 형식과 환경 ID를 선택하세요. 데스크톱/모바일이 전체 목록이라 가정하지 말고 반환된 ID를 사용하세요. 재구현에는 list_platforms.platforms[]의 캡처 쌍만 사용하세요. 지원 옵션이 저장 데이터를 의미하지는 않습니다. ## 제품 및 버전 찾기
- [Reconstruct 스킬](https://reconstruct.dev/docs/ko/skills.md): Reconstruct 스킬 — Reconstruct 스킬은 제품 작업에 집중된 워크플로를 AI 에이전트에 제공합니다. 스킬마다 지침과 필요한 보조 템플릿이 있습니다. 작업에 맞는 스킬을 선택하세요. 하나를 사용해도 전체 제품 수명 주기가 자동 실행되지는 않습니다.
- [시스템 상태](https://reconstruct.dev/docs/ko/status.md): 시스템 상태 — Reconstruct 상태 페이지에서 서비스 상태, 진행 중 사고 및 사고 이력을 확인하세요.

## 추가 자료

- [전체 문서](https://reconstruct.dev/docs/ko/llms-full.txt): 게시된 모든 가이드를 하나의 Markdown 파일로 제공합니다.