3.9 KiB
3.9 KiB
title, updated, tags
| title | updated | tags | |||
|---|---|---|---|---|---|
| Claude Code 설정 및 인스트럭션 | 2026-07-28 |
|
기본 설정
- 모르거나 애매한 경우 항상 최신 문서를 찾아 참고할 것
- incus remote로 jp1 / kr1 / kr2 / hp2 의 api를 이용중이고 project를 사용중
- docker와 ghcr 리모트가 이미 등록되어 있어 OCI 사용 가능
터미널 환경
- Fish shell (명령어 문법 주의)
- ssh=tssh alias
- 플랫폼: Linux (Debian 13)
MCP 설정
설정 파일 위치
- 글로벌 설정:
~/.claude.json→projects.{프로젝트경로}.mcpServers섹션 - 프로젝트 공유 설정: 프로젝트 루트의
.mcp.json - 사용자 설정:
~/.claude/settings.json - CLI 확인:
claude mcp list,claude mcp get <서버이름>
등록된 MCP 서버 (2026-03-25 기준)
| 서버 | 타입 | 엔드포인트 | 용도 |
|---|---|---|---|
| incus | npx | @ironclads/incus-mcp@latest |
Incus 인스턴스 관리 |
| kubernetes | npx | mcp-server-kubernetes |
K8s 클러스터 관리 |
| nocodb | mcp-remote | nocodb.inouter.com/mcp |
NocoDB 데이터베이스 |
| bunnycdn | HTTP | bunnycdn-mcp.inouter.com/mcp |
BunnyCDN 관리 |
| aws-core | uvx | awslabs.core-mcp-server@latest |
AWS 리소스 관리 |
| context7 | npx | @upstash/context7-mcp |
라이브러리 문서 검색 |
| Google Calendar | claude.ai | gcal.mcp.claude.com |
구글 캘린더 |
| Gmail | claude.ai | gmail.mcp.claude.com |
지메일 |
| Cloudflare | claude.ai | bindings.mcp.cloudflare.com |
Cloudflare 플랫폼 |
Vault MCP 상세
- 위치: jp1 Incus default 프로젝트 vault 컨테이너
- vault-mcp-server v0.2.0 (Go, systemd, port 8080)
- 엔드포인트:
http://10.253.101.58:8080/mcp - 마운트된 엔진:
secret/(KV),ssh-client-signer/(SSH) - 주요 용도: 시크릿 관리, PKI 인증서 발급, SSH 서명
MCP 2026-07-28 신규 스펙(stateless 전환) 검토
자체 운영 서버(incus-mcp, bunnycdn-mcp, vault-mcp-server) 영향 평가 완료 — 스펙 아직 RC 단계(정식 전환 미확인), SDK도 베타 상태라 즉시 업그레이드 불필요. 상세: ../history/2026-07-28-mcp-2026-spec-review
장기기억
Obsidian 단일 구조화 지식 정본 체계. 과거 OpenMemory(Mem0) 시멘틱 검색 계층을 병행했으나 2026-07-27 서비스 자체 폐기 — ../history/2026-07-27-openmemory-decommission
Obsidian (구조화된 지식)
Gitea 저장소: gitea.inouter.com/kaffa/obsidian
Vault 구조:
infra/— 인프라 설정, 네트워크, 서비스 운영 정보products/— 제품 기획, 요금, 법률/세무services/— 외부 서비스 연동 (gitea, twilio, aws-ses)openclaw/— OpenClaw 에이전트 시스템dev/— 개발 환경, 도구 설정
저장 대상: 인프라 변경, 서비스 설정, 운영 절차, 제품 기획, 트러블슈팅 솔루션
작성 규칙:
- frontmatter:
title,updated(YYYY-MM-DD),tags - 위키링크
[[파일명]],##섹션 헤더 - git workflow:
pull --rebase→add→commit→push - conflict 시 자동 해결 금지
읽기 우선순위
- Obsidian — 인프라/서비스/제품 정보 (구조화된 정본)
- HashiCorp Vault — 시크릿, 인증 정보
세션 시작 시
~/obsidiangit pull --rebase로 최신화- 없으면 [vault]에서 토큰 읽어 clone
기억 저장 시점
- 중요한 작업 완료 후 (설정 변경, 트러블슈팅 해결 등)
- 새로운 인프라/서비스 정보를 알게 되었을 때
- 사용자가 "기억해" 요청 시
- 기존 정보 변경 시 (IP, 포트, 설정값 등)
주의사항
- 로컬 명령은 항상 로컬 머신에서 실행 — 명시적 요청 없으면 원격 실행 금지
- 인프라 상태 확인 시 K8s + Incus 양쪽 모두 확인
- 서비스 위치, Incus 프로젝트, 상세 설정은 infra-hosts 참조