Grok Build 연결
브라우저 로그인(OAuth)
자동 OAuth 등록을 사용하려면 oauth 재정의 없이 서버 URL을 추가한 다음 /mcps에서 로그인하세요. Grok이 콜백을 등록하고 브라우저 복귀를 처리합니다.
사전 등록된 클라이언트를 사용하려면 ~/.grok/config.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 설정을 참고하세요.
개인 액세스 토큰
브라우저 로그인을 사용할 수 없을 때 이 대안을 사용하세요. 위 OAuth 항목에는 Authorization 헤더를 추가하지 마세요.
Reconstruct Platform 계정 설정에서 MCP 액세스 토큰을 복사하세요. 연결 요건은 개인 액세스 토큰을 참고하세요. Grok Build를 실행하는 환경에 CR_RECONSTRUCT_MCP_TOKEN을 설정하세요.
사용자 ~/.grok/config.toml에 다음을 추가하세요. 파일에 다른 MCP 서버가 있다면 기존 항목을 유지하고 reconstruct 섹션만 추가하세요:
[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로 새로고침하세요.
등록과 연결 상태를 확인하세요:
grok mcp doctor reconstruct
액세스 확인을 위해 Grok Build에 reconstruct 도구로 list_products를 호출하도록 요청하세요.
스킬 지침
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 스킬을 참고하세요.
현재 재구현 워크플로는 연결된 서버가 제공하는 경우 get_interface_scene을 우선 사용합니다. 측정/선언/추론된 사실과 명시적인 누락 증거를 포함한 동일한 중립 Scene 계약을 플랫폼 어댑터용으로 내보냅니다. DOM/CSS는 선택적인 웹 진단 정보입니다. 공개된 Build 참고 문서를 get_skill로 읽으세요. 내보내기 성공을 데스크톱, 모바일, 상호작용 또는 애니메이션 충실도 검증과 동일시하지 마세요. 이전 서버는 자신이 제공하는 기존 증거 도구를 사용하며 그로 인한 공백을 밝혀야 합니다.
공식 Grok Build MCP 가이드를 참고하세요. 다음으로 프롬프트 예시를 사용해 보세요.