Erstan Agent Tools Beta

AI 코딩 에이전트를 위한 임시 Erstan 베타 통합입니다. 이 저장소는 베타 사용자를 Erstan의 격리된 QA 환경에 연결하는 하나의 광범위한 플러그인을 패키징하며, 에이전트와 스킬을 구축·검토·최적화하고, 실행을 운영하고, 승인된 워크스페이스 콘텐츠를 다루기 위한 집중적인 지침을 제공합니다.

베타 환경: 이 플러그인의 데이터와 OAuth 권한 부여는 프로덕션과 분리되어 있습니다. 워크스페이스가 마이그레이션되면 프로덕션 erstan 플러그인을 설치하세요. 그러면 이 저장소는 폐기됩니다.

플러그인에는 Erstan API 키가 포함되어 있지 않습니다. 각 사용자는 AI 호스트를 통해 OAuth로 https://api-qa.erstan.com/v1/mcp에 로그인합니다. Erstan의 서버 측 베타 액세스 정책이 액세스 경계로 유지되며, 저장소 공개 여부가 제품 액세스를 부여하지는 않습니다.

포함 내용

• erstan-agent-builder — 에이전트 그래프를 생성, 수정, 검증, 테스트, 게시합니다.

• erstan-agent-optimizer — 기존 에이전트를 검색하여 가장 작은 버전 연동 최적화 제안을 생성합니다.

• erstan-agent-review — 에이전트 정의를 검토하고 지속적인 증거를 바탕으로 실행을 진단합니다.

• erstan-run-operator — 게시된 에이전트를 실행하고 대기, 승인, 추적을 안전하게 처리합니다.

• erstan-skill-manager — 완전한 버전 관리형 Erstan 스킬 패키지를 관리합니다.

• erstan-skill-optimizer — 완전한 워크스페이스 스킬 패키지를 검색하여 비즈니스 규칙, 파일, 액션 메타데이터를 잃지 않고 최적화합니다.

• erstan-work-manager — 승인된 작업, 프로젝트, 문서, 폴더, 파일을 다룹니다.

개념적 agent:optimize 및 skill:optimize 작업은 $erstan-agent-optimizer와 $erstan-skill-optimizer 스킬로 배포됩니다. 이들은 npm CLI 명령이 아닙니다. 기본적으로 증거에 기반한 로컬 제안과 검증 결과에서 멈추며, 업데이트, 실시간 에이전트 미리보기, 게시는 각각 별도의 명시적 승인이 필요합니다.

Related MCP server: mcp-testing-tools

권한 모델

Erstan은 연결이 액세스할 수 있는 범위에 대한 진실의 원천입니다. 사용자는 설정 > 연결된 앱에서 연결된 앱, 워크스페이스 범위, 허용된 도구 계열, 프로젝트 또는 팀 허용 목록, Erstan 측 승인 정책을 관리합니다.

초기 인증은 권장되는 빌드 프로필을 기본값으로 합니다. 여기에는 에이전트 보기, 에이전트 빌드, 에이전트 실행, 에이전트 게시와 읽기 전용 권한인 실행 보기, 작업 보기, 문서 보기, 파일 보기가 포함됩니다. 작업, 문서, 파일 쓰기는 허용되지 않습니다. 읽기 전용 액세스에는 검토를 사용하세요. 쓰기가 필요하면 해당 작업 관리, 문서 편집, 파일 편집 권한과 함께 사용자 지정을 사용하거나 전체 액세스를 선택하세요.

사용자는 설정 > 연결된 앱에서 연결을 관리하고 취소합니다. 액세스 축소는 즉시 적용됩니다. 권한을 늘리거나 더 넓은 프로필로 변경하려면 명시적인 OAuth 재인증이 필요하므로, 백그라운드 에이전트가 자신의 권한을 스스로 확장할 수 없습니다.

Claude, Codex, ChatGPT 또는 다른 MCP 호스트는 로컬 연결 세션과 자체 확인 컨트롤을 소유합니다. 호스트는 액세스를 축소하거나 추가 확인을 요구할 수 있지만, Erstan이 거부한 권한을 부여할 수는 없습니다. Erstan에서 연결을 취소하면 해당 연결을 사용하는 모든 호스트 세션에서 무효화됩니다.

이 2계층 모델은 권한을 이해하기 쉽게 유지합니다.

1. Erstan이 승인된 데이터와 작업의 최대 범위를 결정합니다.

2. AI 호스트가 해당 경계 내에서 작업을 호출할지 여부를 결정합니다.

Codex에 설치

erstan-beta@erstan-beta는 plugin-name@marketplace-name을 의미합니다. 계정 ID나 비밀 키가 아닙니다.

