도움말:S3 연구 메모리/Windows 연결 문서 원본 보기

<!-- S3RM managed repository document; edit the Markdown source, not this page. -->
''이 페이지는 저장소 문서에서 자동으로 동기화됩니다. 위키에서 직접 편집하지 마세요.''

서버 담당자에게 공용 쓰기 토큰을 받은 뒤 진행합니다. 중앙 주소는 <code><nowiki>https://s3wiki.yonsei.ac.kr/mcp</nowiki></code> 하나만 사용합니다.

=== 1. 토큰 저장 ===

PowerShell 7에서 다음 블록 전체를 실행합니다.

<pre><nowiki>
$McpUrl = 'https://s3wiki.yonsei.ac.kr/mcp'
$SecureToken = Read-Host 'S3RM_MCP_TOKEN' -AsSecureString
$Token = [System.Net.NetworkCredential]::new('', $SecureToken).Password

[Environment]::SetEnvironmentVariable('S3RM_MCP_URL', $McpUrl, 'User')
[Environment]::SetEnvironmentVariable('S3RM_MCP_TOKEN', $Token, 'User')
$env:S3RM_MCP_URL = $McpUrl
$env:S3RM_MCP_TOKEN = $Token

Remove-Variable Token, SecureToken -ErrorAction SilentlyContinue
</nowiki></pre>

실행하면 <code><nowiki>S3RM_MCP_TOKEN:</nowiki></code>이 표시됩니다. 그 뒤에 전달받은 토큰을 붙여넣고 Enter를 누르세요. 입력 중에는 토큰이 화면에 보이지 않습니다.

현재 PowerShell에서 실행한 CLI는 바로 값을 읽습니다. ChatGPT desktop app의 Codex, VS Code의 Codex·Claude 확장과 Cursor는 완전히 종료한 뒤 다시 여세요. 그래도 적용되지 않으면 Windows에서 로그아웃했다가 다시 로그인합니다.

토큰을 확인한다며 화면에 출력하거나 프로젝트 설정과 Git에 복사하지 마세요. 사용자 환경변수는 개인 PC의 개인 Windows 계정에만 저장합니다.

=== 2. 에이전트에게 연결 맡기기 ===

같은 PowerShell에서 Codex, Claude Code 또는 Cursor CLI를 시작한 뒤 다음 문장을 붙여넣으세요.

<pre><nowiki>
현재 클라이언트를 연구실의 중앙 S3 Research Memory MCP에 쓰기 가능하게 연결해 줘.

반드시 지킬 조건:
- 중앙 주소는 https://s3wiki.yonsei.ac.kr/mcp 하나만 사용한다.
- S3RM_MCP_TOKEN을 값으로 출력하지 말고 Bearer header에 사용한다.
- 로컬 MCP 서버, stdio 프로세스, Docker, 별도 위키나 DB를 만들거나 시작하지 않는다.
- localhost, 127.0.0.1, SSH tunnel, generic MediaWiki api.php를 등록하지 않는다.
- 현재 클라이언트의 공식 원격 Streamable HTTP 설정을 사용한다.
- 기존 MCP 설정을 먼저 읽고 다른 항목을 지우지 않은 채 안전하게 병합한다.
- Codex에서만 해당 서버 블록에 default_tools_approval_mode = "auto"를 넣는다.
- 토큰을 답변, 프로젝트 파일 또는 Git에 남기지 않는다.
- 재시작이 필요하면 정확히 어떤 앱이나 확장을 재시작할지 알려 준다.
- 재시작 뒤 MCP 도구 7개와 search_lessons(limit=1)를 확인하는 방법을 남긴다.

먼저 Windows와 현재 클라이언트, 기존 설정을 확인한 뒤 직접 설정하고 검증해 줘.
실제 메모를 생성하는 쓰기 시험은 하지 마.
</nowiki></pre>

=== 3. 직접 연결 ===

==== Codex ====

<pre><nowiki>
codex mcp add s3-research-memory `
  --url https://s3wiki.yonsei.ac.kr/mcp `
  --bearer-token-env-var S3RM_MCP_TOKEN
codex mcp list
</nowiki></pre>

사용자 Codex <code><nowiki>config.toml</nowiki></code>의 생성된 서버 블록에 다음 줄을 병합합니다.

<pre><nowiki>
default_tools_approval_mode = "auto"
</nowiki></pre>

ChatGPT desktop app의 Codex, Codex CLI와 VS Code Codex 확장은 같은 설정을 공유합니다.

==== Claude Code ====

<pre><nowiki>
claude mcp add --transport http --scope user `
  s3-research-memory https://s3wiki.yonsei.ac.kr/mcp `
  --header 'Authorization: Bearer ${S3RM_MCP_TOKEN}'
claude mcp get s3-research-memory
</nowiki></pre>

VS Code Claude 확장도 같은 Claude Code 설정을 사용합니다.

==== Cursor ====

Cursor 사용자 전역 MCP 설정에 다음 내용을 병합합니다.

<pre><nowiki>
{
  "mcpServers": {
    "s3-research-memory": {
      "url": "https://s3wiki.yonsei.ac.kr/mcp",
      "headers": {
        "Authorization": "Bearer ${env:S3RM_MCP_TOKEN}"
      }
    }
  }
}
</nowiki></pre>

Cursor를 완전히 다시 시작한 뒤 <code><nowiki>Customize → MCP</nowiki></code>에서 확인합니다. Cursor CLI에서는 다음 명령으로 확인합니다.

<pre><nowiki>
agent mcp list
agent mcp list-tools s3-research-memory
</nowiki></pre>

=== 4. 연결 확인 ===

새 대화에 다음 요청을 붙여넣으세요.

<pre><nowiki>
S3 Research Memory의 search_lessons를 빈 검색어와 limit=1로 실행해 줘.
id, title, confidence만 반환하고, 메모가 아직 없어도 새로 만들지는 마.
</nowiki></pre>

정상이면 읽기 도구 네 개와 쓰기 도구 세 개, 모두 일곱 개가 표시됩니다.