Galpi

환경 변수와 API

자주 쓰는 환경 변수와 그 기본값, API 토큰, 스크립트와 AI 에이전트에서 갈피를 부르는 API와 MCP예요.

환경 변수

환경 변수는 처음 값이에요. 시스템 관리 → 설정에서 저장한 값이 환경 변수보다 먼저예요. 전체 목록은 갈피 저장소의 .env.example(Docker 없이 띄울 때)과 deploy/.env.example(Compose)에 있어요. 아래 기본값은 apps/server/src/config.ts의 값이에요.

서버

이름 기본값 뜻
PORT 8080 듣는 포트
PUBLIC_URL http://localhost:5173 사람들이 여는 주소. 메일의 링크도 이 주소예요
DATA_DIR ./data (이미지는 /data) DB, 설정, 받은 저장소의 미러
SECRETS_KEY (필수) 저장하는 비밀값을 봉인하는 키. openssl rand -base64 32
DATABASE_URL (없음 = SQLite) PostgreSQL 주소
ADMIN_EMAILS 시작할 때 시스템 관리자가 되는 사람(쉼표로 여러 개)
APP_LANG 기본 언어 ko 또는 en(예전 GALPI_LANG)
VM_PROVIDER none sprites, e2b, sysbox, local, none
VM_CALLBACK_URL (PUBLIC_URL) VM이 갈피를 부를 주소. 노드면 node
SPRITES_PREFIX galpi-dev- Sprites VM 이름 앞부분
SSH_GATEWAY_PORT 2222 VS Code 데스크톱의 SSH 게이트웨이
OFFLINE 1이면 폐쇄망 모드
MIRRORS 사내 미러(from=to 쌍)
NET_ALLOW_HOSTS 사용자가 넣은 주소 가운데 사설망이어도 허용할 호스트
GALPI_TRUSTED_PROXIES 믿는 공인 주소의 프록시(주소나 네트워크, 쉼표로). 루프백과 사설 주소는 늘 믿어요
GALPI_MAX_UNAUTHENTICATED_PER_ADDRESS 64 믿지 않는 공인 주소 하나가 쥘 수 있는 로그인 전 연결
GALPI_MAX_CONNECTIONS_PER_ADDRESS (제한 없음) 주소 하나의 연결(믿는 프록시 뒤면 클라이언트마다 진행 중인 요청) 수

로그인과 메일

이름 기본값 뜻
LOGIN_METHODS email email, oidc, email,oidc
OIDC_ISSUER, OIDC_CLIENT_ID, OIDC_CLIENT_SECRET 사내 계정(SSO)
SIGNUP_DOMAINS 가입할 수 있는 이메일 도메인. 밖의 주소는 게스트예요
SMTP_URL, MAIL_FROM 메일 서버와 보내는 사람. 없으면 메일은 서버 로그에
LOCAL_LOGIN_CODE VM_PROVIDER=local에서만: 모든 로그인 코드를 이 6자리로

모델

이름 기본값 뜻
LLM_API_FORMAT anthropic anthropic 또는 openai(OpenAI 호환)
LLM_BASE_URL https://api.anthropic.com/v1 모델 서버 주소
LLM_API_KEY 모델 서버 키. VM에는 가지 않아요
LLM_MODEL claude-sonnet-5-5 MODE_*가 없을 때 하나뿐인 모드의 모델
MODE_FAST_MODEL, MODE_SMART_MODEL, MODE_DEEP_MODEL 등급마다의 모델. 하나라도 있으면 그 등급(Fast·Smart·Deep)을 고를 수 있어요
AGENT_PROMPT, AGENT_PROMPT_FILE 모든 채팅에 붙는 에이전트 지침

채팅과 보관