codex plugin marketplace add erstanai/erstan-agent-tools-beta
codex plugin add erstan-beta@erstan-beta

새 Codex 세션을 열고 /plugins를 사용하여 설치를 확인한 다음, 프롬프트가 표시되면 erstan-beta MCP 서버에 연결하고 브라우저 로그인을 완료하세요. 플러그인은 plugins/erstan-beta/.mcp.json의 원격 서버 구성을 사용합니다.

Claude Code에 설치

claude plugin marketplace add erstanai/erstan-agent-tools-beta
claude plugin install erstan-beta@erstan-beta

/reload-plugins를 실행한 다음 /mcp를 실행하여 erstan-beta에 연결하고 OAuth를 완료하세요. Claude Code가 원격 MCP 인증을 시작합니다. 플러그인은 사용자에게 베어러 토큰이나 API 키를 붙여넣도록 요청하지 않습니다.

Claude Cowork / Desktop에 설치

사용자 지정 > 플러그인 > 플러그인 찾아보기를 열고 마켓플레이스 추가를 선택한 다음 입력하세요:

https://github.com/erstanai/erstan-agent-tools-beta

Erstan Beta를 설치하고 프롬프트가 표시되면 브라우저 로그인을 완료하세요. 플러그인은 표준 Claude Chat 환경이 아닌 Claude Cowork와 Claude Code에서 사용할 수 있습니다.

업데이트 또는 제거

호스트의 플러그인 브라우저를 사용하여 Erstan Beta를 업데이트, 비활성화 또는 제거하세요. 로컬 플러그인을 제거해도 기존 Erstan OAuth 권한 부여는 취소되지 않습니다. Erstan의 설정 > 연결된 앱에서 권한 부여를 검토하거나 취소하세요.

게시된 버전과 체크섬은 GitHub Releases에서 확인할 수 있습니다.

ChatGPT 및 기타 호스트

이 임시 베타 저장소는 범용 ChatGPT 및 Codex 플러그인 디렉토리에 제출되지 않습니다. 의도적으로 .app.json을 포함하지 않습니다. OpenAI 앱 매핑은 게시 중에 할당된 실제 등록된 plugin_asdk_app... 또는 asdk_app_... 식별자를 사용해야 합니다. 배포 경계는 게시를 참조하세요.

다른 MCP 클라이언트는 다음에 직접 연결할 수 있습니다:

https://api-qa.erstan.com/v1/mcp

배포된 서버는 표준을 준수하는 OAuth 디스커버리 및 인증을 노출해야 합니다. 이 배포판에는 정적 키 폴백이 없습니다.

로컬 검증

요구 사항: Node.js 20 이상, Python 3, 선택 사항으로 네이티브 검증기를 위한 Claude Code.

npm run verify
python C:/Users/<you>/.codex/skills/.system/plugin-creator/scripts/validate_plugin.py plugins/erstan-beta
python C:/Users/<you>/.codex/skills/.system/skill-creator/scripts/quick_validate.py plugins/erstan-beta/skills/erstan-agent-builder
claude plugin validate .

plugins/erstan-beta/skills 아래의 각 디렉터리에 대해 스킬 검증기를 한 번씩 실행하세요. CI는 저장소가 소유한 릴리스 검증기를 실행합니다. 네이티브 Codex, Skill, Claude 검증기는 가용성과 스키마를 각각의 호스트가 소유하므로 필수 릴리스 게이트로 유지됩니다.

프로덕션에서 동기화

베타 배포판은 명시적인 ID 및 엔드포인트 변환이 적용된 검토된 프로덕션 체크아웃에서 파생됩니다. 로컬에서 다음을 실행하세요:

npm run sync:production -- --source ../erstan-agent-tools

이 명령은 프로덕션 스킬과 에셋을 복사하고, 플러그인 메타데이터를 일치시키며, 고유한 erstan-beta ID를 유지하고, 호스팅된 MCP 엔드포인트를 https://api-qa.erstan.com/v1/mcp로 다시 작성합니다. 수동 Sync production distribution GitHub Actions 워크플로는 동일한 변환을 수행하고, 결과를 검증하며, 검토를 위해 풀 리퀘스트를 엽니다. 베타 릴리스를 게시하거나 병합하지 않습니다. --version은 더 높은 프리릴리스 번호가 필요한 경우에만 전달하세요. 버전은 프로덕션 버전의 프리릴리스로 유지되어야 합니다.

툴킷 분리

이 저장소는 작고 설치 가능한 최종 사용자 배포판입니다. 유지관리자 CLI 유틸리티와 오프라인 진단 픽스처는 별도의 erstan-agent-toolkit 저장소에 속하며 플러그인 릴리스에 복사되어서는 안 됩니다.

라이선스

Apache License 2.0. LICENSE를 참조하세요.