# Grok Build 연결 {/* #connect-grok-build */}

## 브라우저 로그인(OAuth) {/* #browser-sign-in-oauth */}

자동 OAuth 등록을 사용하려면 `oauth` 재정의 없이 서버 URL을 추가한 다음 `/mcps`에서 로그인하세요. Grok이 콜백을 등록하고 브라우저 복귀를 처리합니다.

사전 등록된 클라이언트를 사용하려면 `~/.grok/config.toml`에 다음 설정을 추가하세요:

```toml
[mcp_servers.reconstruct]
url = "https://reconstruct.dev/mcp"
oauth = { clientId = "reconstruct-mcp", scopes = ["openid", "aud-mcp", "offline_access"], callbackPort = 58234 }
```

Grok Build에서 `/mcps`를 열고 `r`로 설정을 다시 로드한 다음 `reconstruct`를 선택하고 `i`로 로그인하세요. 콜백은 `http://127.0.0.1:58234/callback`입니다. 포트 58234를 사용 가능하게 유지하세요. 클라이언트 보안 비밀은 필요하지 않습니다. Grok이 로컬 콜백 리스너를 시작하고 브라우저 로그인 후 자동으로 연결을 마칩니다. 이 공개 클라이언트는 PKCE S256을 사용하는 Authorization Code 방식이며 MCP 동의를 요청합니다. Grok은 로그인 후 토큰 갱신을 위해 `offline_access`도 요청하며 이 클라이언트에서는 선택 범위입니다. 플랫폼 액세스가 있는 계정이 필요합니다.

중첩된 OAuth 설정은 camelCase(`clientId`, `callbackPort`)를 사용합니다. 서버 URL만 지정하면 지원되는 클라이언트는 자체의 정확한 콜백 URI로 자동 동적 등록을 수행합니다. [MCP OAuth 설정](/docs/ko/connect-ai-agents#oauth-browser-sign-in)을 참고하세요.

## 개인 액세스 토큰 {/* #personal-access-token */}

브라우저 로그인을 사용할 수 없을 때 이 대안을 사용하세요. 위 OAuth 항목에는 Authorization 헤더를 추가하지 마세요.

[Reconstruct Platform 계정 설정](https://reconstruct.dev/platform/)에서 MCP 액세스 토큰을 복사하세요. 연결 요건은 [개인 액세스 토큰](/docs/ko/connect-ai-agents#personal-access-token)을 참고하세요. Grok Build를 실행하는 환경에 `CR_RECONSTRUCT_MCP_TOKEN`을 설정하세요.

사용자 `~/.grok/config.toml`에 다음을 추가하세요. 파일에 다른 MCP 서버가 있다면 기존 항목을 유지하고 `reconstruct` 섹션만 추가하세요:

```toml
[mcp_servers.reconstruct]
url = "https://reconstruct.dev/mcp"
headers = { "Authorization" = "Bearer ${CR_RECONSTRUCT_MCP_TOKEN}" }
```

Grok Build는 설정을 읽을 때 환경의 `${CR_RECONSTRUCT_MCP_TOKEN}`을 확장합니다. 토큰 자체를 프로젝트 파일에 저장하지 마세요.

`grok`으로 Grok Build를 시작하세요. 이미 실행 중이라면 설정 편집 후 `/mcps`를 열고 `r`로 새로고침하세요.

등록과 연결 상태를 확인하세요:

```sh
grok mcp doctor reconstruct
```

액세스 확인을 위해 Grok Build에 `reconstruct` 도구로 `list_products`를 호출하도록 요청하세요.

## 스킬 지침 {/* #skill-instructions */}

MCP 리소스와 MCP 도구는 별개의 기능입니다. 일부 Grok Build 버전은 `resources/read` 없이 `search_tool`과 `use_tool`로 에이전트에 캡처 도구를 제공합니다. `resources/list`를 도구로 호출해도 스킬이 로드되지 않습니다.

클라이언트에서 리소스를 사용할 수 없다면 Grok에 `list_skills`를 호출한 다음 카탈로그 리소스 URI(`skill://reconstruct/` 뒤에 반환된 경로)로 `get_skill`을 호출하도록 요청하세요. 일반 MCP 도구를 통해 같은 패키지 지침을 가져오므로 별도 설치가 필요하지 않습니다. 보조 템플릿도 `get_skill`로 읽을 수 있습니다.

이 스킬 도구가 없는 이전 서버에서는 스킬을 별도로 설치하거나 시작 전에 공개 웹사이트 지침을 읽으세요. 재구현에는 `https://reconstruct.dev/.well-known/agent-skills/<skill-name>/SKILL.md`의 `reconstruct-inspect`, `reconstruct-build`, `reconstruct-verify`를 사용하세요. 공개 검색 카탈로그는 `https://reconstruct.dev/.well-known/agent-skills/index.json`입니다. 캡처 데이터는 여전히 인증된 MCP 연결에서 가져옵니다. 설치 옵션은 [Reconstruct 스킬](/docs/ko/skills)을 참고하세요.

현재 재구현 워크플로는 연결된 서버가 제공하는 경우 `get_interface_scene`을 우선 사용합니다. 측정/선언/추론된 사실과 명시적인 누락 증거를 포함한 동일한 중립 Scene 계약을 플랫폼 어댑터용으로 내보냅니다. DOM/CSS는 선택적인 웹 진단 정보입니다. 공개된 Build 참고 문서를 `get_skill`로 읽으세요. 내보내기 성공을 데스크톱, 모바일, 상호작용 또는 애니메이션 충실도 검증과 동일시하지 마세요. 이전 서버는 자신이 제공하는 기존 증거 도구를 사용하며 그로 인한 공백을 밝혀야 합니다.

공식 [Grok Build MCP 가이드](https://docs.x.ai/build/features/mcp-servers)를 참고하세요. 다음으로 [프롬프트 예시](/docs/ko/prompt-examples)를 사용해 보세요.