tasqr-mcp (Node)

Tasqr MCP 서버 — AI 에이전트를 위한 작업 상태 관리.

로컬 stdio 프로세스로 실행되며 ~/.config/tasqr/credentials에서 API 키를 읽어 Tasqr Lambda MCP 서버로 도구 호출을 프록시합니다. MCP 클라이언트 구성에는 비밀이 없습니다 — API 키는 자격 증명 파일에만 저장됩니다(Mac/Linux에서는 0600 권한으로 작성, Windows에서는 프로필 디렉터리의 ACL에 의존).

설치

Node 22 이상이 필요합니다.

npx tasqr-mcp        # run once without installing
# or
npm install -g tasqr-mcp

Related MCP server: pith

MCP 클라이언트 구성

{
  "mcpServers": {
    "tasqr": {
      "command": "npx",
      "args": ["tasqr-mcp"]
    }
  }
}

자격 증명

첫 실행 — 설정 불필요. 터미널에서 프록시를 한 번 실행하세요:

npx tasqr-mcp

디스크에 API 키가 없으면 GitHub 디바이스 플로우 가입을 시작합니다: 브라우저에서 GitHub를 열고, 붙여넣을 디바이스 코드를 클립보드에 복사하며, (계정에 워크스페이스가 둘 이상인 경우) 사용할 워크스페이스를 묻습니다. 그런 다음 자격 증명 파일을 자동으로 작성합니다. 직접 만들고 싶다면 아래의 수동 단계만 따르면 됩니다.

MCP 클라이언트는 비밀을 볼 수 없습니다 — 단지 npx tasqr-mcp를 실행할 뿐이며, 키는 다음 위치에서 읽힙니다:

~/.config/tasqr/credentials   (Mac/Linux)
%APPDATA%\tasqr\credentials   (Windows)

[default]
api_key = tasqr_abc123...

Mac/Linux에서는 파일이 0600(소유자 읽기/쓰기 전용)으로 작성되고, Windows에서는 프로필 디렉터리의 ACL을 상속합니다. 웹에서 키를 직접 받고 싶다면 tasqr.ai에서 가입하세요.

가입은 대화형이므로 stdin이 TTY일 때만 실행됩니다. MCP 클라이언트가 키 없이 헤드리스로 프록시를 실행하면 종료되고 터미널에서 npx tasqr-mcp를 먼저 실행하라고 안내합니다.

로깅

로깅은 기본적으로 꺼져 있습니다 — 켜지 않는 한 디스크에 아무것도 기록되지 않습니다. 활성화하면 프록시는 추가 전용 JSON 라인 이벤트 로그를 유지하며 메타데이터만 기록합니다: 도구 이름과 필드 이름, 작업 내용이나 키 자료는 절대 기록하지 않습니다.

자격 증명 파일에서 켜세요:

[default]
api_key   = tasqr_abc123...
log_level = info                        # off (default) | info | debug
log_path  = ~/.config/tasqr/tasqr-mcp.log

회전이나 크기 제한이 없으므로 debug는 문제 해결용이지 계속 켜두는 용도가 아닙니다.

환경 변수

환경 변수가 자격 증명 파일보다 우선하며, 자격 증명 파일은 기본값보다 우선합니다.

클라이언트 측 암호화 (BYOK)

작업 필드(제목, 설명, 메타데이터, 출력, 메모)를 Tasqr 서버에 도달하기 전에 로컬에서 암호화합니다. 사용자가 제어하는 AWS KMS 키가 필요합니다.

AWS SDK는 이미 포함되어 있습니다. @aws-sdk/client-kms와 @aws-sdk/credential-providers는 선택적 종속성으로 제공되며 npm이 기본적으로 설치합니다 — 일반적인 npx tasqr-mcp 또는 npm install -g tasqr-mcp에는 BYOK에 필요한 모든 것이 포함됩니다. --omit=optional로 설치한 경우에만 누락되며, BYOK를 사용하려면 해당 플래그 없이 다시 설치하세요.

자격 증명 파일에 추가:

[default]
api_key      = tasqr_abc123...
kms_key_id   = arn:aws:kms:us-east-1:123456789012:key/your-key-id
aws_profile  = default

Tasqr 조직이 클라이언트 측 BYOK에 등록되어 있어야 합니다. 시작 시 프록시는 서버에 조직이 사용하는 모드를 묻습니다. 조직이 서버 관리형이면 암호화하지 않고 시작을 거부합니다 — 그렇지 않으면 서버가 암호문을 두 번 암호화하여 대시보드, REST API, 다른 에이전트가 데이터를 읽을 수 없게 되고, KMS 키를 잃으면 복구할 수 없게 됩니다. 오류 메시지는 수정할 프로필을 알려줍니다.

등록되면 프록시는 데이터 암호화 키(DEK)를 가져오거나 생성하고, KMS로 래핑한 다음 래핑된 키를 Tasqr API에 저장합니다. 이후 실행에서는 캐시된 DEK를 단일 KMS 호출로 풉니다. 모든 AES-256-GCM 암호화는 메모리에서 이루어집니다 — 평문 DEK는 프로세스를 벗어나지 않습니다.

모든 암호문은 추가로 컨텍스트에 바인딩됩니다: GCM 연관 데이터는 각 암호화된 값을 조직, 해당 작업, 그리고 작성된 필드에 연결합니다. 다른 슬롯(다른 필드, 작업, 조직)으로 이동된 블롭은 잘못된 위치에서 복호화되는 대신 완전히 복호화에 실패합니다. 이를 가능하게 하기 위해 프록시는 각 새 작업의 ID를 자체적으로 생성하여 생성 호출과 함께 보냅니다.

전체 설정 과정은 클라이언트 측 암호화 가이드를 참조하세요.

로컬 개발

npm install
npm test
node bin/tasqr-mcp.js --version