도움말:S3 연구 메모리/참고문서: 두 판 사이의 차이
외관
S3 연구 메모리 저장소 문서 게시 |
S3 연구 메모리 저장소 문서 동기화 |
||
| 6번째 줄: | 6번째 줄: | ||
=== S3 웹사이트 === | === S3 웹사이트 === | ||
* [https://cslab.yonsei.ac.kr/ S3@Yonsei laboratory website] — 색, 글꼴 조합, 여백, 데스크톱·모바일 메뉴를 참고했습니다. 공식 로고와 favicon의 출처는 | * [https://cslab.yonsei.ac.kr/ S3@Yonsei laboratory website] — 색, 글꼴 조합, 여백, 데스크톱·모바일 메뉴를 참고했습니다. 공식 로고와 favicon의 출처는 <code><nowiki>docker/mediawiki/assets/README.md</nowiki></code> (<code><nowiki>../docker/mediawiki/assets/README.md</nowiki></code>)에 적혀 있습니다. 위키는 실행할 때 Google Sites에 의존하지 않습니다. 글꼴과 메인 사진은 복사하거나 외부 링크로 불러오지 않습니다. | ||
=== 연세대학교 네트워크 === | === 연세대학교 네트워크 === | ||
| 18번째 줄: | 18번째 줄: | ||
* [https://www.mediawiki.org/wiki/Manual:Restoring_a_wiki_from_backup MediaWiki manual: Restoring a wiki from backup] — 복원 순서, 버전 호환, DB 가져오기와 파일 복구 절차입니다. | * [https://www.mediawiki.org/wiki/Manual:Restoring_a_wiki_from_backup MediaWiki manual: Restoring a wiki from backup] — 복원 순서, 버전 호환, DB 가져오기와 파일 복구 절차입니다. | ||
* [https://www.mediawiki.org/wiki/Manual:Upgrading MediaWiki manual: Upgrading] — 업데이트 전 호환성 확인, 백업과 DB 마이그레이션 절차입니다. | * [https://www.mediawiki.org/wiki/Manual:Upgrading MediaWiki manual: Upgrading] — 업데이트 전 호환성 확인, 백업과 DB 마이그레이션 절차입니다. | ||
* [https://www.mediawiki.org/wiki/Manual:$wgServer MediaWiki manual: | * [https://www.mediawiki.org/wiki/Manual:$wgServer MediaWiki manual: <code><nowiki>$wgServer</nowiki></code>] — 프록시 뒤에서 외부 링크의 기준 주소를 정하는 설정입니다. | ||
* [https://www.mediawiki.org/wiki/Manual:$wgForceHTTPS MediaWiki manual: | * [https://www.mediawiki.org/wiki/Manual:$wgForceHTTPS MediaWiki manual: <code><nowiki>$wgForceHTTPS</nowiki></code>] — HTTPS 강제와 reverse proxy 사용 시 주의점입니다. | ||
* [https://www.mediawiki.org/wiki/Manual:HTTPS MediaWiki manual: HTTPS] — HTTPS와 proxy forwarding 설정입니다. | * [https://www.mediawiki.org/wiki/Manual:HTTPS MediaWiki manual: HTTPS] — HTTPS와 proxy forwarding 설정입니다. | ||
* [https://www.mediawiki.org/wiki/Manual:User_rights MediaWiki manual: User rights] — 브라우저 사용자, 제한된 MCP 계정, 관리자 권한을 나누는 기준입니다. | * [https://www.mediawiki.org/wiki/Manual:User_rights MediaWiki manual: User rights] — 브라우저 사용자, 제한된 MCP 계정, 관리자 권한을 나누는 기준입니다. | ||
| 32번째 줄: | 32번째 줄: | ||
* [https://docs.docker.com/reference/compose-file/services/ Docker Compose service reference] — 서비스 환경, health check, 의존성과 profile 문법입니다. | * [https://docs.docker.com/reference/compose-file/services/ Docker Compose service reference] — 서비스 환경, health check, 의존성과 profile 문법입니다. | ||
* [https://docs.docker.com/engine/storage/volumes/ Docker storage volumes] — named volume의 저장 방식과 수명 주기입니다. | * [https://docs.docker.com/engine/storage/volumes/ Docker storage volumes] — named volume의 저장 방식과 수명 주기입니다. | ||
* [https://mariadb.com/kb/en/mariadb-dump/ MariaDB | * [https://mariadb.com/kb/en/mariadb-dump/ MariaDB <code><nowiki>mariadb-dump</nowiki></code>] — 논리 DB 백업과 복원 가능한 출력 형식입니다. | ||
=== 공개 HTTPS === | === 공개 HTTPS === | ||
* [https://caddyserver.com/docs/automatic-https Caddy automatic HTTPS] — 공개 DNS와 80/443 요구 사항, HTTP 전환, 인증서 발급·갱신 방식입니다. | * [https://caddyserver.com/docs/automatic-https Caddy automatic HTTPS] — 공개 DNS와 80/443 요구 사항, HTTP 전환, 인증서 발급·갱신 방식입니다. | ||
* [https://caddyserver.com/docs/quick-starts/reverse-proxy Caddy reverse proxy quick start] — <code><nowiki>domain</nowiki></code> Compose profile에서 쓰는 주소와 upstream routing 방식입니다. | * [https://caddyserver.com/docs/quick-starts/reverse-proxy Caddy reverse proxy quick start] — <code><nowiki>domain</nowiki></code> Compose profile에서 쓰는 주소와 upstream routing 방식입니다. | ||
* [https://caddyserver.com/docs/caddyfile/directives/reverse_proxy Caddy | * [https://caddyserver.com/docs/caddyfile/directives/reverse_proxy Caddy <code><nowiki>reverse_proxy</nowiki></code> directive] — Host 전달, <code><nowiki>X-Forwarded-Proto</nowiki></code>, streaming 동작입니다. | ||
* [https://hub.docker.com/_/caddy Official Caddy Docker image] — 고정한 컨테이너 이미지와 <code><nowiki>/data</nowiki></code>, <code><nowiki>/config</nowiki></code> 저장 경로입니다. | * [https://hub.docker.com/_/caddy Official Caddy Docker image] — 고정한 컨테이너 이미지와 <code><nowiki>/data</nowiki></code>, <code><nowiki>/config</nowiki></code> 저장 경로입니다. | ||
=== MCP 클라이언트 === | === MCP 클라이언트 === | ||
| 44번째 줄: | 44번째 줄: | ||
* [https://developers.openai.com/apps-sdk/build/auth OpenAI Apps SDK: Authentication] — 사용자 데이터와 쓰기 도구가 있는 MCP에 필요한 OAuth 2.1, protected resource metadata, PKCE와 access-token 검증 요건입니다. | * [https://developers.openai.com/apps-sdk/build/auth OpenAI Apps SDK: Authentication] — 사용자 데이터와 쓰기 도구가 있는 MCP에 필요한 OAuth 2.1, protected resource metadata, PKCE와 access-token 검증 요건입니다. | ||
* [https://help.openai.com/en/articles/12584461-developer-mode-apps-and-full-mcp-connectors-in-chatgpt-beta OpenAI Help: Developer mode and MCP apps] — Business·Enterprise/Edu workspace의 <code><nowiki>Create</nowiki></code> 후 Draft 게시, 접근 범위와 action control 절차입니다. | * [https://help.openai.com/en/articles/12584461-developer-mode-apps-and-full-mcp-connectors-in-chatgpt-beta OpenAI Help: Developer mode and MCP apps] — Business·Enterprise/Edu workspace의 <code><nowiki>Create</nowiki></code> 후 Draft 게시, 접근 범위와 action control 절차입니다. | ||
* [https://developers.openai.com/codex/guides/agents-md OpenAI Codex: Custom instructions with | * [https://developers.openai.com/codex/guides/agents-md OpenAI Codex: Custom instructions with <code><nowiki>AGENTS.md</nowiki></code>] — Codex가 저장소 지침을 찾고 적용하는 순서입니다. | ||
* [https://developers.openai.com/codex/mcp OpenAI Codex: Model Context Protocol] — Streamable HTTP URL, <code><nowiki>bearer_token_env_var</nowiki></code>, <code><nowiki>.codex/config.toml</nowiki></code>, CLI 관리와 도구 승인 설정입니다. ChatGPT 웹은 로컬 Codex 설정을 읽지 않으므로 workspace 앱으로 연결해야 한다는 점도 확인했습니다. | * [https://developers.openai.com/codex/mcp OpenAI Codex: Model Context Protocol] — Streamable HTTP URL, <code><nowiki>bearer_token_env_var</nowiki></code>, <code><nowiki>.codex/config.toml</nowiki></code>, CLI 관리와 도구 승인 설정입니다. ChatGPT 웹은 로컬 Codex 설정을 읽지 않으므로 workspace 앱으로 연결해야 한다는 점도 확인했습니다. | ||
* [https://developers.openai.com/codex/config-reference OpenAI Codex: Configuration reference] — <code><nowiki>mcp_servers.*.url</nowiki></code>, <code><nowiki>bearer_token_env_var</nowiki></code>, 환경변수 기반 HTTP header, timeout, 승인 설정의 정확한 형식입니다. | * [https://developers.openai.com/codex/config-reference OpenAI Codex: Configuration reference] — <code><nowiki>mcp_servers.*.url</nowiki></code>, <code><nowiki>bearer_token_env_var</nowiki></code>, 환경변수 기반 HTTP header, timeout, 승인 설정의 정확한 형식입니다. | ||
| 65번째 줄: | 65번째 줄: | ||
README와 위키 문구는 사용자가 제공한 <code><nowiki>korean-humanizer</nowiki></code> 체크리스트를 기준으로 다듬었습니다. 아래 두 저장소는 과장된 요약, 번역투, 반복되는 결론 같은 AI 문체를 찾는 데 참고했으며 애플리케이션의 실행 의존성은 아닙니다. | README와 위키 문구는 사용자가 제공한 <code><nowiki>korean-humanizer</nowiki></code> 체크리스트를 기준으로 다듬었습니다. 아래 두 저장소는 과장된 요약, 번역투, 반복되는 결론 같은 AI 문체를 찾는 데 참고했으며 애플리케이션의 실행 의존성은 아닙니다. | ||
* [https://github.com/epoko77-ai/im-not-ai | * [https://github.com/epoko77-ai/im-not-ai <code><nowiki>epoko77-ai/im-not-ai</nowiki></code>] | ||
* [https://github.com/blader/humanizer | * [https://github.com/blader/humanizer <code><nowiki>blader/humanizer</nowiki></code>] | ||
2026년 7월 18일 (토) 12:33 판
이 페이지는 저장소 문서에서 자동으로 동기화됩니다. 위키에서 직접 편집하지 마세요.
이 파일럿의 정확한 동작은 저장소 문서와 테스트를 기준으로 합니다. 아래 링크는 사용한 제품의 공식 설명입니다. 버전을 올리기 전에는 해당 버전의 릴리스 노트도 확인하세요.
S3 웹사이트
- S3@Yonsei laboratory website — 색, 글꼴 조합, 여백, 데스크톱·모바일 메뉴를 참고했습니다. 공식 로고와 favicon의 출처는
docker/mediawiki/assets/README.md(../docker/mediawiki/assets/README.md)에 적혀 있습니다. 위키는 실행할 때 Google Sites에 의존하지 않습니다. 글꼴과 메인 사진은 복사하거나 외부 링크로 불러오지 않습니다.
연세대학교 네트워크
- DNS 신청 —
*.yonsei.ac.kr호스트 이름과 A·CNAME 레코드를 신청하는 절차입니다. - 보안정책서비스 안내 — 교내 시스템을 외부에 공개할 때 필요한 방화벽 신청 절차입니다. 목적지 IP와 port를 적어야 하며, 필요한 웹서비스의 80/443은 출발지 IP 특정 조건의 예외입니다. 보안정책 문의 번호는
02-2123-6419입니다. - 보안정책 신청 — 연세 계정으로 로그인해 실제 신청서를 여는 주소입니다. 이 서버의 외부 TCP 80/443 허용은 여기서 신청합니다.
- 네트워크 PORT 신청 — 건물의 물리 네트워크 port 설치 절차입니다. 서버 방화벽 개방 신청과는 다릅니다.
MediaWiki와 확장 기능
- MediaWiki manual: Backing up a wiki — 데이터베이스, 업로드, 설정과 XML 백업 범위를 확인했습니다. 이 파일럿은 DB와 업로드를 한 복구 세트로 묶습니다.
- MediaWiki manual: Restoring a wiki from backup — 복원 순서, 버전 호환, DB 가져오기와 파일 복구 절차입니다.
- MediaWiki manual: Upgrading — 업데이트 전 호환성 확인, 백업과 DB 마이그레이션 절차입니다.
- MediaWiki manual:
$wgServer— 프록시 뒤에서 외부 링크의 기준 주소를 정하는 설정입니다. - MediaWiki manual:
$wgForceHTTPS— HTTPS 강제와 reverse proxy 사용 시 주의점입니다. - MediaWiki manual: HTTPS — HTTPS와 proxy forwarding 설정입니다.
- MediaWiki manual: User rights — 브라우저 사용자, 제한된 MCP 계정, 관리자 권한을 나누는 기준입니다.
- MediaWiki manual: Bot passwords — 애플리케이션 자격 증명과 권한 제한 방식입니다. 현재는 MCP 전용 로컬 계정을 사용하며, 필요하면 나중에 BotPasswords로 바꿀 수 있습니다.
- Semantic MediaWiki installation guide — Composer 설치, 호환성, 저장소 설정과 확인 절차입니다.
- Semantic MediaWiki getting started guide — 의미 속성과 조회 문법입니다.
- Page Forms extension documentation — 양식으로 템플릿을 편집하고 Semantic MediaWiki와 연결하는 방법입니다.
- Page Forms download and installation — 설치와 Page Forms 전용 권한 설명입니다.
Docker와 MariaDB
- Docker Compose environment interpolation —
.env를 읽는 순서와--project-directory의 영향입니다. - Docker Compose service reference — 서비스 환경, health check, 의존성과 profile 문법입니다.
- Docker storage volumes — named volume의 저장 방식과 수명 주기입니다.
- MariaDB
mariadb-dump— 논리 DB 백업과 복원 가능한 출력 형식입니다.
공개 HTTPS
- Caddy automatic HTTPS — 공개 DNS와 80/443 요구 사항, HTTP 전환, 인증서 발급·갱신 방식입니다.
- Caddy reverse proxy quick start —
domainCompose profile에서 쓰는 주소와 upstream routing 방식입니다. - Caddy
reverse_proxydirective — Host 전달,X-Forwarded-Proto, streaming 동작입니다. - Official Caddy Docker image — 고정한 컨테이너 이미지와
/data,/config저장 경로입니다.
MCP 클라이언트
- OpenAI Apps SDK: Connect from ChatGPT — 개인 개발자 모드에서 중앙 HTTPS
/mcp를 plugin으로 등록하고 시험하는 현재 ChatGPT 웹 절차입니다. - OpenAI Apps SDK: Authentication — 사용자 데이터와 쓰기 도구가 있는 MCP에 필요한 OAuth 2.1, protected resource metadata, PKCE와 access-token 검증 요건입니다.
- OpenAI Help: Developer mode and MCP apps — Business·Enterprise/Edu workspace의
Create후 Draft 게시, 접근 범위와 action control 절차입니다. - OpenAI Codex: Custom instructions with
AGENTS.md— Codex가 저장소 지침을 찾고 적용하는 순서입니다. - OpenAI Codex: Model Context Protocol — Streamable HTTP URL,
bearer_token_env_var,.codex/config.toml, CLI 관리와 도구 승인 설정입니다. ChatGPT 웹은 로컬 Codex 설정을 읽지 않으므로 workspace 앱으로 연결해야 한다는 점도 확인했습니다. - OpenAI Codex: Configuration reference —
mcp_servers.*.url,bearer_token_env_var, 환경변수 기반 HTTP header, timeout, 승인 설정의 정확한 형식입니다. - Anthropic Claude Code: Project memory —
CLAUDE.md, 기존AGENTS.md불러오기와 프로젝트 지침 범위입니다. - Anthropic Claude Code: Connect to tools via MCP — 원격 HTTP 전송, Bearer header, claude.ai connector 동기화, 환경변수 치환, OAuth, 설정 범위와 진단 방식입니다.
- Anthropic: Custom connectors with remote MCP — Claude 웹·Desktop에서 원격 MCP를 추가하는 현재 메뉴, Free/Pro/Max와 Team/Enterprise의 설정 범위, 조직 권한과 OAuth 연결 절차입니다.
- Anthropic: Use Claude Code in VS Code — VS Code Claude 확장의
/mcp, remote server 관리와 CLI 설정 공유 방식입니다. - Anthropic Claude Code on the web — 커밋한
.mcp.json, 로컬 MCP 설정의 적용 범위, cloud network 정책과 secret 저장 제한입니다. - Anthropic Claude Code: Permissions — 도구 승인과 deny/ask/allow 우선순위, workspace trust 범위입니다.
- Cursor: Model Context Protocol — 사용자 전역
~/.cursor/mcp.json, remote Streamable HTTP, OAuth·header와${env:NAME}보간 형식입니다. - Cursor CLI parameters —
agent mcp list와agent mcp list-tools명령 형식입니다. - Cursor: MCP install links — secret을 넣지 않은
cursor://설치 링크의 공식 형식입니다. - Cursor: Plugins — Teams/Enterprise에서 중앙 MCP를 Team Marketplace에 배포하고
Default On또는Required로 지정하는 절차입니다. - Model Context Protocol: Transports — Streamable HTTP
/mcp, 여러 클라이언트의 동시 사용, Host/Origin 검사와 네트워크 배포 요구 사항입니다. - Model Context Protocol: Authorization — Bearer header, token 검증, OAuth, HTTPS와 token 유출 대책입니다.
공식 문서는 제품 업데이트에 따라 바뀔 수 있습니다. 실제 서버 버전은 저장소의 이미지 고정값, 테스트와 Special:Version에서 확인합니다.
한국어 문장 참고
README와 위키 문구는 사용자가 제공한 korean-humanizer 체크리스트를 기준으로 다듬었습니다. 아래 두 저장소는 과장된 요약, 번역투, 반복되는 결론 같은 AI 문체를 찾는 데 참고했으며 애플리케이션의 실행 의존성은 아닙니다.