MCP로 연결하기

Claude Code·Cursor 같은 AI 도구를 FLOWIT에 연결하면, 도구에서 말 한마디로 내 프로젝트의 태스크를 읽고 바꿀 수 있어요. 예를 들어 Claude Code에서 "PRJ-12 시작해 줘"라고 하면 칸반에서 PRJ-12가 진행 중 칸으로 옮겨져요.

한도·크레딧과 도구 목록은 API·MCP 안내에 있어요.

1. 개인 토큰 만들기

마이페이지의 "API·MCP"에서 이름·권한·만료를 정하고 "토큰 만들기"를 눌러요.

읽기: 프로젝트·스프린트·태스크를 보기만 해요.
읽기·쓰기: 태스크 만들기·고치기·댓글까지 해요.

토큰은 만들 때 한 번만 보여요. 바로 복사해서 안전한 곳에 두세요. 토큰을 만들면 메일로도 알려 드려요.

2. Claude Code에 연결하기

터미널에서 명령 하나로 추가해요. flw_… 자리에 내 토큰을 넣어요.

claude mcp add --transport http flowit \
  https://flowit-now.app/api/mcp \
  --header "Authorization: Bearer flw_…"

Windows PowerShell에서는 \ 없이 한 줄로 이어 붙여 입력해요.

추가한 뒤 Claude Code에서 "내 프로젝트 보여 줘"라고 해 보세요.

3. Cursor에 연결하기

프로젝트의 .cursor/mcp.json(모든 프로젝트에 쓰려면 ~/.cursor/mcp.json)에 넣어요. 토큰은 파일에 적지 말고 환경 변수 FLOWIT_TOKEN으로 두세요.

{
  "mcpServers": {
    "flowit": {
      "url": "https://flowit-now.app/api/mcp",
      "headers": { "Authorization": "Bearer ${env:FLOWIT_TOKEN}" }
    }
  }
}

4. Codex에 연결하기

터미널에서 명령 하나로 추가하거나 ~/.codex/config.toml에 넣어요. 토큰은 파일에 적지 말고 환경 변수 FLOWIT_TOKEN으로 두세요.

codex mcp add flowit \
  --url https://flowit-now.app/api/mcp \
  --bearer-token-env-var FLOWIT_TOKEN

config.toml에 직접 넣는다면:

[mcp_servers.flowit]
url = "https://flowit-now.app/api/mcp"
bearer_token_env_var = "FLOWIT_TOKEN"

5. 그 밖의 도구

원격 MCP(Streamable HTTP)를 지원하는 도구라면 주소 https://flowit-now.app/api/mcp와 헤더 Authorization: Bearer flw_…로 연결해요.

Claude 데스크톱·ChatGPT는 아직 연결할 수 없어요. 로그인으로 연결하는 방식을 준비하고 있어요.

6. 바꾼 내용은 활동 기록에

AI 도구로 바꾼 내용은 내가 한 일로 남아요. 태스크 활동 기록에 "김하나님이 Claude Code로 상태를 진행 중 → 리뷰로 바꿨어요"처럼 보여요.

FLOWIT 에이전트는 제안을 [적용]해야 반영되지만, AI 도구의 요청은 바로 반영돼요. 바꿀 일이 없으면 읽기 토큰을 쓰세요.

7. 토큰 끊기

마이페이지 "API·MCP" 목록에서 "폐기"를 누르면 그 토큰은 바로 끊겨요. 비밀번호를 다시 만들면 모든 토큰이 함께 끊겨요.