Tilda Agent OS / Tilda MCP

상태: 0.2.0-prealpha — 격리된 승인된 실험실에서 2단계 수직 슬라이스가 완료되었으며, 활발한 개발이 계속 진행 중입니다.

Tilda Agent OS는 코딩 에이전트가 시각적 Tilda 에디터와 제한된 기계 판독 가능 작업을 통해 작업할 수 있게 하는 오픈소스 컨트롤 플레인입니다. 동일 세션 브라우저 권한, 타입이 지정된 ChangeSet, 정확한 대상 게이트, 작업 후 재읽기, 롤백, 그리고 별도의 게시 제어를 결합합니다.

이 저장소는 프리알파 후보이며, 프로덕션 또는 범용 Tilda MCP가 아닙니다. 공개 패키지에는 의도적으로 실제 계정/프로젝트/페이지/레코드 ID, 고객 콘텐츠, 도메인, 브라우저 상태, 원시 추적 또는 비공개 라이브 픽스처가 포함되어 있지 않습니다. 좁은 라이브 수직 슬라이스는 격리된 실험실에서 비공개로 검증되었습니다. 공개 체크아웃은 재현 가능한 코드와 단위 테스트 표면이지 해당 계정의 재생 가능한 사본이 아닙니다.

여기에 있는 것

• 로컬 MCP stdio 서버와 11개의 제한된 도구: status, capabilities, exact reads, ChangeSet plan/apply/verify/rollback, 별도의 게시 및 게시 취소 요청, 공개 검증, 그리고 하나의 고정된 페이지 수명 주기 트랜잭션.

• 타입이 지정된 ChangeSet 및 스냅샷 저장소: 오래된 상태 검사, 멱등성, 추가 전용 저널 이벤트, 기본 차단(fail-closed) 복구, 그리고 심볼릭 링크/경로 가드.

• 좁고 증거 기반의 standard.field.patch, t123.code.replace, Zero Block 리프/반응형/클론 전환, 그리고 page.seo.patch 작업을 위한 어댑터 계약과, 전체 페이지별 HEAD 읽기 및 사이드 이펙트로 게시하지 않는 page.head.code.replace 수명 주기.

• 현재 인증된 세션에 다시 바인딩되고 편집기 읽기, 쓰기 및 게시를 하나의 명시적인 대상 게이트 워크플로에 유지하는 루프백 CDP 브라우저 권한.

• 정제된 관측 가능성과 라이브 대상 ID를 사용하지 않고 원격 쓰기를 수행하지 않는 공개 읽기 전용 MCP 스모크.

비공개 2단계 증거는 되돌릴 수 있는 Standard 및 T123 변경, 좁은 Zero 및 SEO 변경, 페이지별 HEAD 교체, 페이지 수명 주기, 별도의 게시/공개 검증, 소스 프로젝트 거부, 그리고 전용 브라우저 재시작/재바인딩 후 읽기 전용 MCP 스모크를 포함했습니다. 이러한 주장은 의도적으로 테스트된 정확한 실험실/에디터/런타임 형태로 제한되며, 모든 Tilda 블록, 필드, 중단점, 계정 또는 에디터 릴리스에 대한 지원을 의미하지 않습니다.

빠른 시작

요구 사항: Node.js 20+, pnpm 11+, (로컬 인증 연구에만 해당) 원격 디버깅이 활성화된 전용 Chrome/Chromium 프로필.

if (-not (Test-Path .env)) { Copy-Item .env.example .env }
pnpm install --frozen-lockfile
pnpm typecheck
pnpm test
pnpm build
pnpm smoke:mcp

공개 스모크는 로컬 MCP 프로토콜, 11개의 도구 등록, 구조화된 기능 출력, 구조화된 상태 출력을 확인합니다. 로그인하지 않으며, 라이브 대상을 열지 않고, Tilda를 변경하지 않고, 아무것도 게시하지 않으며, 계정 ID를 요구하지 않습니다.

Codex의 경우 프로젝트 범위 구성은 .codex/config.toml에 있습니다. 서버를 pnpm mcp로 수동 시작하고, stdout은 MCP JSON-RPC 전용이며 진단은 stderr로 출력됩니다.

안전 경계

• 운영자가 운영할 권한이 있는 계정과 프로젝트만 사용합니다.

• 기존의 모든 프로젝트는 읽기 전용으로 취급합니다. 실험에는 전용 격리 실험실을 사용합니다.

• 쓰기 전에 로컬 무시된 읽기 전용 인벤토리와 정확한 실험실 허용 목록을 구축합니다. 공개 패키지에는 계정별 원장이 포함되어 있지 않으므로 구성되지 않은 체크아웃은 기본 차단(fail-closed) 상태를 유지합니다.

• 모든 편집은 읽기 → 스냅샷 → 드라이런 → 단일 의미론적 변경 → 재읽기 → 정확한 diff → 복원 → 재읽기 복원 순서를 따릅니다.

• 편집은 절대 게시하지 않습니다. 게시와 게시 취소는 별도의 승인 게이트 작업입니다.

• 자격 증명, 쿠키, 인증/CSRF 데이터, 브라우저 프로필, HAR 또는 원시 추적, Leads, 주문, PII, 독점 콘텐츠 또는 실제 Tilda ID를 절대 커밋하지 마세요.

• 모호하거나 실패한 문서화되지 않은 쓰기는 격리 처리됩니다. 맹목적으로 재시도하지 마세요.

주장과 증거 경계는 SECURITY.md, ARCHITECTURE.md, 그리고 CAPABILITIES.md를 참조하세요.

이것이 중요한 이유

코딩 에이전트는 이미 소스 파일, Git, CLI, API, 데이터베이스에 대한 신뢰할 수 있는 기계 인터페이스를 갖추고 있습니다. 시각적 SaaS 에디터는 다릅니다. 커서 기반 자동화는 취약하고, 문서화되지 않은 런타임 요청은 안전하지 않을 수 있습니다. 이 프로젝트는 명시적 정체성, 되돌릴 수 있는 트랜잭션, 증거 라벨, 그리고 중요한 게이트에서의 인간 승인을 통해 이러한 환경을 운영하기 위한 이식 가능한 패턴을 탐구합니다.

범위 및 로드맵

현재 릴리스는 좁은 프리알파 수직 슬라이스입니다. 일반 편집기 쓰기 API, 임의 페이지/레코드 접근, 모든 Zero 패밀리, 자산, 카탈로그/양식, 프로젝트 간 이동, 휴지통 복구, 사이트 전체 HEAD, Advanced Interface Mode 호환성, 또는 프로덕션 안정성을 주장하지 않습니다. 다음 증거 게이트는 ROADMAP.md를 참조하세요.

라이선스

Apache-2.0. Tilda는 해당 소유자의 상표입니다. 이 독립 프로젝트는 Tilda와 제휴하거나, 보증하거나, 지원하지 않습니다.