Teamping은 개발자와 비개발자(AI빌더)가 역할별 언어로 협업하는 팀 컨텍스트 레이어입니다. 이 문서 하나면 당신의 AI(Claude Code · Cursor · Claude 데스크톱)를 팀 워크스페이스에 연결할 수 있어요.
연결되면 AI가 팀의 작업(매니페스트) · 회의 · 채팅 · 로드맵을 도구로 읽고 씁니다.
마이페이지 「셋업 키트 받기」로 받은 파일을 쓰는 AI(Claude Code · Codex)에게 주고 이렇게 말하세요:
teamping-setup.md 파일대로 팀핑 셋팅해 줘."열쇠(토큰)는 대화창에 붙여 넣지 마세요 — 대화 기록에 영원히 남습니다. 키트가 열쇠를 넣는 방법을 따로 안내해요.
키트를 받은 AI 는 단계마다 물어보며 설정을 대신 해 주고, 사람이 할 일(열쇠 발급 · 앱 다시 켜기 · 승인)은 그때그때 알려 줘요. 키트 없이 손으로 하실 때만 아래 Step 2를 따르세요 — 그때도 열쇠는 직접 넣고 AI 에게 말하지 마세요.
teamping_...)을 1회만 보여주니 복사 (창 닫으면 다시 못 봄)submit(작업 제출)·list(조회)뿐 — 완료 보고 확인·회사·팀원 관리 같은 위험 동작은 열쇠로 불가(사람이 웹에서만). 예외: 소유자·관리자의 submit 열쇠는 로드맵을 확정·거절(초안 삭제)하고 진행 상태·담당·커밋 연결을 바꿀 수 있습니다.방법 1 — 명령 한 줄 (프로젝트 폴더에서):
claude mcp add --transport http teamping https://teamping.dev/mcp \
--header "Authorization: Bearer teamping_YOUR_TOKEN"방법 2 — .mcp.json 파일 (프로젝트 루트에 생성/추가):
{
"mcpServers": {
"teamping": {
"type": "http",
"url": "https://teamping.dev/mcp",
"headers": {
"Authorization": "Bearer teamping_YOUR_TOKEN"
}
}
}
}열쇠 없이 로그인만으로 연결하려면 아래 「채팅 앱으로 연결하기」의 Claude 채팅 순서를 따르세요(데스크톱 앱도 같아요).
설정 파일에 아래를 추가합니다. 이미 다른 MCP가 있으면 mcpServers 안에 teamping만 넣으세요.
~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.jsonnode -v로 확인){
"mcpServers": {
"teamping": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://teamping.dev/mcp",
"--header",
"Authorization:${TEAMPING_AUTH}"
],
"env": {
"TEAMPING_AUTH": "Bearer teamping_YOUR_TOKEN"
}
}
}
}mcp-remote는 데스크톱 앱(로컬)과 우리 원격 서버(HTTP)를 잇는 작은 브릿지예요. 첫 실행 시 자동 설치됩니다. 토큰이 env에 들어 있는 것이 중요합니다 — --header "Authorization: Bearer 토큰"처럼 값을 직접 박으면 앱이 켜져 있는 내내 토큰이 프로세스 목록(ps)에 평문으로 뜹니다. 설정 파일 권한도 좁혀두세요: chmod 600. 참고로 위 A의 {"type":"http", ...} 형식은 Claude Code 전용이라 데스크톱 설정 파일에 넣으면 무시됩니다.Codex 는 열쇠를 복사하지 않아요. 아래 한 줄을 터미널에서 실행하면 브라우저가 열려요.
codex mcp add teamping --url https://teamping.dev/mcp브라우저에서 팀핑에 로그인하고, 프로젝트를 고른 뒤 「허용」을 누르세요. 그다음 Codex 를 새 세션으로 열면 붙어 있어요. 이미 추가해 둔 연결이 끊겼을 때만 codex mcp login teamping 을 실행하세요 — 새로 추가할 때 함께 하면 동의를 한 번 더 묻습니다.
Cursor 는 .mcp.json 을 읽지 않아요. 아래 내용을 Cursor 설정 파일에 넣으세요. 이미 다른 MCP 가 있으면 mcpServers 안에 teamping 만 넣으세요.
~/.cursor/mcp.json.cursor/mcp.json{
"mcpServers": {
"teamping": {
"url": "https://teamping.dev/mcp",
"headers": {
"Authorization": "Bearer teamping_YOUR_TOKEN"
}
}
}
}저장한 뒤 Cursor 를 다시 열고 채팅에 「팀핑 list_channels 불러 줘」라고 해 보세요. 채널 목록이 나오면 연결된 거예요.
자동 잠금 켜기 — 열쇠를 ~/.cursor/mcp.json 에 넣었다면 아래 명령을 한 번 실행하고 Cursor 를 다시 불러오세요(명령 팔레트 → Developer: Reload Window). macOS 와 Linux 에서 돼요.
d="$(mktemp -d)" && git clone --depth 1 https://github.com/serion-mark/teamping-plugin "$d/r" && mkdir -p ~/.cursor/plugins/local && rm -rf "$HOME/.cursor/plugins/local/.teamping-new" && cp -R "$d/r/cursor-plugin/teamping" "$HOME/.cursor/plugins/local/.teamping-new" && rm -rf ~/.cursor/plugins/local/teamping && mv "$HOME/.cursor/plugins/local/.teamping-new" ~/.cursor/plugins/local/teamping; rm -rf "$d"claude mcp list로 teamping 확인)그다음 AI에게: "teamping 도구 목록 보여줘" 또는 "내 할일 알려줘 (get_my_work)" → 아래 도구들이 뜨면 연결 성공
열쇠 없이 팀핑 로그인으로 연결해요. 두 앱 모두 서버 주소는 이것 하나예요.
https://teamping.dev/mcp| 도구 | 하는 일 |
|---|---|
submit_manifest | 방금 한 작업을 표준 보고서(매니페스트)로 채널에 제출 |
list_manifests · get_manifest | 채널의 작업 보고서 조회 (역할별 번역 뷰) |
get_my_work | 나에게 배정된 할일·완료대기 모아보기 |
propose_stage_change · propose_due_change | 작업 단계·마감 변경 제안 |
respond_to_manifest | 남의 작업에 질문·의견·변경요청 |
start_thread · post_thread_message · list_thread(_messages) | 브레인스토밍 회의(스레드) |
post_channel_message · list_channel_messages | 채널 상시 채팅 |
propose_milestones | 로드맵 Phase 초안 제안 (확정은 사람이 웹에서 — 또는 아래 도구로) |
update_roadmap_node | 로드맵 확정·거절·진행 상태·담당·커밋 연결 (소유자·관리자의 AI · 시킬 때 쓰도록 안내됨) |
Bearer 접두사) 확인node -v로 Node 설치 확인 (mcp-remote가 Node 필요)Teamping — 개발자와 AI빌더 사이의 벽을 없애는 양방향 의사소통 도구. 같은 GitHub 코드를 역할별 언어로 보고/고치면 AI가 번역, 승인은 사람이.