← 사용 가이드

Claude 연결 (MCP)

Claude가 Fecit MCP 서버를 통해 태스크·목표·메모를 읽고 관리합니다.

무엇인가요?

Fecit은 MCP (Model Context Protocol) 서버를 운영합니다. Claude에 연결하면 대화에서 바로 Fecit 데이터에 접근합니다 — 오늘의 태스크를 나열하고, 새 태스크를 만들고, 완료 처리하고, 목표에 글을 쓰고, 메모를 검색합니다. 전부 내 계정에서, 내 허가 아래 이루어집니다.

Fecit은 생각을 구조화해 담습니다 — 프로젝트 하나가 목표(target)·기대(expectation)·장애물(obstacle)·중요한 이유(stakes)·결과(result)·회고(retrospect)를 가집니다. 그래서 Claude가 받는 것은 체크리스트가 아닙니다. 이 목표가 왜 중요한지, 무엇이 가로막는지를 읽고, 아직 비어 있는 칸을 함께 채웁니다.

커넥터 URL

https://fecit.vaudium.net/api/mcp

연결 방법

Claude (웹 / 데스크톱 / 모바일)

  1. claude.ai에서 설정 → 커넥터를 엽니다
  2. 커스텀 커넥터 추가를 선택하고 위 URL을 붙여넣습니다
  3. Fecit 계정(Google 또는 Apple)으로 로그인하고 접근을 허용합니다

Claude Code

claude mcp add --transport http fecit https://fecit.vaudium.net/api/mcp

Claude가 하는 일

  • "오늘 할 일 뭐 있어?" — 태스크를 나열하고 필터링합니다
  • "금요일까지 데모 준비 태스크 추가해 줘" — 태스크를 만들고 일정을 잡습니다
  • "헬스장 태스크 완료 처리하고 만족도 4로" — 상태를 바꾸고 평가를 기록합니다
  • "이 프로젝트 회고 쓰는 것 도와줘" — 목표와 결과를 읽고 함께 작성합니다
  • "주방 리모델링 관련해서 메모해 둔 게 뭐였지?" — 메모를 검색합니다
  • "오늘 데일리 리뷰 써 줘" — 하루 리뷰를 채웁니다

접근과 보안

  • 연결은 OAuth로 이루어집니다 — Fecit 페이지에서 직접 로그인하고 명시적으로 허용합니다. 비밀번호는 Claude에 전달되지 않습니다.
  • Claude는 앱과 동일한 권한 아래 내 데이터에만 접근합니다.
  • Claude 설정에서 커넥터를 제거하면 언제든 접근이 해제됩니다.

문제 해결

  • 연결이 실패하거나 오류가 납니다. 커넥터를 제거하고 위 URL 그대로 다시 추가하세요. Fecit 로그인을 끝까지 마치고 "허용"을 눌러야 합니다.
  • tool이 안 보입니다. 설정 → 커넥터에서 재연결(제거 후 다시 추가)하세요 — tool 목록은 로그인 성공 후 로드됩니다.
  • "그 태스크/프로젝트를 못 찾겠어요." 먼저 나열·검색을 요청하세요("내 태스크 보여줘", "X 관련 프로젝트 찾아줘") — 이름으로 항목을 찾은 뒤 처리합니다.
  • 날짜·시간이 어긋납니다. Claude는 내 로컬 타임존 기준으로 동작합니다. 잘못 짐작하면 타임존을 알려주거나 정확한 날짜·시각을 지정하세요.
  • 다른 계정으로 동작합니다. 커넥터는 로그인한 Fecit 계정으로 동작합니다. 계정을 바꾸려면 제거 후 재연결하세요.
  • 접근 해제. Claude 설정에서 커넥터를 제거하면 즉시 적용됩니다.

개발자 레퍼런스

서버에 직접 붙이거나 전체 tool 목록이 필요하신가요?MCP 서버 레퍼런스를 보세요 — 연결·OAuth와 모든 tool의 파라미터까지.