팀워크 MCP

Teamwork API에 연결되는 MCP 서버로, Teamwork 프로젝트 및 작업과 상호 작용하기 위한 간소화된 인터페이스를 제공합니다.

특징

Teamwork API에 연결
프로젝트 및 작업 검색
작업 생성, 업데이트 및 삭제
RESTful API 엔드포인트
오류 처리 및 로깅
Cursor 및 기타 애플리케이션과 통합하기 위한 MCP 서버

필수 조건

Node.js(v14.17 이상, 18세 이상 또는 최신 LTS 버전 권장)
npm 또는 yarn
API 액세스가 가능한 Teamwork 계정

사용 가능한 Teamwork MCP 도구

다음 도구는 MCP 서버를 통해 사용할 수 있습니다.

프로젝트 도구

getProjects - Teamwork의 모든 프로젝트 가져오기
getCurrentProject - 현재 프로젝트에 대한 세부 정보를 가져옵니다.
createProject - Teamwork에서 새 프로젝트 만들기

작업 도구

getTasks - Teamwork에서 모든 작업 가져오기
getTasksByProjectId - Teamwork의 특정 프로젝트의 모든 작업 가져오기
getTaskListsByProjectId - Teamwork의 특정 프로젝트에서 모든 작업 목록을 가져옵니다.
getTaskById - Teamwork에서 ID로 특정 작업 가져오기
createTask - Teamwork에서 새 작업 만들기
createSubTask - Teamwork에서 상위 작업 아래에 새 하위 작업을 만듭니다.
updateTask - Teamwork에서 기존 작업 업데이트
deleteTask - Teamwork에서 작업 삭제
getTasksMetricsComplete - Teamwork에서 완료된 작업의 총 개수를 가져옵니다.
getTasksMetricsLate - Teamwork에서 지연된 작업의 총 개수를 가져옵니다.
getTaskSubtasks - Teamwork에서 특정 작업에 대한 모든 하위 작업을 가져옵니다.
getTaskComments - Teamwork에서 특정 작업에 대한 코멘트를 받습니다.

댓글 도구

createComment - 작업/메시지/노트북과 관련된 댓글을 생성합니다.

회사 도구

getCompanies - 선택적 필터링을 사용하여 Teamwork의 모든 회사 가져오기
getCompanyById - ID로 특정 회사 가져오기
createCompany - Teamwork에서 새 회사 만들기
updateCompany - 기존 회사 정보 업데이트
deleteCompany - Teamwork에서 회사 삭제

사람 도구

getPeople - Teamwork의 모든 사람을 가져옵니다.
getPersonById - Teamwork에서 ID로 특정 사람을 가져옵니다.
getProjectPeople - Teamwork에서 특정 프로젝트에 할당된 모든 사람을 가져옵니다.
addPeopleToProject - Teamwork에서 특정 프로젝트에 사람 추가
deletePerson - Teamwork에서 사람 삭제
updatePerson - 개인의 정보(시간대, 이름, 이메일 등)를 업데이트합니다.
getProjectsPeopleMetricsPerformance - 사람 지표 성과 가져오기
getProjectsPeopleUtilization - 사람 활용도 가져오기
getProjectPerson - 프로젝트에 참여하는 특정 인물을 가져옵니다.

보고 도구

getProjectsReportingUserTaskCompletion - 사용자 작업 완료 보고서 가져오기
getProjectsReportingUtilization - 다양한 형식의 CSV 및 HTML로 활용도 보고서 받기

시간 도구

getTime - 모든 시간 항목 가져오기
getProjectsAllocationsTime - 프로젝트 할당 시간 가져오기
getTimezones - Teamwork에서 사용 가능한 모든 시간대를 가져옵니다(사용자 시간대를 업데이트할 때 유용함)

설치

저장소를 복제합니다.지엑스피1
종속성:
npm install
.env.example 파일을 기반으로 .env 파일을 만듭니다.
cp .env.example .env
Teamwork 자격 증명으로 .env 파일을 업데이트합니다.

구성

.env 파일을 편집하여 애플리케이션을 구성합니다.

