Claude Code 작업 보드: MCP로 정말 2분이면 끝나는 설정

Claude Code에 작업 보드를 주려면 명령 하나, claude mcp add --transport http weft https://letsweft.com/api/mcp 를 실행하고, Claude Code가 처음 연결할 때 브라우저에서 Weft에 로그인하면 됩니다. 복사할 키도, 설정 파일에 붙여 넣을 것도 없습니다. 그다음 CLAUDE.md에 짧은 블록을 넣으면, Claude Code가 코드를 고치기 전에 작업을 맡고, 일하는 동안 보고하고, 끝나면 영수증을 남깁니다.

Weft는 우리가 만듭니다. 다른 제품에 대한 사실은 2026년 10월 27일에 확인한 공식 페이지에서 가져왔습니다.

터미널에는 없고 보드가 Claude Code에 주는 것은?

Claude Code는 눈앞의 저장소는 알지만, 누가 또 일하고 있는지, 중간에 죽은 세션이 어떤 작업을 시작했는지는 모릅니다. 보드는 그 상태를 어떤 세션에도 속하지 않는 곳에 보관하므로, 사람과 두 번째 Claude Code 창과 ChatGPT 채팅이 같은 것을 봅니다.

모든 저장소에 필요한 것은 아닙니다. 한 사람, 짧은 세션 하나, TODO 목록이면 충분한 경우가 많습니다. 보드는 일이 여러 세션이나 여러 에이전트에 걸치거나, 사람이 결과를 봐야 인정되는 경우에 값을 하기 시작합니다.

Claude Code를 2분 안에 Weft에 연결하려면?

1. letsweft.com에서 무료 계정을 만드세요. 새 보드는 Backlog, Todo, Doing, Done 네 컬럼으로 시작합니다.
2. 터미널에서 claude mcp add --transport http weft https://letsweft.com/api/mcp를 실행하세요. Claude Code는 서버를 현재 프로젝트에 저장합니다. 모든 프로젝트에서 쓰고 싶다면 --scope user를 붙이세요(Anthropic의 Claude Code MCP 문서 참고).
3. claude를 시작하세요. Weft를 처음 쓸 때 OAuth용 브라우저 창이 열립니다. 열리지 않으면 /mcp를 입력하고 weft를 골라 거기서 인증하세요.
4. Weft 동의 화면에서 이 연결이 할 수 있는 일을 고르세요. full, write(파괴적 도구 세 개를 뺀 전부), read. 나중에 설정 → 연결된 AI 클라이언트에서 바꿀 수 있습니다.
5. Claude Code로 돌아와 이렇게 물어보세요. "내 보드에 뭐가 있어?"

이 엔드포인트는 Streamable HTTP로 MCP를 말하고 도구 32개를 공개합니다. Weft는 리프레시 토큰을 발급하므로 클라이언트가 스스로 로그인을 갱신합니다. OAuth를 못 하는 클라이언트라면 개인 액세스 토큰도 쓸 수 있지만, Claude Code에는 필요 없습니다. 전체 설정 페이지는 letsweft.com/ko/claude-code에 있습니다.

아무것도 바꾸지 않고 동작하는지 확인하려면?

첫 프롬프트를 읽기 전용으로 하세요. 도구가 로드되었고 로그인이 올바른 워크스페이스에 닿았는지 알 수 있고, 보드 위에서는 아무것도 움직이지 않습니다.

내 Weft 보드를 보여 줘: 컬럼, Doing에 있는 것, 나를 기다리는 것.
아무것도 바꾸지 마.

Claude Code는 get_board_state나 get_my_work를 호출해야 합니다. 둘 다 읽기 전용 도구입니다. 익숙해질 때까지 안전 여유를 두고 싶다면 동의 화면에서 연결을 read로 정하세요. 그러면 쓰기 호출은 거절되고, 거절된 호출은 월 할당량에 포함되지 않습니다.

솔직한 비용 하나: 도구 정의 32개가 Claude Code 컨텍스트에서 약 18,000 토큰을 차지합니다.

작업 하나를 맡으면 어떤 모습일까?

