Workspace Config를 열고 API keys를 관리할 수 있는 역할(SuperAdmin 또는 Admin 등)이 필요합니다. Claude Desktop 또는 Cursor가 실행되는 컴퓨터에는 **Node.js 20+**도 필요합니다.
요구 사항
npm의 MCP 패키지는
agencyhandy-mcp입니다. Claude와 Cursor는 npx -y agencyhandy-mcp@1로 실행합니다.
Claude 또는 Cursor MCP 설정
1
Workspace Config 열기
AgencyHandy에서 Workspace Config(회사 설정)를 연 다음 API Key 탭으로 이동합니다.
2
워크스페이스 API 키 생성
새 워크스페이스 API 키를 만들거나 저장해 둔 키를 사용하세요. 표시되면 바로 복사하세요 — 이후 전체 키를 다시 볼 수 없습니다.
3
MCP 구성 복사
같은 API Key 탭의 Claude / Cursor MCP 설정 패널에서 Copy MCP config를 클릭해 키와 백엔드 URL이 포함된 JSON을 복사합니다.
4
Cursor 또는 Claude Desktop에 붙여넣기
구성을 다음에 붙여넣으세요:
- Cursor: 프로젝트 또는 사용자
.mcp.json - Claude Desktop:
claude_desktop_config.json
npx -y agencyhandy-mcp@1 명령과 API 키를 그대로 유지하세요.5
다시 시작하고 프롬프트 시도
Cursor 또는 Claude Desktop을 완전히 종료한 뒤 다시 엽니다. 그런 다음 워크스페이스 모닝 브리핑처럼 간단한 요청을 해보세요.
예시 프롬프트
자연어를 사용하세요. 작업을 배정할 때는 올바른 사람을 고르기 위해 전체 이름이나 이메일을 우선하세요.이름이 같은 사람이 두 명일 때
팀원 중 Sara가 두 명이면 Claude가 누구를 말하는지 묻습니다. ID를 지어내지 않으며 조용히 추측하지도 않습니다. 이름이 겹칠 수 있으면 프롬프트에 항상 전체 이름 또는 이메일을 포함하세요.지금 되는 것 vs 아직 안 되는 것
MCP는 API 키로 워크스페이스를 읽고 작업(생성·배정·발송·업데이트)할 수 있습니다. 클라이언트 채팅 답장은 아직 MCP로 제공되지 않습니다 — 해당 대화는 AgencyHandy를 사용하세요.
관련
- 앱의 Workspace Config → API Key에서 키를 만들고 구성을 복사
Latest package on the
1 tag is 1.7.2+. Claude can read ah://api-context (also inside ah://full-context) for API path gotchas: leads, projects/orders, tasks, comments, labels, clients, invoices, vouchers, and forms.- 패키지: npm의
agencyhandy-mcp(npx -y agencyhandy-mcp@1)