플로우 API / MCP 기능 관련 자주 묻는 질문 🔍

AI Work Agent 플로우에서 제공하는 API 및 웹훅 기능과 관련해, '자주 묻는 질문' 형태로 주요 내용을 정리해 보았습니다.

Q1. 플로우에서 API 기능을 사용하려면 어떤 요금제를 이용해야 할까요?

우선 현재 플로우는 '비즈니스 플랜' 하나의 요금제로 단일 운영되고 있습니다. 플로우의 API 기능은 해당 요금제 기반의 '기업 소속 유료 계정(비즈니스 계정)' 사용 시에만 이용이 가능합니다. 비즈니스 계정 최초 가입 시 제공되는 14일 무료체험 기간 중에도 API 기능을 이용해 보실 수 있으니, 도입 전에 충분히 테스트해 보시는 것을 추천드려요! 😊

단, 무료 외부인 계정(게스트 계정) 사용 시에는 기능 이용이 불가하니 참고해 주세요!

Q2. API 인증(토큰/키)은 어떻게 발급받나요?

기업 내 관리자(어드민)가 개발자 포털에서 로그인 한 뒤, 키 관리 페이지 에서 직접 생성하실 수 있습니다.

TIP. 발급받은 인증 정보(토큰/키)는 보안을 위해 외부에 노출되지 않도록 안전하게 관리해 주세요!

Q3. 알림봇 ID는 몇 개까지 만들 수 있나요?

알림봇 ID는 기업 당 최대 2개까지 생성 가능합니다.

Q4. API 호출이 실패하면 어떻게 해야 하나요?

API 호출이 실패하는 경우, 아래 항목을 순서대로 확인해 주세요!

1. 인증 정보 확인 — 토큰/키가 올바르게 입력되었는지 확인해 주세요. (Getting Started > Authorization 참고)

2. 요청 형식 확인 — 각 API 문서의 Request 탭에서 필수 값과 형식이 맞는지 확인해 주세요.

3. 에러 내용 확인 — 각 API 문서의 Error 탭에서 반환된 에러 코드의 원인과 대응 방법을 확인하실 수 있어요.

위 사항을 모두 확인했음에도 문제가 지속된다면, 개발자 포털 좌측 하단의 '의견 보내기' 버튼 또는 플로우 문의 채널로 말씀해 주세요. 빠르게 도와드리겠습니다! 🙌

Q5. 채팅방 및 프로젝트의 '연동코드'가 보이지 않아요.

특정 채팅방 혹은 프로젝트에서 연동코드가 확인되지 않는 경우, 개발자 포털 좌측 하단의 '의견 보내기' 버튼 또는 플로우 문의 채널로 문의 주시는 경우 빠르게 도움 드릴 수 있도록 하겠습니다!

Q6. 플로우에서 MCP 기능은 어떻게 제공되나요?

플로우에서 제공되는 MCP 서버는 원격(remote) 방식입니다. Claude·ChatGPT 등 MCP 지원 AI 클라이언트에서 플로우를 연결할 시, OAuth 인증으로 사용자 권한 범위 안에서 flow 데이터를 읽고 씁니다. 현재 45개 도구를 제공합니다. 자세한 내용은 여기 링크 를 눌러 확인할 수 있습니다.

📌 더 자세한 내용은 개발자 센터(OPEN API 센터)에서 확인하세요!

기능 연동 중 문제가 발생하거나 도입 관련 추가 문의가 있으시면, 언제든 채팅 또는 홈페이지 문의 채널로 편하게 말씀해 주세요. 😊