이름 기본값 뜻
CHAT_RETENTION_DAYS 7 쓰지 않은 채팅의 작업 공간을 보관(S3 없으면 삭제)하기까지
ARCHIVE_RETENTION_DAYS (끝없음) 보관한 채팅을 지우기까지
DELETED_CHAT_RETENTION_DAYS (끝없음) 지운 채팅을 영영 지우기까지
LOST_ACCESS_RETENTION_DAYS 30 주인이 접근을 잃은 채팅을 남겨 두는 기간
RETAINED_DELETION_DAYS 7 보관소에서 지운 것을 남겨 두는 기간. 0이면 바로 지워요. 설정 화면에서도 바꿔요 (운영)
RETAINED_DELETION_MAX_GB 100 남겨 둔 것 전체의 한도. 넘으면 오래된 것부터 일찍 지워요. 0이면 한도 없음
S3_BUCKET, S3_ENDPOINT, S3_REGION, S3_ACCESS_KEY_ID, S3_SECRET_ACCESS_KEY 파일 보관소. 없으면 DATA_DIR에 두고 보관 대신 지워요
S3_DIRECT auto 노드의 VM이 S3로 바로 올릴지(auto, on, off)

제품군

이름 뜻
MOTHERSHIP_URL 제품군의 Mothership. 프로젝트의 연동 서비스에 Mothership이 나타나요
NARU_URL 제품군의 나루. 시작할 때 연동 서비스로 올려요

API 토큰

내 설정 → API 토큰에서 이름과 기간(30일, 90일, 1년, 기한 없음)을 정하고 만들어요. 토큰(galpi_…)은 만든 그때 한 번만 보이고, 갈피는 해시만 저장해요. 한 사람당 20개까지예요. 토큰은 만든 사람으로 동작하고 그 사람이 할 수 있는 일만 해요. 시스템 관리(/api/admin/*), 설치, 로그인, 토큰 관리는 브라우저에서만 돼요.

내 설정. API 토큰과 VS Code 확장, ChatGPT 연결이 여기에 있어요.내 설정. API 토큰과 VS Code 확장, ChatGPT 연결이 여기에 있어요.
내 설정. API 토큰과 VS Code 확장, ChatGPT 연결이 여기에 있어요.

API

요청마다 Authorization: Bearer <토큰>을 붙여요. 앱 화면이 쓰는 API(/api/...)를 그대로 써요.

bash
curl -H "Authorization: Bearer $GALPI_TOKEN" https://galpi.example.com/api/projects
# 새 채팅(프로젝트 없이: "projectId": null), 그다음 질문하기
curl -H "Authorization: Bearer $GALPI_TOKEN" -H 'content-type: application/json' \
  -d '{"projectId":"p_…"}' https://galpi.example.com/api/chats
curl -H "Authorization: Bearer $GALPI_TOKEN" -H 'content-type: application/json' \
  -d '{"question":"README를 요약해 줘"}' https://galpi.example.com/api/chats/<채팅 id>/messages
하는 일 요청
나 GET /api/me
내 채팅 GET /api/chats?limit=30(&project=<id>, &project=none, &q=…) → { items, nextCursor }
새 채팅 POST /api/chats { "projectId": "…", "repositoryIds": [...] }
질문하기 POST /api/chats/<채팅 id>/messages { "question": "…" }
채팅 읽기 GET /api/chats/<채팅 id>
저장소 업데이트 POST /api/chats/<채팅 id>/repositories/<채팅 저장소 id>/sync
저장소 연결 POST /api/projects/<id>/repositories { "url": "…", "credential": "…" }
push 규칙 PUT /api/projects/<id>/repositories/<저장소 id>/push { "enabled": true, "branches": ["galpi/{person}/*"] }

전체 목록은 갈피 저장소의 docs/api.md에 있어요.

MCP

주소는 https://<갈피 주소>/mcp예요(Streamable HTTP). 같은 토큰으로 들어와요.

bash
claude mcp add --transport http galpi https://galpi.example.com/mcp --header "Authorization: Bearer galpi_…"
도구 하는 일
whoami 토큰의 주인
list_projects, list_project_repositories 쓸 수 있는 프로젝트와 그 저장소
list_chats, get_chat 내 채팅과 그 질문·답·상태
start_chat, ask 새 채팅(첫 질문까지), 채팅에 질문하기
list_skills, get_skill, create_skill, publish_skill_version 스킬 저장소
list_project_skills, enable_project_skill, disable_project_skill 프로젝트의 스킬
list_my_skills, enable_my_skill, disable_my_skill 내 스킬
list_secrets, set_secret, delete_secret 내 연결 키(값은 돌려주지 않아요)
Esc