쓰던 AI 도구에서 FLOWIT 프로젝트를 바로 다뤄요

개인 토큰으로 연결하면 Claude Code·Cursor 같은 AI 도구가 내 프로젝트의 스프린트·태스크를 읽고, 내 권한 안에서 바로 바꿔요. 바꾼 내용은 내가 한 일로 활동 기록에 남아요.

토큰 만들기 연결 문서

이렇게 써요

Claude Code에서“PRJ-12 시작해 줘”
칸반에서PRJ-12가 진행 중 칸으로
끝나면“PRJ-12 끝났어, 리뷰로 옮겨 줘” → 리뷰 칸으로

활동 기록에는 “김하나님이 Claude Code로 상태를 진행 중 → 리뷰로 바꿨어요”처럼 남아요.

연결하기

1. 개인 토큰 만들기

마이페이지 → API·MCP에서 이름·권한·만료를 정해 만들어요. 토큰은 만들 때 한 번만 보여요.

2. Claude Code

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

Claude Code 연결 명령

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

Cursor

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

Cursor mcp.json

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

Codex

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

Codex 연결 명령

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

Codex config.toml

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

그 밖의 도구

원격 MCP(Streamable HTTP)를 지원하면 아래 주소와 헤더로 연결해요.

원격 MCP 주소와 헤더

주소  https://flowit-now.app/api/mcp
헤더  Authorization: Bearer flw_…

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

REST API

MCP가 아니어도 같은 기능을 /v1로 부를 수 있어요. OpenAPI 문서

REST 호출 예

curl -H "Authorization: Bearer flw_…" \
  https://flowit-now.app/api/v1/projects

도구 8개

도구	하는 일	이렇게 말해요
`list_projects`	내 프로젝트와 진행 중 스프린트	내 프로젝트 보여 줘
`get_active_sprint`	진행 중 스프린트(기간·목표)	PRJ 이번 스프린트 언제 끝나?
`list_tasks`	태스크 목록(스프린트·상태·담당자로 거르기)	이번 스프린트에서 내가 맡은 일
`get_task`	태스크 내용과 최근 댓글	PRJ-12 내용 알려 줘
`get_sprint_summary`	상태별 개수·완료율·남은 날·지연	이번 스프린트 어때?
`create_task`쓰기	태스크 만들기	‘알림 설정 화면’ 태스크 만들고 나한테 맡겨 줘
`update_task`쓰기	상태·담당자·마감·제목·설명 바꾸기	PRJ-12 시작해 줘
`add_comment`쓰기	댓글 달기	PRJ-12에 ‘API 연결 끝, 리뷰 부탁’ 남겨 줘

읽기 토큰이면 바꾸는 도구 3개(만들기·고치기·댓글)는 보이지 않아요.

한도와 크레딧

한도를 불러오는 중…

안전하게

토큰은 만들 때 한 번만 보이고, 서버에는 원문을 저장하지 않아요.
내가 멤버인 프로젝트만 보고 바꿀 수 있어요. 멘토는 읽기와 댓글만 돼요.
토큰을 폐기하거나 비밀번호를 다시 만들면 바로 끊겨요. 새 토큰을 만들면 메일로 알려 드려요.
FLOWIT 에이전트와 달리 AI 도구의 요청은 바로 반영돼요. 바꾸는 권한이 필요 없으면 읽기 토큰을 쓰세요.