Claude를 사용자의 자체 호스팅 Vikunja 인스턴스에 연결하는 원격 MCP(Model Context Protocol) 서버입니다. Claude.ai에서 사용자 지정 커넥터로 추가하여 대화형으로 작업을 관리하세요.
도구 | 설명 |
| 모든 프로젝트 나열 |
| 프로젝트 세부 정보 가져오기 |
| 새 프로젝트 생성 |
| 프로젝트 업데이트 |
| 프로젝트 삭제 |
| 모든 프로젝트의 작업 나열/필터링/검색 |
| 댓글을 포함한 작업 세부 정보 가져오기 |
| 프로젝트 내 작업 생성 |
| 작업 속성 업데이트 |
| 작업 삭제 |
| 작업을 완료로 표시 |
| 작업을 미완료로 표시 |
| 작업에 댓글 추가 |
| 모든 라벨 나열 |
| 새 라벨 생성 |
| 작업에 라벨 부착 |
| 작업에서 라벨 제거 |
| 주간 리뷰 요약 생성 |
| 마감일이 있는 작업의 일정 보기 (연체 + 예정) |
| 두 작업 연결 (하위 작업, 차단, 선행, 관련 등) |
| 두 작업 간의 관계 제거 |
Related MCP server: vikunja-mcp
npm install
npm run build
export VIKUNJA_URL=https://your-vikunja-instance.example.com
export VIKUNJA_TOKEN=your-api-token
export MCP_AUTH_TOKEN=$(openssl rand -hex 32)
export PORT=9090
node build/index.js그런 다음 Claude.ai의 설정 > 커넥터(Settings > Connectors)에서 서버를 사용자 지정 커넥터로 추가하세요:
https://your-server.example.com/mcp?token=<MCP_AUTH_TOKEN>Uberspace에서의 전체 배포 가이드는 DEPLOY-UBERSPACE.md를 참조하세요.
변수 | 필수 | 설명 |
| 예 | Vikunja 인스턴스의 기본 URL (끝에 슬래시 제외) |
| 예 | Vikunja 설정 > API 토큰에서 생성한 API 토큰 |
| 권장 |
|
| 아니요 | 수신 대기할 포트 (기본값: |
MCP_AUTH_TOKEN이 설정되면, 서버는 일치하는 ?token=… 쿼리 매개변수가 포함되지 않은 /mcp에 대한 모든 요청을 401 Unauthorized 응답으로 거부합니다.
강력한 토큰을 생성하세요:
openssl rand -hex 32Claude.ai의 커넥터 URL에 추가하세요:
https://your-server.example.com/mcp?token=<your-token>MCP_AUTH_TOKEN을 설정하지 않으면 엔드포인트에 접근할 수 있는 누구나 사용할 수 있습니다. 이는 반드시 방화벽으로 보호된 개인 네트워크에서만 수행하십시오.
서버는 모든 캘린더 앱에서 구독할 수 있는 기계 판독 가능한 iCal 피드를 제공합니다:
webcal://your-server.example.com/calendar.ics여기에는 시작일, 마감일 또는 종료일이 있는 모든 미완료 작업과 지난 30일 이내에 완료된 작업이 포함됩니다. 한 번 구독하면 캘린더 앱이 자동으로 폴링합니다.
전송: 스트리밍 가능한 HTTP (상태 비저장) — 원격 서버를 위한 현재 MCP 표준
인증: MCP 엔드포인트를 위한 쿼리 매개변수 토큰 (MCP_AUTH_TOKEN); 업스트림 API 호출을 위한 Vikunja API 토큰
런타임: Node.js + Express
SDK: @modelcontextprotocol/sdk v1.x
Node.js ≥ 18
API 토큰이 있는 자체 호스팅 Vikunja 인스턴스
Claude.ai가 서버에 도달할 수 있는 공개 접근 가능한 URL
This server cannot be deployed
Persistent context for Claude. Your AI always knows your projects and next actions across sessions.
Connect Claude to your Platform7n workspaces — chat, links, and tasks. One-click OAuth.
Notes and actions in one app. Let Claude or ChatGPT read and update them.
Personal CRM for Claude. Contacts live as plain-text files in your own Google Drive.