작지만 실제인 작업, 예를 들어 "불안정한 날짜 테스트 고치기"를 Todo에 넣고 Claude Code에게 맡아 달라고 하세요. 잘 돌아가면 이렇게 진행됩니다.

1. get_my_work는 이 클라이언트가 이미 가진 것, 당신을 기다리는 것, 무언가를 새로 시작할 여유가 있는지를 돌려줍니다.
2. start_task는 작업을 맡아 Doing으로 옮기고 runId와 leaseToken을 돌려줍니다. 응답은 에이전트에게 300초마다 갱신하라고도 알려 줍니다.
3. Claude Code는 평소처럼 저장소에서 일합니다. 몇 분마다 report_progress를 호출해 리스를 갱신합니다.
4. 당신만 내릴 수 있는 결정에 부딪히면 선택지와 함께 request_input을 호출합니다. Claude Code는 질문을 자체 선택지 카드로 보여 주고, 답은 submit_answer로 돌아갑니다.
5. complete_task는 결과, 커밋 해시와 테스트 출력 같은 산출물, 하지 않은 일과 함께 실행을 닫습니다.

기본적으로 완료된 작업은 곧바로 Done으로 갑니다. 작업에 검토가 필요하거나 검증 확인이 실패하면 대신 받은편지함에 멈춥니다. 거기서 수락, 재작업, 나중에, 폐기 중에서 고릅니다. 에이전트가 "PR #12 병합" 같은 nextStep을 넘겼다면, 수락은 정확히 그 단계를 승인하고, 그 단계는 실행하도록 에이전트에게 돌아갑니다.

모든 거절과 필드를 포함한 전체 루프는 작업 맡기 루프 가이드에 있습니다.

CLAUDE.md에는 무엇을 넣어야 할까?

도구 설명에 이미 이 규칙들이 들어 있습니다. CLAUDE.md에 몇 줄을 넣으면 그것이 저장소의 습관이 됩니다. 붙여 넣고 고쳐 쓰세요.

## Weft 작업 보드

Weft(MCP 서버 "weft")는 이 저장소의 공유 보드다. 다른 AI 클라이언트와
사람들도 읽으므로 항상 사실대로 유지한다.

- 세션을 시작하면 get_my_work를 호출한다. 그것이 돌려준 일을 하고,
  기억에 의존해 작업을 고르지 않는다.
- 작업을 위해 파일을 바꾸기 전에 그 id로 start_task를 호출한다.
  돌려받은 runId와 leaseToken을 보관한다.
  - already_claimed: 다른 누군가가 맡고 있다. 중복하지 말고 다른 것을 고른다.
  - attention_queue_full: 재시도하지 않는다. 응답이 제안하는 일을 한다
    (기존 작업을 끝내거나 명확히 한다).
- 일하는 동안 약 5분마다, 그리고 실제 체크포인트(테스트 통과, PR 생성)마다
  runId와 leaseToken으로 report_progress를 호출한다.
- request_input은 사람이 내려야 하는 결정에만 쓴다: 되돌릴 수 없는 일
  (프로덕션, 돈, 게시, 데이터 삭제) 또는 합리적인 기본값이 없는 진짜 갈림길.
  선택지를 준다. 계속해도 되는지 허락을 구하지 않는다.
- 끝나면 다음과 함께 complete_task를 호출한다:
  - outcome: 무엇이 바뀌었는지 한두 문장
  - artifacts: 커밋 해시, PR URL, 테스트 명령과 그 결과
  - notDone: 건너뛰었거나 나중으로 미룬 것
  - unknowns: 검증하지 못한 것
  - nextStep: 사람이 수락하면 할 다음 한 단계
- 끝내지 못하고 멈추면 그렇다고 말하고 작업을 Doing에 둔다.

산출물은 "완료"를 확인할 수 있는 것으로 바꿉니다. 증거가 없다고 호출이 실패하지는 않습니다. 끝낸 일을 잃는 것이 검증되지 않은 채로 기록하는 것보다 나쁘기 때문입니다.

작업 도중 Claude Code 세션이 죽으면 어떻게 될까?

