MCP 서버와 워크플로 도구

MCP 서버는 Ai Flowi의 AI Flowi Workflow를 클라이언트 및 외부 도구와 연결합니다. 프로젝트의 MCP Server는 선택한 워크플로를 호출 가능한 도구로 공개합니다. MCP Servers 설정은 워크플로용 외부 연결을 저장하고, MCP Client는 코딩 에이전트용 설정을 제공합니다. 프로젝트의 MCP Server JSON 화면에서는 SSE와 Streamable HTTP의 2가지 전송 방식을 제공합니다. 외부 MCP 연결은 STDIO도 지원합니다.

게시일 · 수정일

작성: Ai Flowi · 기술 검토: Janice Lee, Ai Flowi 기술 지원.

제품: Ai Flowi의 AI Flowi Workflow · 작업: 클라이언트와 워크플로 도구 연결 · 컴포넌트: 외부 서버 도구용 MCP Tools

사용 시점

MCP Server를 사용해 선택한 프로젝트 워크플로를 MCP 클라이언트에서 사용할 수 있게 합니다.

MCP Servers와 MCP Tools를 사용해 외부 서버의 도구를 워크플로에 가져옵니다.

MCP Client를 사용해 AI Flowi Workflow 인스턴스에서 워크플로를 만들고 실행하는 코딩 에이전트용 설정을 복사합니다.

시작하기 전

  • 공개할 프로젝트와 워크플로를 선택하거나 외부 서버의 연결 설정을 확보하세요.
  • 일반 계정 세션을 사용하세요. 지원 세션 중에는 MCP 설정이 숨겨집니다.
  • API 키는 비공개 클라이언트 설정에 보관하고 문서에서는 YOUR_API_KEY를 자리표시자로 사용하세요.
  • 프로젝트 인증 컨트롤은 MCP 컴포저 설정이 활성화된 경우에만 표시됩니다.

단계

1. MCP Server · Flows/Tools

프로젝트의 MCP Server 화면을 열고 Flows/Tools에서 도구 편집을 선택합니다.

도구 이름과 설명을 검토한 다음 이 클라이언트에서 사용할 워크플로만 활성화합니다.

저장된 도구 설정에는 각 워크플로의 이름, 설명, 활성화 상태가 포함됩니다.

2. 인증 · 인증 추가 / 인증 편집

인증 항목이 표시되면 인증 추가 또는 인증 편집을 선택하고 인증 방식을 검토합니다.

인증 방식은 없음, API 키, OAuth로 표시됩니다. 인증 요약에서는 인증되지 않은 프로젝트를 없음(공개)으로 표시합니다.

컴포저 설정이 비활성화되어 있으면 도구 선택을 저장할 때 인증 없음 설정을 사용하며, 생성되는 클라이언트 헤더는 인스턴스의 로그인 설정에 따라 달라집니다.

프로젝트 엔드포인트를 공유하기 전에 관리자와 함께 생성된 설정 및 접근 권한을 확인하세요.

3. JSON · 전송 방식

JSON을 선택하고 macOS/Linux, Windows 또는 WSL을 선택한 다음 전송 방식에서 SSE 또는 Streamable HTTP를 선택합니다.

생성된 설정을 MCP 클라이언트에 복사하고 YOUR_API_KEY 자리표시자가 있는 곳마다 비공개 환경에서 실제 키로 바꿉니다.

JSON 화면에 API 키 생성 작업이 표시되고 키가 필요한 경우 이를 사용합니다.

자동 설치를 사용하려면 AI Flowi Workflow가 로컬 컴퓨터에서 실행 중이어야 하고 선택한 클라이언트를 사용할 수 있어야 합니다. 원격 인스턴스에는 JSON을 사용하세요.

선택한 도구를 무해한 입력으로 테스트하고 클라이언트가 예상한 워크플로 응답을 받는지 확인합니다.

4. MCP Servers · MCP 서버 추가

설정에서 MCP Servers를 열고 MCP 서버 추가를 선택합니다.

서버 설정을 붙여 넣으려면 JSON을 선택합니다. Name, Command, Arguments, Environment Variables를 입력하려면 STDIO를 선택하고, Name, Streamable HTTP/SSE URL, Headers, Environment Variables를 입력하려면 Streamable HTTP/SSE를 선택합니다.

STDIO의 경우 설정한 명령과 필요한 의존성을 AI Flowi Workflow가 실행되는 서버에서 사용할 수 있는지 확인합니다.

서버 추가를 선택한 다음 저장된 연결의 도구 수 또는 오류 메시지를 확인합니다.

연결을 변경하려면 편집과 서버 업데이트를 사용합니다. 삭제를 선택하면 제거 전에 확인 창이 열립니다.

5. MCP Tools · MCP Server / Tool

워크플로에 MCP Tools를 추가하고 저장된 MCP Server를 선택한 다음 Tool을 선택하고 표시된 입력을 채웁니다.

컴포넌트를 실행하고 선택한 도구의 결과를 표로 반환하는 Response를 확인합니다.

HTTPS 연결에서는 Verify SSL Certificate를 활성화된 상태로 유지하세요.

컴포넌트의 Headers는 서버 설정에 저장된 헤더를 덮어씁니다.

6. MCP Client · Bob (IBM) / Claude Code

설정에서 MCP Client를 열고 Bob (IBM) 또는 Claude Code를 선택합니다.

Bob (IBM)에서는 설정 > MCP를 열고 전역 MCP 편집 또는 프로젝트 MCP 편집을 선택한 다음 표시된 JSON을 붙여 넣고 저장합니다.

Claude Code에서는 표시된 터미널 명령을 사용하거나 ~/.claude.json에 JSON 설정을 추가합니다.

클라이언트 설정은 현재 인스턴스 주소를 SERVER_URL로, YOUR_API_KEY를 API_KEY의 자리표시자로 사용합니다.

API 키 설정에서 키를 생성하고 비공개 설정의 자리표시자를 바꿉니다.

흔히 하는 실수

  • 프로젝트의 MCP Server를 MCP Servers에 저장된 외부 연결과 혼동하는 실수입니다.
  • 자동 설치가 원격 인스턴스에서도 작동한다고 여기는 실수입니다.
  • 실제 API 키가 포함된 생성 설정을 공유하는 실수입니다.
  • Tool을 선택하기 전에 서버 연결이 실행될 것으로 기대하는 실수입니다.

문제 해결

MCP 서버 설정 오류가 발생하면 클라이언트 설정을 생성하기 전에 프로젝트의 OAuth 설정을 수정하세요.

MCP Servers에서 시간 초과 또는 오류가 발생하면 서버 오류의 세부 정보를 확인하고 연결 설정을 검토하세요.

도구를 찾을 수 없다는 메시지가 표시되면 MCP Tools에서 외부 서버를 선택하기 전에 해당 서버가 도구를 공개하는지 확인하세요.

도구 이름이나 입력이 오래된 것으로 보이면 Use Cached Server를 꺼 최신 도구와 서버 업데이트를 가져오세요.

“이름과 명령이 필요합니다.” 또는 “이름과 URL이 필요합니다.”라는 메시지가 표시되면 서버를 추가하기 전에 필수 필드를 채우세요.

관련 문서

문서 · AI Flowi Workflow · 워크스페이스 · API Hub · 게시 · 워크플로를 웹 앱으로 게시 · 요금 · 데모 예약