대부분의 AI 에이전트는 첫 출근 날처럼 시작합니다. 작업 추적기(task tracker)용 로그인 하나, 문서(docs)용 로그인 하나, 통화 녹음 기록용 로그인 하나, 고객 피드백용 로그인 하나가 필요하죠. 추가되는 모든 도구는 관리해야 할 또 다른 토큰이 되고, 고려해야 할 권한 세트가 늘어나며, 에이전트가 파악하는 작업의 모습이 구식이 될 수 있는 장소만 늘어납니다.
본 튜토리얼은 Dutify를 사용하여 단일 호스팅 MCP 서버와 하나의 API 키로 이 네 가지 제품 모두에 에이전트를 연결합니다. 약 5분이면 완료됩니다.
An AI agent gets tasks, docs, calls and feedback through one sign-in
얻게 되는 것들
네 가지 제품을 포괄하는 단일 원격 MCP 서버가 https://mcp.dutify.ai (스트리밍 가능한 HTTP)에서 제공됩니다.
| 제품 | 도구 | 커버 범위 |
|---|
| Dutify Cloud (프로젝트) | pm_* | 작업(Tasks), 하위 작업(subtasks), 댓글, 스프린트, 뷰, 사용자 지정 필드, 시간 추적 |
| ... | | |
추가적으로 에이전트가 스스로 위치를 파악할 수 있도록 몇 가지 디스커버리 도구(whoami, list_workspaces, find_my_workspace)가 제공됩니다. 이 도구 목록은 공개되어 있으며, 모든 데이터 호출에는 키가 필요하고 백엔드는 각 호출에서 해당 키의 범위와 사용자의 워크스페이스 권한을 강제합니다. | | |
1. 키 받기
dutify.cloud에 가입(무료)한 후, 계정 설정에서 **개인 키(personal key)**를 생성하세요. 이 키는 du_live_로 시작하며 사용자의 계정이 접근할 수 있는 모든 제품에서 작동합니다.
만약 에이전트를 하나의 제품 내부에 유지하고 싶다면, 워크스페이스 키도 존재합니다: Cloud의 경우 dk_live_…, Codexum 및 Roadmarq의 경우 dh_live_…, Hub의 경우 dh_live_…입니다.
2. 클라이언트 연결하기
Claude Code:
claude mcp add --transport http dutify https://mcp.dutify.ai --header "X-API-Key: du_live_YOUR_KEY"
Cursor, Claude Desktop 및 기타 JSON 설정 클라이언트:
{
"mcpServers": {
"dutify": {
...
VS Code (.vscode/mcp.json):
{
"servers": {
"dutify": {
...
3. 첫 호출들
에이전트에게 whoami를 실행하도록 요청한 다음 list_workspaces를 실행합니다. 개인 키(personal key)를 사용하는 경우, 에이전트는 각 데이터 호출마다 워크스페이스 정보를 전달하며, X-Dutify-Workspace 헤더를 사용하여 하나로 고정할 수도 있습니다.
여기서 유용한 프롬프트는 도구(tools)를 넘나드는 것들입니다. 왜냐하면 이는 단일 제품 통합으로는 수행할 수 없는 영역이기 때문입니다:
- "지난주 통화에서 가격 책정에 대해 무엇을 결정했는지, 그리고 이에 대한 작업 항목이 있는지 알려줘?"
- "Jira 태그가 지정된 미해결 기능 요청들을 요약하고 관련 위키 페이지를 연결해 줘."
- "오늘 통화의 각 실행 항목에 대해 작업(task)을 생성하고 해당 작업을 담당한 사람에게 할당해 줘."
범위에 대한 참고 사항 (A note on scope)
하나의 커넥터가 거대한 권한을 의미하는 것은 아닙니다. 개인 키는 계정이 접근할 수 있는 범위까지만 도달할 수 있으며, 워크스페이스 키는 특정 워크스페이스와 제품군(product family)에 바인딩됩니다. 로드맵 읽기만 필요한 에이전트에게는 개인 키가 아닌 좁은 범위를 가진 키를 제공해야 합니다.
링크 (Links)