MCP

개요 · 연동

플로우 MCP 서버는 원격(remote) 방식입니다. Claude·ChatGPT 등 MCP 지원 AI 클라이언트에서 플로우 연결 시,
OAuth 인증으로 사용자 권한 범위 안에서 플로우 데이터를 읽고 씁니다. 현재 39개 도구를 제공합니다.

MCP

플로우를 AI 에이전트에 연결

클라이언트를 고르면 복붙용 설정 또는 한 번에 연결 링크를 드립니다.

서버 엔드포인트

https://flow.team/ai/mcp

1클라이언트 선택

→

2설정 추가 · 연결

→

3OAuth 승인

Claude Desktop 커넥터 추가 열기 ↗

설정 › 커넥터에서 '커스텀 커넥터 추가'를 엽니다(위 버튼).
서버 URL 칸에 위 플로우 엔드포인트를 붙여넣습니다.
OAuth 승인 화면에서 권한을 허용하면 연결이 완료됩니다.

도구 목록은 MCP 도구 목록에서 확인하세요.

인증 · 권한

MCP 클라이언트가 플로우에 접속할 때 OAuth 2.0 인증을 거칩니다.

AI 연동 범위(ai scope)에서 허용된 도구만 사용 가능합니다.

플로우 권한 모델

OAuth 승인

사용자가 MCP 클라이언트에서 플로우 연결을 요청하면, 플로우 로그인 및 권한 승인 화면이 표시됩니다.

토큰 발급

승인이 완료되면 access token이 발급되어 MCP 클라이언트에 저장됩니다.

권한 상속

MCP 도구는 인증된 사용자의 플로우 권한을 그대로 상속받습니다.

tools.json API

도구 메타데이터를 JSON으로 제공합니다.

GET https://flow.team/ai/mcp/tools.json?lang=ko

항목	값
인증	불필요 (Public)
CORS	허용
캐시	`Cache-Control: public, max-age=300` · 5분 서버 캐시

응답 스키마

필드	타입	도구 메타데이터를 JSON으로 제공합니다.
`version`	number	API 스키마 버전
`count`	number	도구 수 (39)
`tools[]`	array	도구 배열
`tools[].name`	string	고유 식별자
`tools[].title`	string	표시 이름
`tools[].domain`	string	도메인 분류
`tools[].description`	string	상세 설명(Markdown)
`tools[].explanation`	string	도구 사용 가이드
`tools[].examplePrompts`	string[]	예시 프롬프트 목록
`tools[].readOnly`	boolean	읽기 전용 여부
`tools[].destructive`	boolean	삭제/파괴 가능 여부
`tools[].requiresScope`	string \| null	필요 scope (null = 없음)

{
  "version": 1,
  "count": 39,
  "tools": [
    {
      "name": "flow_search",
      "title": "통합 검색",
      "domain": "search",
      "description": "## When to use …",
      "readOnly": true,
      "destructive": false,
      "requiresScope": null
    }
  ]
}

MCP