뒤처리를 할 필요가 없습니다. 맡기는 플래그가 아니라 리스입니다. start_task가 20분을 주고, report_progress가 호출될 때마다 갱신합니다. 멈추거나, 네트워크가 끊기거나, 닫힌 세션은 보고할 수 없으므로, 침묵이 곧 신호입니다.

• 하트비트 없이 20분이 지나면 실행이 stale로 표시되고, 리스 토큰이 지워지고, 작업이 미배정으로 돌아갑니다.
• 정리 작업이 10분마다 돌고, 다른 클라이언트가 그 작업을 맡으려 하면 즉시 풀리기도 합니다.
• 당신의 답을 기다리는 실행은 60분 동안 맡은 상태를 유지합니다. 그 뒤에는 리스가 풀리지만 질문은 받은편지함에 열린 채로 남습니다.
• 맡기는 데이터베이스가 결정하므로, 같은 작업을 두고 경쟁하는 두 Claude Code 창이 둘 다 이길 수는 없습니다. 진 쪽은 작업의 id와 제목이 담긴 already_claimed를 받습니다.

여러 에이전트를 동시에 돌리는 방법은 한 보드 위의 여러 AI 에이전트에서 다룹니다.

ChatGPT나 휴대폰에서도 같은 보드를 볼 수 있을까?

네. 하나의 엔드포인트 뒤에 있는 하나의 보드입니다. Weft는 무료를 포함한 모든 요금제의 ChatGPT에 게시된 앱이므로(설정), Claude Code가 밤사이 무엇을 끝냈는지 ChatGPT에게 물어볼 수 있습니다. Cursor는 클릭 한 번으로 설치되고(설정), Codex는 설정 항목 하나와 codex mcp login weft를 씁니다(설정). claude.ai와 Claude Desktop에서는 Weft를 커스텀 커넥터로 추가합니다.

Weft에는 iOS와 Android 앱도 있습니다. 작업이 당신의 대기열에 들어오면 휴대폰에 푸시가 옵니다. 워크스페이스당 10분에 최대 한 번이므로, Claude Code의 질문이 책상을 떠나 있어도 당신에게 닿습니다. OAuth 클라이언트는 각각 별도의 행위자이고, 보드에는 그 클라이언트가 등록한 이름이 표시됩니다.

에이전트가 한 일을 되짚어 읽는 방법은 내 AI 에이전트는 무엇을 했을까?를 보세요.

무엇이 잘못될 수 있고, 어떻게 고칠까?

로그인되지 않음

Claude Code가 weft에 인증이 필요하다고 알리면 /mcp를 입력하고 weft를 골라 인증하세요. Weft의 설정 → 연결된 AI 클라이언트에서 클라이언트 연결을 끊었다면, 예전 토큰은 다음 호출에서 거절되므로 같은 방법으로 다시 로그인하세요.

Weft 도구가 목록에 없음

claude mcp list를 실행해 weft가 URL https://letsweft.com/api/mcp와 함께 있는지 확인하세요. --scope user로 추가하지 않았다면 서버는 프로젝트별이므로, 다른 폴더에는 없을 수 있습니다.

already_claimed

오류가 아니라 답입니다. 다른 클라이언트가 그 작업에 살아 있는 리스를 쥐고 있습니다. 에이전트는 다른 일을 골라야 합니다. 다른 세션이 죽었다는 것을 안다면 기다리세요. 20분 안에 리스가 끝나고 작업이 풀립니다.

attention_queue_full

끝났거나 막힌 일이 너무 많이 당신을 기다리고 있습니다. 1인 워크스페이스에서는 5개, 팀에서는 10개, 또는 예상 검토 시간 45분 중 먼저 닿는 쪽입니다. 질문도 포함됩니다. 받은편지함을 어느 정도 비울 때까지 start_task가 거절합니다. 응답에는 에이전트가 여전히 할 수 있는 일(report_progress, get_my_work, get_board_state, search)이 나열되므로, 더 시작하는 대신 마무리하거나 정리할 수 있습니다.

무료 요금제에서 호출이 멈춤

