통합

AI 어시스턴트 연결 (MCP)

AI 어시스턴트를 Madi에 연결하면 일정을 말로 물어볼 수 있습니다 — 이번 주 마감, 작업이 늦어지면 밀리는 일, 프로젝트에서 바뀐 것. AI 앱에 URL 하나만 추가하고 한 번 승인하면 끝이며, Madi에서 내가 보는 범위만 봅니다.

할 수 있는 것

  • 내 할 일 — 모든 프로젝트에서 지연됐거나 곧 마감인 작업.
  • 프로젝트 일정 — 작업, 진행률, 상태, 담당자, 주요 일정, 의존 관계("이게 늦어지면 뭐가 밀려?").
  • 진행 노트와 최근 활동 — 요약, 주간 보고 초안, 사람별 집계.
  • 팀 휴가 — 누가 언제 자리를 비우는지, 마감과 겹치는지.
  • 진행 노트 작성 — 연결할 때 허용한 경우에만. AI 앱이 쓰기 전마다 확인을 묻습니다.

이렇게 물어보세요

  • "이번 주 내 할 일 정리해줘. 지연된 건 따로 표시하고"
  • "12일 릴리스 가능해? 남은 작업, 의존 관계, 담당자 휴가까지 고려해서 판단해줘"
  • "임포트 작업이 일주일 늦어지면 뭐가 같이 밀려?"
  • "지난주 이 프로젝트에서 바뀐 것 정리해서 주간 보고 초안 써줘"
  • "임포트 작업에 '임포트 동작 확인, 75% 완료'라고 노트 남겨줘" (쓰기 허용 필요)

연결하기

AI 앱에서 아래 URL로 MCP 서버를 추가하세요(앱에 따라 '커넥터', '사용자 지정 통합'이라고 부릅니다). AI 앱이 브라우저에서 Madi 페이지를 열면, 로그인하고 쓰기 허용 여부를 고른 뒤 '허용'을 누르면 됩니다. 토큰을 복사할 필요가 없습니다.

https://madiplan.app/mcp

Claude Code(터미널 또는 VS Code 확장): 아래 명령을 한 번 실행한 뒤, Claude Code에서 /mcp를 입력하고 madi를 골라 로그인하세요.

claude mcp add --transport http --scope user madi https://madiplan.app/mcp

원격 MCP 서버를 지원하는 다른 앱(claude.ai, ChatGPT, VS Code의 GitHub Copilot 등): 종류 HTTP, 위 URL로 서버를 추가하고 헤더는 비워 두세요. 메뉴 이름은 앱마다 다릅니다.

볼 수 있는 범위

  • Madi에서 내가 볼 수 있는 것과 정확히 같고, 그 이상은 볼 수 없습니다. 내가 열 수 있는 프로젝트를 내 역할 그대로 봅니다. 참여하지 않은 비공개 프로젝트는 보이지 않습니다.
  • 다른 사람의 비공개 진행 노트는 보이지도, 집계되지도 않습니다. AI가 읽는 모든 내용에서 이메일 주소는 제거됩니다.
  • 읽기는 항상 켜져 있습니다. 쓰기는 승인 화면의 별도 체크박스로 기본값은 꺼짐이며, 켜더라도 내가 편집할 수 있는 작업에만 가능합니다. AI가 쓴 노트는 @멘션 알림을 보내지 않습니다.
  • Madi가 받는 것은 AI의 데이터 요청뿐이며, AI와 나눈 대화 내용은 받지 않습니다.

관리·연결 끊기

계정 → AI 연결 → 연결된 앱에 승인한 앱이 권한과 마지막 사용일과 함께 표시됩니다. '연결 끊기'를 누르면 즉시 차단됩니다. 같은 앱을 다시 승인하면 이전 연결을 대체합니다.

개인 액세스 토큰 (고급)

로그인 흐름을 지원하지 않는 AI 클라이언트라면 계정 → AI 연결 → 개인 액세스 토큰에서 토큰을 만들어 Authorization: Bearer 헤더로 보내세요. 토큰은 한 번만 표시되고 1년간 유효하며, 만들 때 '쓰기 허용'을 체크하지 않으면 읽기 전용입니다. 비밀번호처럼 다루세요.

문제 해결

  • 'claude'를 찾을 수 없다고 나오면 — Claude Code CLI가 PATH에 없습니다. 설치한 뒤(Windows: irm https://claude.ai/install.ps1 | iex) 새 터미널을 여세요.
  • AI가 Madi에 접속할 수 없다거나 권한이 없다고 하면 — 다시 연결하세요. Claude Code는 /mcp에서 madi 선택, 다른 앱은 서버를 지웠다가 다시 추가합니다. 계정에서 연결을 끊었다면 다시 승인해야 합니다.
  • 노트를 부탁했는데 '읽기 전용'이라고 나오면 — 쓰기 없이 승인된 연결입니다. 다시 연결하면서 '진행 노트 작성도 허용'을 체크하세요.
  • 프로젝트나 작업이 안 보이면 — AI는 Madi에서 내가 열 수 있는 것만 봅니다. 먼저 해당 프로젝트 접근 권한을 확인하세요.
  • 데모 세션에서는 AI 앱을 연결할 수 없습니다 — 계정을 만들어 주세요.

아직 안 되는 것

작업 생성·수정·삭제, 날짜·진행률 변경, 댓글 작성은 AI 앱에서 할 수 없습니다. 쓰기는 진행 노트 작성 하나뿐입니다. 활동 기록은 최근 90일까지 조회됩니다.

요약

  • URL — https://madiplan.app/mcp
  • 연결 — URL을 MCP 서버로 추가 → 로그인 → 허용.
  • 범위 — Madi에서 나와 같은 범위, 쓰기는 허용한 경우만.
  • 연결 끊기 — 계정 → AI 연결 → 연결된 앱.