MCP 통합
OpenFactory는 모델 컨텍스트 프로토콜 을 지원하므로 AI 도우미가 빌드 생성, 레시피 검사, VM 관리 및 테스트 결과 검토를 도울 수 있습니다.
도구 간 전환 없이 Claude, Cursor, Claude Code, OpenAI Codex 또는 다른 MCP 호환 클라이언트에서 OpenFactory로 작업하려는 경우 MCP를 사용하십시오.
요구 사항
- 원격 MCP 서버를 지원하는 MCP 클라이언트
- 계정 기반 액세스를 위해서는 이 브라우저에서 OpenFactory에 로그인하세요.
- 게스트 액세스의 경우 아래에 표시된 생성된 게스트 토큰을 사용하세요.
계정 API 키는 생성 시 한 번 표시되며 콘솔에서 취소할 수 있습니다. 게스트 토큰은 측정 액세스를 위한 브라우저 식별자입니다. 그것은 계정 비밀이 아닙니다.
엔드포인트
| 교통 | URL | 사용 |
|---|---|---|
| 스트리밍 가능한 HTTP | https://console.openfactory.tech/mcp-stream/mcp | OpenFactory MCP 엔드포인트 |
스트리밍 가능한 HTTP는 유일하게 지원되는 전송입니다. 이전 HTTP+SSE 엔드포인트(/mcp/sse, /mcp/messages)는 폐기되었으며 이제 410 Gone를 반환합니다. 동일한 Authorization 헤더를 사용하여 위의 스트리밍 가능한 HTTP URL에서 여전히 이를 사용하는 모든 클라이언트를 가리킵니다. Claude Code, Claude Desktop, Cursor, Codex 및 OpenCode는 모두 Streamable HTTP를 지원합니다.
구성 복사-붙여넣기
MCP 설정을 변경한 후 Claude Desktop, Cursor, OpenAI Codex 또는 기타 장기 실행 MCP 클라이언트를 다시 시작하십시오. OpenAI Codex는 ~/.codex/config.toml에서 MCP 서버를 읽고 Streamable HTTP에 직접 연결합니다. mcp-remote 브리지가 필요하지 않습니다. Claude.ai 사용자 정의 커넥터는 서버 URL과 헤더를 별도의 필드로 요청할 수 있습니다.
사용 가능한 기능
OpenFactory는 다음을 위한 고객 대면 도구를 제공합니다.
| 카테고리 | 예 |
|---|---|
| 빌드 | 빌드 나열, 레시피에서 빌드 생성, 빌드 상태 확인, 실패한 빌드 재시도 |
| 조리법 | 템플릿 탐색, 레시피 검증, 템플릿 사용자 정의 |
| 이미지 | 완성된 아티팩트에 대한 다운로드 링크 받기 |
| VM | VM 나열, 테스트 VM 생성, VM 시작 또는 중지, 콘솔 링크 열기 |
| 테스트 | 검증 실행, 테스트 실행 나열, 테스트 결과 검사, 재사용 가능한 테스트 모음 관리 |
| 앱 UI 테스트 | 테스터 VM을 구동하여 any app URL 테스트: 재사용 가능, 자체 강화 GUI 시나리오. 배포가 필요하지 않습니다 |
| 앱 배포 | 공개 미리 보기 URL(https://<slug>.apps.openfactory.tech)을 사용하여 라이브 웹 앱에 Git 저장소 배포 |
도구 가용성은 계획 및 조직 권한에 따라 달라질 수 있습니다.
재사용 가능한 테스트 스위트
변형 또는 ISO가 구축되기 전에 테스트 스위트를 생성할 수 있습니다. 하나를 정의하십시오
또는 더 많은 테스트 사례, 사용자 정의 어설션, 사전 정의된 테스트 및 명명된 ISO 대상
primary, client 또는 server와 같은 슬롯입니다. 빌드가 준비되면 각 빌드를 바인딩합니다.
완료된 빌드에 슬롯을 추가하고 제품군을 실행합니다.
| 도구 | 사용 |
|---|---|
create_test_suite | 빌드된 변형 없이 재사용 가능한 제품군 만들기 |
list_test_suites | 현재 MCP 사용자가 사용할 수 있는 제품군 나열 |
get_test_suite | 제품군 정의 및 최근 실행 기록 보기 |
update_test_suite_targets | 명명된 ISO 대상 슬롯을 완료된 빌드에 바인딩 |
run_test_suite | 바인딩된 ISO 대상 슬롯에 대해 제품군 실행 |
list_test_suite_runs | 제품군에서 생성된 실행 나열 |
get_test_suite_status | 작성 준비 상태 및 최신 실행 상태 보기 |
앱 UI 테스트: 모든 URL, 배포 없음
관리형 테스터 VM을 지정하여 user interface of any web app을 테스트합니다. URL. 테스트하기 위해 OpenFactory를 사용하여 앱을 배포하지 않습니다. 테스터 VM Vercel, AWS에서 로컬 개발 서버, 미리보기/프로덕션 배포를 엽니다. Netlify, 호스트 또는 VM에서 연결할 수 있는 공개 URL. 귀하의 앱은 그대로 유지됩니다 이미 실행 중인 곳입니다.
Scenarios are written in plain language and are self-hardening: the first run
각 UI 요소가 어디에 있는지 학습하고 나중에 해당 메모리에서 재생을 실행합니다(건너뛰기
느린 시각적 패스). 이를 통해 리플레이가 빠르고 작은 UI 변경에도 탄력적으로 이루어집니다. 시나리오 지원
environment variables (${VAR}) and 2FA (${totp:VAR}, RFC 6238) for
로그인; 비밀은 런타임에 전달되며 저장되지 않습니다.
| 도구 | 사용 |
|---|---|
ensure_tester_vm | 영구 데스크톱 테스터 VM 가져오기 또는 만들기 |
create_app_scenario | 앱 URL에 대한 재사용 가능한 GUI 시나리오 저장 |
run_app_scenario | 실행하고(여기에 런타임 비밀 전달) 스크린샷 + 평결 기록 |
list_app_scenarios / get_app_scenario | 시나리오 및 강화된 캐시 찾아보기 |
start_app_test / record_app_test_step / finish_app_test | 임시 실행을 직접 운전하고 기록 |
annotate_screenshot | 스크린샷에 레이블이 지정된 강조 상자 그리기 |
전체 워크플로 단계는 앱 UI 테스트를 참조하세요. 스키마 및 2FA 예시.
앱 배포: 공개 URL에 대한 Git 저장소
Deploy a web app straight from a Git repository and get a public preview URL
(https://<slug>.apps.openfactory.tech) that you can open, share, or point a test
시나리오에서. OpenFactory는 저장소를 복제하고, 종속성을 설치하고, 앱을 시작합니다.
건강검진을 해드립니다. 연결할 것이 없습니다. 포트 포워딩도 없고,
터널 또는 DNS.
이는 앱 UI 테스트와 결합됩니다. 앱을 배포한 다음 앱에 대해 시나리오를 실행합니다. URL을 미리 보거나 배포를 건너뛰고 이미 호스팅하고 있는 앱(Vercel, AWS 등)을 테스트하세요.
| 도구 | 사용 |
|---|---|
create_app | Git 저장소를 앱으로 등록(이름, 소스, 슬러그) |
deploy_app | 앱 배포 및 공개 미리보기 URL 반환 |
list_apps / get_app | 앱, 해당 URL 및 배포 기록 찾아보기 |
iterate_app | 자연어 변경 사항을 앱에 전달합니다. 에이전트가 이를 적용하고 재배포 |
get_app_build_status | 앱의 배포 상태 및 진행 중인 변경 티켓 폴링 |
전체 워크플로는 앱 배포를 참조하세요. 당신의 자신의 사용자가 마이크 버튼을 통해 앱의 변경 사항을 말합니다. 음성 반복 위젯.
프롬프트 예시
Show my most recent OpenFactory builds and summarize any failures.Create a Debian server image with SSH, Docker, a deploy user, and default verification tests.Validate this recipe before I start a build.Start a VM from my latest completed build and give me the console link.Create a reusable smoke test suite for example-project with primary and client ISO slots. I will bind the builds later.Create a smoke-login scenario for my app at https://my-app.vercel.app, run it in a tester VM, and verify the dashboard loads. I'll give you the password and 2FA seed at run time.보안 참고 사항
- 신뢰하는 클라이언트에만 API 키를 사용하세요.
- 머신을 회전하거나 프로젝트를 종료할 때 콘솔에서 이전 키를 취소합니다.
- 빌드 생성, VM 시작 또는 인프라 변경 작업에 대해 승인이 필요한 도구 권한을 선호합니다.
- OpenFactory API 키를 프롬프트, 티켓, 공개 저장소 또는 공유 문서에 붙여넣지 마세요.
문제 해결
도구가 표시되지 않음
MCP 클라이언트를 다시 시작하고 서버 URL이 정확히 다음과 같은지 확인하세요.
https://console.openfactory.tech/mcp-stream/mcpIf your client is configured with the retired /mcp/sse URL it will get a
410 Gone: URL을 위의 URL로 변경합니다. 다른 것은 변경할 필요가 없습니다.
인증 실패
이 페이지를 새로 고치고 생성된 구성을 다시 복사하세요. Signed-in users should use the generated Authorization header. Guest users should use the generated X-Guest-Id header from the copy-paste config above.
빌드 또는 VM 작업 실패
OpenFactory 계획, 조직 권한, 빌드 상태를 확인하세요. 일부 작업에는 완료된 빌드, 영구 VM 자격 또는 Enterprise 권한이 필요합니다.
전송 오류
Streamable HTTP를 지원하지 않는 경우 MCP 클라이언트를 업데이트하세요. 업데이트할 수 없는 경우 HTTP+SSE 호환성 엔드포인트로 전환하세요.