tasqr-mcp (Python)

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

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

설치

Python 3.11 이상이 필요합니다.

uvx tasqr-mcp        # run once without installing
# or
pip install tasqr-mcp

Related MCP server: keyvault

MCP 클라이언트 구성

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

자격 증명

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

uvx tasqr-mcp

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

MCP 클라이언트는 비밀을 볼 수 없습니다 — 단지 uvx 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 클라이언트는 종료되며 먼저 터미널에서 uvx tasqr-mcp를 실행하라고 안내합니다.

로깅

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

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

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

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

환경 변수

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

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

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

자격 증명 파일에 kms_key_id를 추가하면 활성화됩니다 — 추가로 설치할 것은 없습니다:

[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 연관 데이터는 각 암호화된 값을 조직, 해당 작업, 그리고 작성된 필드에 연결합니다. 다른 슬롯(다른 필드, 작업 또는 조직)으로 이동된 blob은 잘못된 위치에서 복호화되는 대신 완전히 복호화에 실패합니다. 이를 가능하게 하기 위해 프록시는 각 새 작업의 id를 직접 생성하여 생성 호출과 함께 보냅니다.

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

로컬 개발

pip install -e ".[dev]"
pytest
tasqr-mcp --version