PORT : 서버가 실행될 포트(기본값: 3000)
NODE_ENV : 환경(개발, 프로덕션, 테스트)
LOG_LEVEL : 로깅 레벨(정보, 오류, 디버그)
TEAMWORK_DOMAIN : Teamwork 도메인 이름(예: https://your-company.teamwork.com 의 경우 "your-company")
TEAMWORK_USERNAME : Teamwork 사용자 이름(이메일)
TEAMWORK_PASSWORD : 팀워크 비밀번호

자격 증명 설정

팀워크 자격 증명은 세 가지 방법으로 제공할 수 있습니다.

환경 변수 : 환경에서 TEAMWORK_DOMAIN , TEAMWORK_USERNAME , TEAMWORK_PASSWORD 설정합니다.
.env 파일 : 위에 표시된 대로 필요한 변수로 .env 파일을 만듭니다.
명령줄 인수 : 애플리케이션을 실행할 때 자격 증명을 전달합니다.

   node build/index.js --teamwork-domain=your-company --teamwork-username=your-email@example.com --teamwork-password=your-password

또는 짧은 형식을 사용하면 다음과 같습니다.

   node build/index.js --domain=your-company --user=your-email@example.com --pass=your-password

도구 필터링

다음 명령줄 인수를 사용하여 MCP 서버에서 사용할 수 있는 도구를 제어할 수 있습니다.

허용 목록 : 특정 도구만 노출:
node build/index.js --allow-tools=getProjects,getTasks,getTaskById
또는 짧은 형식을 사용하면 다음과 같습니다.
node build/index.js --allow=getProjects,getTasks,getTaskById
거부 목록 : 지정된 도구를 제외한 모든 도구를 노출합니다.
node build/index.js --deny-tools=deleteTask,updateTask
또는 짧은 형식을 사용하면 다음과 같습니다.
node build/index.js --deny=deleteTask,updateTask

그룹을 사용한 도구 필터링

이제 필터링할 도구 그룹을 지정하여 MCP 서버에서 사용할 수 있는 도구를 더욱 유연하게 제어할 수 있습니다. 사용 가능한 그룹은 다음과 같습니다.

프로젝트 : 프로젝트 관련 도구를 모두 포함합니다.
작업 : 모든 작업 관련 도구가 포함됩니다.
사람 : 사람과 관련된 모든 도구를 포함합니다.
보고 : 보고 관련 도구를 모두 포함합니다.
시간 : 시간과 관련된 모든 도구를 포함합니다.
댓글 : 특정 댓글 도구가 포함되어 있습니다.

도구 필터링에서 그룹 사용

허용 또는 거부 목록에서 이러한 그룹을 지정하여 그룹 내의 모든 도구를 포함하거나 제외할 수 있습니다. 예:

그룹이 있는 허용 목록 : 특정 도구 그룹만 노출:
node build/index.js --allow-tools=Tasks,People
또는 짧은 형식을 사용하면 다음과 같습니다.
node build/index.js --allow=Tasks,People
그룹이 있는 거부 목록 : 지정된 그룹에 있는 도구를 제외한 모든 도구를 노출합니다.
node build/index.js --deny-tools=Reporting,Time
또는 짧은 형식을 사용하면 다음과 같습니다.
node build/index.js --deny=Reporting,Time

기본적으로 허용 목록이나 거부 목록이 모두 제공되지 않으면 모든 도구가 노출됩니다. 둘 다 제공된 경우 허용 목록이 우선합니다.

보안 강화를 위해 도구 필터링은 두 가지 수준으로 적용됩니다.

사용 가능한 도구를 나열할 때(허용 목록이나 거부 목록에 없는 도구는 표시되지 않음)
도구 호출을 실행할 때(필터링된 도구를 호출하려는 시도는 오류와 함께 거부됨)

팀워크 프로젝트 설정

현재 솔루션을 Teamwork 프로젝트와 연관시키려면 다음 방법을 사용할 수 있습니다.

구성 파일 사용

다음과 같은 구조로 프로젝트 루트에 .teamwork 파일을 만들 수 있습니다.

PROJECT_ID = YourTeamworkProjectID

이 간단한 구성 파일은 귀하의 솔루션을 특정 Teamwork 프로젝트와 연결하며, 나중에 더 자세한 내용을 저장하는 데 사용할 수 있습니다.

MCP를 구성하면 Teamwork 프로젝트를 찾아 현재 솔루션과 연결할 수 있으며, 작업 중인 솔루션과 관련된 프로젝트 및 작업을 가져오는 데 필요한 API 호출 수가 줄어듭니다.

용법

NPX 사용(권장)

Teamwork MCP를 사용하는 가장 쉬운 방법은 npx를 사용하는 것입니다.

npx teamwork-mcp

구성 옵션을 전달할 수도 있습니다.

npx teamwork-mcp --domain=your-company --user=your-email@example.com --pass=your-password

애플리케이션 구축

참고: MCP만 사용하려는 경우에는 필요하지 않습니다. 위의 NPX 지침을 따르세요.

애플리케이션을 빌드하세요:

npm run build

이렇게 하면 MCP 서버로 사용할 준비가 된 TypeScript 코드가 컴파일됩니다.

MCP 서버로 실행

사용자 이름, 비밀번호 및 URL에 .env 파일을 사용하거나 이를 환경 변수에 저장한 경우 Cursor 및 다른 애플리케이션과 통합하기 위한 MCP 서버로 실행하려면 다음을 수행합니다.

참고: 저장소를 저장한 위치에 따라 드라이브 및 경로 세부 정보를 변경하는 것을 잊지 마세요.

node C:/your-full-path/build/index.js

또는 줄 인수를 사용하여 전달할 수 있습니다.

node C:/your-full-path/build/index.js --teamwork-domain=your-company --teamwork-username=your-email@example.com --teamwork-password=your-password

다음과 같은 짧은 형식을 사용할 수도 있습니다.

node C:/your-full-path/build/index.js --domain=your-company --user=your-email@example.com --pass=your-password

MCP 검사기 사용

디버깅을 위해 MCP 검사기를 실행하려면:

npm run inspector

커서(및 기타 MCP 클라이언트)에 추가

이 MCP 서버를 Cursor에 추가하려면:

0.47 이전 버전

커서 설정 > 기능 > MCP 열기
"+ 새 MCP 서버 추가"를 클릭하세요
서버 이름을 입력하세요(예: "Teamwork API")
전송 유형으로 "stdio"를 선택하세요
서버를 실행하려면 npx @vizioz/teamwork-mcp 명령을 입력하고 위에서 언급한 대로 자격 증명과 도메인 명령줄 인수를 추가합니다.
- 도구 필터링 옵션을 포함할 수 있습니다: --allow=getProjects,getTasks 또는 --deny=deleteTask
"추가"를 클릭하세요

0.47 이후 버전(구성을 수동으로 편집)

    "Teamwork": {
      "command": "npx",
      "args": [
        "-y",
        "@vizioz/teamwork-mcp",
        "--domain",
        "yourdomain",
        "--user",
        "youruser@yourdomain.com",
        "--pass",
        "yourPassword"
      ]
    }

위에 언급된 허용 또는 거부 인수를 추가하려면 다음과 같이 추가하면 됩니다. 위에 제공된 예를 추가할 수도 있고, 아래에 표시된 것처럼 그룹과 개별 도구를 모두 추가할 수도 있습니다.

    "Teamwork": {
      "command": "npx",
      "args": [
        "-y",
        "@vizioz/teamwork-mcp",
        "--domain",
        "yourdomain",
        "--user",
        "youruser@yourdomain.com",
        "--pass",
        "yourPassword",
        "--allow",
        "Tasks,Projects",
        "--deny",
        "getProjectsPeopleMetricsPerformance,getProjectsPeopleUtilization"
      ]

Teamwork MCP 도구는 이제 Composer의 커서 에이전트에서 사용할 수 있습니다.

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.

부인 성명

이 프로젝트는 Teamwork.com과 제휴, 보증 또는 후원 관계가 없습니다. 패키지 이름(@vizioz/teamwork-mcp)에 "Teamwork"라는 이름을 사용하는 것은 Teamwork.com API와의 호환성을 나타내기 위한 설명적 목적으로만 사용됩니다.

Integrations