당신의 AI를 팀에 붙이기 (MCP)

Teamping은 개발자와 비개발자(AI빌더)가 역할별 언어로 협업하는 팀 컨텍스트 레이어입니다. 이 문서 하나면 당신의 AI(Claude Code · Cursor · Claude 데스크톱)를 팀 워크스페이스에 연결할 수 있어요.

연결되면 AI가 팀의 작업(매니페스트) · 회의 · 채팅 · 로드맵을 도구로 읽고 씁니다.

로그인하고 토큰 발급 → 회원가입

AI에게 맡기려면 (제일 쉬움)

이 페이지를 당신의 Claude에게 주고 이렇게 말하세요:

"이 teamping.dev/connect 가이드대로 Teamping MCP에 연결해줘. 내 토큰은 아래에서 발급받은 값이야."

Claude가 아래 Step 2의 명령/설정을 대신 실행해 줍니다. (토큰만 당신이 발급해 알려주면 끝)

Step 1 — 토큰 발급 (30초)

teamping.dev 로그인 (팀에서 초대받은 이메일)
마이페이지 → AI 연결하기 → "새 토큰 발급"
뜨는 평문 토큰(teamping_...)을 1회만 보여주니 복사 (창 닫으면 다시 못 봄)

토큰 = 당신의 열쇠. 남에게 주지 마세요. 유출되면 마이페이지에서 폐기 후 재발급. 권한은 submit(작업 제출)·list(조회)뿐 — 작업 승인·회사·팀원 관리 같은 위험 동작은 토큰으로 불가(사람이 웹에서만). 예외: 소유자·관리자의 submit 토큰은 로드맵을 확정·거절(초안 삭제)하고 진행 상태·담당·커밋 연결을 바꿀 수 있습니다.

Step 2 — 연결

A. Claude Code (CLI) 또는 Cursor·VSCode 확장 ← 개발자 추천

방법 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"
      }
    }
  }
}

B. Claude 데스크톱 앱 (Mac / Windows)

설정 파일에 아래를 추가합니다. 이미 다른 MCP가 있으면 mcpServers 안에 teamping만 넣으세요.

파일 위치 — Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
필요: Node.js 설치 (node -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 전용이라 데스크톱 설정 파일에 넣으면 무시됩니다.

Step 3 — 확인

Claude 데스크톱: 앱을 완전 종료(⌘Q) 후 재시작
Claude Code: 세션 재시작 (또는 claude mcp list로 teamping 확인)

그다음 AI에게: "teamping 도구 목록 보여줘" 또는 "내 할일 알려줘 (get_my_work)" → 아래 도구들이 뜨면 연결 성공

무엇을 할 수 있나 (도구)

도구	하는 일
`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 · 시킬 때 쓰도록 안내됨)

작업 승인은 사람이 웹에서. 작업 승인 도구는 아예 존재하지 않습니다(설계 불변식). 로드맵만은 소유자·관리자가 시키면 그 AI 가 바꿀 수 있고(도구 안내로 지키는 약속이라, 시키는 사람을 서버가 가려내지는 못합니다), 그 밖의 팀 상태는 AI가 오염돼도 함부로 못 바꿉니다.

문제 해결

도구가 안 떠요 → 앱을 완전 종료 후 재시작했는지 / 토큰이 정확한지(앞뒤 공백·Bearer 접두사) 확인
401·403 / 인증 실패 → 토큰 만료·폐기됨. 마이페이지에서 재발급
데스크톱에서 안 돼요 → node -v로 Node 설치 확인 (mcp-remote가 Node 필요)

Teamping — 개발자와 AI빌더 사이의 벽을 없애는 양방향 의사소통 도구. 같은 GitHub 코드를 역할별 언어로 보고/고치면 AI가 번역, 승인은 사람이.