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
요청마다 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 |
내 연결 키(값은 돌려주지 않아요) |