무료에는 월 200회 AI 호출이 포함되고, 가입 후 첫 48시간은 세지 않습니다. 5분마다 하트비트를 보내는 긴 세션은 호출을 꾸준히 씁니다. Pro는 한도가 없습니다. 요금을 보세요.

TODO.md, GitHub Issues, Hypertask와 비교하면?

GitHub에 관한 사실은 GitHub 문서와 요금 페이지로, Hypertask에 관한 사실은 그들의 문서로 연결됩니다. 더 넓은 표는 MCP 작업 관리 도구 비교를 보세요.

저장소 하나에 개발자 한 명이라면 TODO.md가 맞는 답입니다. 코드와 함께 버전 관리되고, 계정도 인증도 없습니다. 두 세션이 함께 고치거나, 휴대폰에서 질문에 답하고 싶어지면 무너집니다.

일이 이미 이슈와 풀 리퀘스트이고 팀 전체가 GitHub에서 산다면 GitHub Issues가 자연스러운 자리입니다. Weft에는 GitHub 연동이 없으므로, 커밋과 PR 링크는 동기화가 아니라 영수증의 산출물로 전달됩니다.

훅과 CI용 CLI, REST API, 자체 신원을 가진 서비스 계정 형태의 에이전트, 내장 AI 기능, 시간 추적, 키보드 중심 앱을 원한다면 Hypertask가 더 낫습니다. Weft에는 CLI도, 공개 API도, 시간 추적도 없습니다. Weft가 다른 점은 작업 맡기, 하트비트, 사람에게 하는 질문이 Claude Code가 직접 호출하는 MCP 도구라는 것, 로그인이 리프레시가 있는 OAuth라는 것, 그리고 같은 보드가 ChatGPT와 두 휴대폰 스토어에 있다는 것입니다. 자세한 내용은 우리의 Hypertask 비교에 있습니다.

Claude Code에 API 키가 필요한가요?

아닙니다. Claude Code는 브라우저에서 OAuth로 로그인하고, Weft가 리프레시 토큰을 발급하므로 클라이언트가 스스로 로그인을 갱신합니다. OAuth를 못 하는 클라이언트를 위해 개인 액세스 토큰이 있지만, Claude Code에는 필요 없습니다.

Claude Code가 내 확인 없이 작업을 Done으로 옮기나요?

기본적으로는 그렇습니다. complete_task가 영수증과 함께 작업을 Done으로 옮깁니다. 검토가 필요하거나 검증 확인이 실패한 작업은 대신 받은편지함에 멈춰 수락, 재작업, 나중에, 폐기를 기다립니다.

Claude Code가 무언가를 지우지 못하게 할 수 있나요?

동의 화면에서, 또는 나중에 설정 → 연결된 AI 클라이언트에서 연결을 write로 정하세요. write는 파괴적 도구 세 개(trash_task, archive_done_tasks, complete_sprint)를 뺀 전부를 허용합니다. read는 읽기 전용 도구 11개만 허용합니다. 어떤 경우에도 에이전트는 작업을 영구 삭제할 수 없습니다. 휴지통은 작업을 30일 보관하고, 휴지통에서 복원하는 것은 Pro 기능입니다.

Weft는 Claude 위에 AI 비용을 따로 받나요?

아닙니다. Weft에는 AI 크레딧이 없습니다. 생각은 당신의 Claude 요금제 아래 Claude Code에서 일어납니다. Weft는 도구 호출을 셉니다. 무료는 월 200회, Pro는 좌석당 월 $7 또는 연 $60에 무제한입니다. 요금을 보세요.

이미 Linear, Jira, Notion, Trello에 작업을 두고 있다면요?

가져오기는 모든 요금제에서 무료입니다. Linear, Jira, Notion의 CSV 내보내기나 Trello 보드 JSON을 쓰면 됩니다. Claude Code가 bulk_create_tasks로 여러 작업을 한꺼번에 만들 수도 있습니다.

Weft는 Claude Code 말고 다른 코딩 에이전트와도 동작하나요?

네. Cursor, Codex, ChatGPT를 포함해 클라이언트 설정 페이지가 33개 있습니다. 모두 같은 엔드포인트로 같은 보드에 닿습니다.