콘텐츠로 이동
ThegramDocs

코딩 에이전트 연결

자동 복사가 허용되지 않았습니다. 내용을 선택해 직접 복사하세요.

1. 사용할 도구 선택과 설치

Node.js 22+가 필요합니다. 사용할 도구 하나의 명령만 실행하세요. 설치는 계정 연결이나 프로젝트 생성을 하지 않습니다.

코딩 에이전트

Claude Code

claude mcp remove --scope user thegram >/dev/null 2>&1 || true
claude plugin marketplace add thegram-one/thegram-mcp || claude plugin marketplace update thegram-memory
claude plugin install thegram-memory@thegram-memory
claude plugin update thegram-memory@thegram-memory || true

Codex

codex mcp remove thegram >/dev/null 2>&1 || true
codex plugin remove thegram@thegram-local >/dev/null 2>&1 || true
codex features enable hooks
codex plugin marketplace add thegram-one/thegram-mcp || codex plugin marketplace upgrade
codex plugin add thegram-memory@thegram-memory

다음 Codex 실행에서 plugin hooks 신뢰 여부를 물을 수 있습니다. 목적과 권한을 검토한 뒤 직접 결정하세요.

OpenCode

opencode plugin add github:thegram-one/thegram-mcp

OpenCode v1은 사용자 설정의 plugin 배열에 github:thegram-one/thegram-mcp를 추가하세요.

OMP

omp plugin marketplace add thegram-one/thegram-mcp || true
omp plugin install thegram-memory@thegram-memory
omp plugin marketplace update thegram-memory
omp plugin upgrade thegram-memory@thegram-memory --scope user

공식 설치 가이드에서 생성한 명령입니다. 정본과 변경 사항 확인

연결 전 확인

섹션 제목: “연결 전 확인”

Node.js 22+와 최신 coding plugin을 사용하세요. 위에서 선택한 도구의 명령만 실행합니다. 실행 중인 Mac 앱·DMG·로컬 socket은 필요하지 않습니다. 설치만으로 계정 권한이나 프로젝트가 만들어지지 않습니다.

2. API key를 비공개로 연결

섹션 제목: “2. API key를 비공개로 연결”
  1. Thegram에서 Settings → Agents → API keys를 엽니다.
  2. key 이름, 필요한 Vault·권한과 만료일을 검토합니다. Drive는 별도 연결과 권한이 필요합니다.
  3. 한 번만 표시되는 secret을 복사합니다. 채팅·저장소·명령 인자·shell history에는 넣지 마세요.
  4. 에이전트에게 설치된 plugin 경로를 찾게 하고, 본인의 터미널에서 <installed-plugin>을 실제 경로로 바꿔 실행합니다.
터미널 창
node <installed-plugin>/dist/thegram-memory.mjs connect
node <installed-plugin>/dist/thegram-memory.mjs doctor

숨김 prompt에 key를 입력합니다. POSIX에서는 설정 디렉터리 0700, credential 파일 0600으로 저장됩니다. connect는 Vault나 문서 대상을 선택·저장하지 않습니다.

정상 결과: doctor가 Cloud endpoint와 정확한 기존 repository project 문서를 보여줍니다. nonzero exit라면 연결·권한·association 원인을 먼저 해결하세요.

3. 기존 프로젝트 연결

섹션 제목: “3. 기존 프로젝트 연결”

설치 뒤 새 agent 세션을 시작하세요. adapter는 허용된 Vault 문서에서 정확한 repo:<host>/<repository-path> tag를 가진 기존 project record를 검색합니다. 같은 origin의 worktree는 identity를 공유합니다. 고정 경로, 선택한 Vault, projects.json은 저장 대상을 결정하지 않습니다.

기존 문서에 tag만 없다면 정확한 문서와 변경을 검토·승인한 뒤 한 번 연결합니다.

터미널 창
node <installed-plugin>/dist/thegram-memory.mjs bind --document @mounts/<vault-id>/<document>.gram [--project <id>]

bind는 해당 기존 문서의 쓰기 권한이 필요합니다. project record가 여러 개라면 --project를 지정하세요. 알려진 non-Git identity에는 공개 CLI의 --repository <host>/<repository-path>를 명시할 수 있지만 값을 추측하면 안 됩니다. 연결 뒤 host 세션을 다시 시작하세요.

association 없음·중복은 중단 상태입니다. 자동으로 대체 문서를 만들지 않습니다. 프로젝트가 아예 없다면 목적과 저장 대상을 먼저 승인하고 별도로 생성하세요.

4. 읽기 전용 확인

섹션 제목: “4. 읽기 전용 확인”
이 프로젝트에 대해 Thegram이 기억하는 내용을 기존 문서에서 읽고 출처를 알려줘. 레코드를 생성하거나 바꾸지 마. repository association이 없거나 중복이면 다른 문서를 고르지 말고 정확한 문제를 설명해줘.

정상 결과: 의도한 기존 프로젝트를 읽거나, 해결할 association을 명확히 설명합니다. read-only key로 문서를 초기화하면 안 됩니다.

업데이트와 연결 해제

섹션 제목: “업데이트와 연결 해제”

OMP는 위의 전체 marketplace ID를 사용합니다. bare thegram-memory는 upgrade 대상이 아닙니다. 업데이트 후 새 세션을 시작하세요.

CLI disconnect는 로컬 credential만 지웁니다. 서버 접근을 중단하려면 Thegram에서 key를 revoke합니다. 권한 · 오류별 해결.

이 안내의 출처

안내와 다른 점이 있나요? 문서 오류 신고 · 문제 해결
이메일은 직접 검토해 전송하세요. API key나 비공개 문서 내용은 보내지 마세요.