본문으로 이동

도움말:S3 연구 메모리/파일럿 가정

S3 연구 메모리

이 페이지는 저장소 문서에서 자동으로 동기화됩니다. 위키에서 직접 편집하지 마세요.

  • 2026-07-15에 받은 작업 공간은 비어 있었습니다. Git 메타데이터, README, AGENTS.md, 소스 코드, 배포 규칙이 없었으므로 요청한 디렉터리에 새 구조를 만들었습니다.
  • 신뢰할 수 있는 단일 연구실, 단일 노드용 파일럿입니다. 고가용성 또는 적대적인 다중 테넌트 환경을 대상으로 하지 않습니다. 모든 에이전트는 중앙 mcp-http Streamable HTTP 어댑터 한 개를 공유하며, 기준 저장소는 Semantic MediaWiki 한 곳뿐입니다. 클라이언트별 어댑터나 별도 Lesson 데이터베이스는 두지 않습니다.
  • 모든 클라이언트는 https://s3wiki.yonsei.ac.kr/mcp 한 곳에 연결합니다. 검색과 변경 도구 모두 이 엔드포인트를 사용합니다. 쓰기 인증은 open, token, github 운영 모드 중 하나를 사용합니다. 각 컴퓨터에 둔 별도 엔드포인트나 로컬 사본은 협업 구조에 포함하지 않습니다.
  • 브라우저의 MediaWiki 페이지와 MCP 검색은 공개합니다. 브라우저 편집에는 이름이 있는 계정이 필요하고, MCP에서는 변경 도구 세 개에만 공유 Bearer 토큰이 필요합니다. 비공개가 필요한 내용은 기본 사용 범위에 넣지 않습니다.
  • 기본 배포에서는 s3wiki.yonsei.ac.kr의 Caddy가 HTTPS를 처리하고 MCP의 직접 연결 포트는 loopback에 묶습니다. 8765번은 진단용이며 클라이언트가 연결할 대체 엔드포인트가 아닙니다. 서버 담당자가 S3RM_WIKI_DIRECT_URL을 명시하면 8080에는 브라우저용 직접 HTTP 입구를 함께 둘 수 있습니다. 이 입구는 같은 MediaWiki를 사용하며 MCP 주소나 별도 저장소가 아닙니다. 호스팅 서비스의 쓰기나 개인별 신원 확인이 필요할 때만 OAuth, 기관 SSO, MFA를 추가합니다.
  • 파일럿은 중앙 MCP 쓰기 토큰의 다이제스트 한 개와 최소 권한 MediaWiki 에이전트 계정 한 개를 사용합니다. 여러 클라이언트가 함께 쓸 수 있지만 리비전의 작성자는 개별 클라이언트나 사람이 아닌 서비스 계정으로 기록됩니다. 이 토큰은 개인별로 폐기하거나 만료할 수 없으며 사용자를 확인해 기록하지도 않습니다. MediaWiki 리비전에는 서비스 계정이 무엇을 언제 바꿨는지가 남습니다. 이 구분이 필요해지면 사용자별 OAuth/OIDC를 추가할 수 있습니다. 읽기 전용 클라이언트에는 토큰이 필요하지 않습니다.
  • mcp-http는 Lesson 상태를 저장하지 않으므로 다시 만들 수 있습니다. github 모드의 OAuth client와 token 상태도 현재는 프로세스 메모리에만 있어 재시작하면 다시 인증해야 합니다. 중단되어도 저장된 지식은 남습니다. 복구 대상은 MariaDB, 업로드, MediaWiki 설정입니다.
  • Caddy의 인증서 및 실행 상태는 caddy_data와 caddy_config에 저장합니다. 일반 재시작에서는 두 볼륨을 유지하지만 기준 Lesson 복구 대상에는 넣지 않습니다. 인증서는 DNS와 저장소의 Caddyfile을 사용해 다시 발급할 수 있습니다.
  • 새로 설치한 위키에는 Lesson이 없습니다. 브라우저나 중앙 MCP에서 첫 메모를 저장하기 전까지 검색 결과와 최근 페이지 목록이 비어 있는 것은 정상입니다.
  • 백업 및 복구 자동화는 Bash 4+와 GNU coreutils/tar를 갖춘 GNU/Linux Docker 호스트를 대상으로 합니다. 화면 확인에는 Docker Desktop을 쓸 수 있지만, 복구 작업은 Linux VM이나 이에 준하는 Linux 호스트에서 실행합니다.
  • MediaWiki 페이지 리비전에는 변경 출처와 이력이 남으며 이전 내용으로 되돌릴 수 있습니다. 스팸이나 잘못된 지식의 입력을 막지는 않습니다. 파일럿에는 공식 전자 서명이나 변경 불가 규정 준수 저장소가 없습니다.
  • 시각은 UTC ISO-8601 문자열로 저장합니다. 브라우저에 표시할 시간대는 따로 설정할 수 있습니다.
  • 근거 바이너리와 원시 데이터셋은 Lesson 밖에 둡니다. 위키에는 짧은 인용, URL, 체크섬, 설명 메모를 저장합니다. 작은 보조 파일은 일반 MediaWiki 업로드 기능으로 올릴 수 있습니다.
  • 처음에는 MediaWiki의 MariaDB 전체 텍스트 검색을 사용합니다. MCP는 페이지명이 아니라 Lesson 본문을 찾도록 검색 범위를 명시합니다. 띄어쓰기와 정확한 단어에 기반하므로 의미가 비슷한 다른 표현까지 찾지는 않습니다. 벡터 인덱스는 선택 사항이며 기준 쓰기 경로 밖에서 만드는 교체 가능한 파생 데이터입니다.
  • Lesson:<slug>를 고정 외부 식별자로 사용합니다. MCP 인용에 이전 ID가 남을 수 있으므로 이 페이지의 이름은 가급적 바꾸지 말고, 필요한 경우 먼저 조율합니다. MediaWiki 리디렉션은 계속 작동합니다.
원본 주소 "https://s3wiki.yonsei.ac.kr/index.php?title=도움말:S3_연구_메모리/파일럿_가정&oldid=195"