AI 에이전트를 위한 CRM: 에이전트가 하는 일
필요한 것을 말하면 에이전트가 tm 명령으로 바꿉니다.
- 어제 리뉴얼 작업에 두 시간 기록해 줘
tm timers add --project-id <project-id> --started-at "yesterday 09:00" --duration 2:00 - 고객 Muster GmbH를 만들어 줘
tm customers create --name "Muster GmbH" --payment-terms-days 14 - Muster GmbH의 9월 청구서를 만들어 줘
tm invoices build --customer-id <client-id> --month 2026-09 - 좋아, 발행해 줘
tm invoices finalize <invoice-id> --yes - 한 번의 송금으로 청구서 두 건이 결제됐어
tm payments split --paid-on today --allocation <a>=3451.00 --allocation <b>=2998.80 - 9월 작업 내역서
tm statements create --customer-id <client-id> --period-from 2026-09-01 --period-to 2026-09-30 - 아직 입금되지 않은 건 뭐야?
tm payments outstanding - 올해 고객별 수익성은 어땠어?
tm revenue --from 2026-01-01 --to 2026-12-31
에이전트 접근은 Pro에 포함됩니다.
에이전트에게 허용되는 일
| 작업 | 규칙 |
|---|---|
| 조회, 기록, 생성, 수정 | 바로 실행합니다: 시간 기록, 고객, 계약, 프로젝트, 프로젝트 비용, 청구서 초안, 입금, 작업 내역서, 리포트. |
| 발행, 취소, 삭제 | 명시적인 --yes가 있을 때만 실행하며, 없으면 tm은 아무것도 보내지 않고 멈춥니다. 사용 가이드는 사용자가 요청할 때만 이렇게 하도록 에이전트에게 안내합니다. |
| 청구된 시간 변경 | 거부됩니다. 발행된 청구서나 확정된 작업 내역서에 들어간 시간은 잠깁니다. |
| 불완전한 전자 인보이스 발행 | 거부됩니다. 청구서는 초안으로 남고, tm이 빠진 항목과 수정할 위치를 모두 알려 줍니다. |
| 키 생성, 계정 삭제 | 에이전트 접근에서는 서버가 차단합니다. 이메일 확인 없는 비밀번호 변경도 마찬가지입니다. 새 키는 웹 앱에서만 만들 수 있습니다. |
보안 모델
에이전트는 웹 앱에서 만든 API 키로 작업하며, 이 키는 언제든 폐기할 수 있습니다.
- tm은 쓰기 키를 1시간 동안 유효한 토큰으로 교환하고 자동으로 갱신합니다. 교환 요청에는 속도 제한이 있습니다.
- 키는 로컬 설정 파일(파일 권한 600)이나 환경 변수에만 저장됩니다.
--verbose나--dry-run을 써도 출력, 로그, 오류 메시지에 절대 나타나지 않습니다. - 읽기 키는 일부 조회 경로와 타이머에만 접근할 수 있습니다.
- 키 폐기는 되돌릴 수 없으며 즉시 적용됩니다.
--dry-run은 요청을 보내지 않고 정확한 내용을 보여 줍니다. 기존 파일은 절대 몰래 덮어쓰지 않습니다.
에이전트를 위해 설계했습니다
에이전트가 사용 가이드와 명령 목록을 직접 가져오고, 모든 응답이 다음에 할 일을 알려 줍니다.
- 어떤 명령 그룹이 있어?
tm --json - 청구서에는 어떤 플래그를 쓸 수 있어?
tm schema invoices --json - 설치된 버전의 사용 가이드
tm skill - 보내기 전에 요청 내용 보여 줘
tm invoices finalize <invoice-id> --dry-run
에이전트 접근은 Pro에 포함됩니다.
| 특징 | 의미 |
|---|---|
| 빠짐없음 | 모든 API 작업에 명령이 정확히 하나씩 있습니다. API가 바뀔 때마다 테스트가 이를 확인합니다. |
| 예측 가능 | --json을 쓰면 stdout에는 JSON 문서가 정확히 하나만 나옵니다. 오류도 JSON으로 오며, 종료 코드로 호출을 고칠지, 사용자에게 물을지, 기다릴지, 다시 시도할지 알 수 있습니다. |
| 어디서나 실행 | macOS, Linux, Windows에서 실행되며, 에이전트 샌드박스처럼 설치 없이 npx로도 쓸 수 있습니다. |
| 모든 것이 한곳에 | 청구서, 계약, 미수금은 직접 만들었든 에이전트가 만들었든 Time Momentum에 모입니다. |
에이전트용 tm 설정
Node.js 22.14 이상과 웹 앱에서 만든 “읽기 및 쓰기” 권한의 API 키가 필요합니다.
tm 설치
npx -y @time-momentum/cli installAPI 키로 로그인
tm auth login로그인과 권한 확인
tm whoamiClaude Code: 스킬 설치
tm skill --installClaude Code: 상태 표시줄
현재 세션의 프로젝트, 공수, 예산이 Claude Code 하단에 표시됩니다.
tm statusline installAI 세션 기록
Claude Code, Codex, Cursor를 토큰과 실행 시간까지 기록합니다. Free에서도 됩니다.
tm collect init
설치 없이 쓸 수도 있습니다(예: 에이전트 샌드박스): npx -y @time-momentum/cli@latest whoami
관련 가이드
AI 에이전트를 위한 업무용 소프트웨어
에이전트가 고객, 청구서, 입금을 안전하게 다룰 수 있는 소프트웨어인지 판단하는 방법입니다.
가이드 읽기AI 에이전트를 위한 최고의 CRM
AI 에이전트용 CRM이 무엇을 뜻하는지, 대형 CRM과 Time Momentum은 각각 어디에 맞는지 정리했습니다.
가이드 읽기AI 에이전트에게 MCP와 CLI 중 무엇이 맞을까
커맨드라인이 MCP 서버보다 에이전트에 더 잘 맞는 경우가 많은 이유입니다.
가이드 읽기에이전틱 엔지니어링과 바이브 코딩
AI 에이전트를 활용한 엔지니어링이 바이브 코딩과 어떻게 다른지, 고객 작업에서 무엇을 뜻하는지 설명합니다.
가이드 읽기
Pro에 포함
tm을 통한 에이전트 접근은 Pro에 포함됩니다. 모든 신규 계정은 신용카드 없이 30일 동안 Pro를 체험할 수 있습니다.
Pro가 없어도 API 키로 타이머와 프로젝트 목록에는 접근할 수 있습니다.
자주 묻는 질문
왜 MCP 서버가 아니라 CLI인가요?
에이전트는 이미 셸에서 작업합니다. tm은 모든 도구 정의를 미리 불러오는 대신 필요한 명령 목록만 불러오고, Claude Code, Codex, Cursor 등 명령을 실행할 수 있는 모든 에이전트에서 똑같이 동작합니다. 또한 모든 명령을 직접 실행해 에이전트가 무엇을 했는지 정확히 확인할 수 있습니다. Time Momentum용 MCP 서버는 없습니다.
어떤 에이전트가 tm과 함께 동작하나요?
셸 명령을 실행할 수 있는 모든 에이전트입니다. Claude Code는 tm skill --install로 전체 가이드를 가리키는 짧은 스킬을 받습니다. Codex, Cursor 등은 tm skill로 가이드를 읽으며, 가이드는 항상 설치된 버전에 맞춰집니다.
에이전트가 실수하면 어떻게 되나요?
초안은 수정하거나 삭제할 수 있습니다. 발행된 청구서는 취소로 바로잡으며, 그 청구서에 들어간 시간은 잠깁니다. --dry-run을 쓰면 에이전트가 요청을 보내기 전에 정확한 내용을 보여 줍니다.