AI 채팅 연결하기

원격 MCP(Model Context Protocol) 서버를 지원하는 AI 채팅에서 FastBI 데이터를 탐색하고 분석을 실행하며 보고서를 조회할 수 있습니다. 클라이언트는 승인한 범위 안에서만 접근합니다.

OAuth로 연결하기

FastBI에서 User settings → Connect your AI with MCP를 열고 MCP server URL을 복사합니다. 운영 서비스 URL은 https://fastbi.app/api/mcp/v1입니다.
AI 클라이언트의 통합 또는 MCP 설정에 URL을 추가합니다. 필요한 경우 전송 방식은 Streamable HTTP, 인증 방식은 OAuth를 선택합니다. 메뉴 이름은 클라이언트마다 다릅니다.
연결을 시작하고 Google, Microsoft 또는 이메일과 비밀번호로 FastBI에 로그인합니다.
Connect … 화면에서 앱 이름과 Return address를 확인합니다. Organization을 선택하고 Allow access to에서 필요한 기능만 선택한 뒤 Allow access를 누릅니다. 거절하려면 Cancel을 선택합니다.
채팅으로 돌아가 필요한 경우 해당 대화에서 FastBI를 활성화하고 사용 가능한 기능 목록을 요청합니다.

로그인은 신원을 확인하는 단계입니다. 별도의 승인 단계에서 선택한 조직에 대한 접근을 허용하며, 모든 소속 조직이 자동으로 연결되지는 않습니다.

MCP 서버 URL을 복사하고 AI 클라이언트에 허용할 기능을 선택합니다.

허용할 기능 선택하기

Catalog: 연결된 데이터와 스키마 탐색.
Reports: 보고서 읽기 및 저장된 위젯 실행.
Ad hoc analysis: 질문 및 분석 실행.
SQL Workbench: 쿼리 계획, SQL 실행, 결과 읽기.

AdHoc 및 SQL에는 Analyst 역할이 필요합니다. 유효한 워크스페이스 멤버십과 권한도 계속 적용됩니다. 요청한 데이터는 AI 클라이언트로 전송되며 분석과 쿼리는 일반 FastBI 크레딧을 사용합니다.

한 번 조회하기

소스, 지표, 기간, 시간대, 제외 조건을 명시하세요. 다음 예를 실제 데이터에 맞게 바꿀 수 있습니다.

FastBI를 사용해 최근 완료된 4주간의 주별 순매출을 USD로 보여 주세요. 주문 소스를 사용하고 취소 주문은 제외하며 보고서 시간대를 적용하세요. 차트, 조회 기간, 사용한 소스도 포함하세요.

클라이언트는 적절한 저장 보고서를 사용하거나 AdHoc 분석을 시작할 수 있습니다. 추가 확인 질문에 답하고 실행이 끝나면 필터와 합계를 검토하세요. 후속 질문은 같은 대화에서 이어갑니다. 클라이언트에서 차트를 표시할 수 없다면 FastBI에서 결과를 여세요.

주기적으로 조회하기

예약 실행 중 인증된 MCP 호출을 지원하는 AI 클라이언트나 자동화 도구에서 일정을 설정합니다. FastBI 연결만으로 일정이 생성되지는 않습니다. 이 기능이 없는 클라이언트에서도 일회성 조회는 가능합니다.

반복 조회할 지표와 필터를 담은 저장 보고서를 만듭니다.
이전 답변을 반복하는 대신 해당 위젯을 실행해 새 결과를 가져오도록 요청합니다. 클라이언트의 스케줄러에서 기간, 시간대, 빈도, 전달 위치를 설정합니다.
수동으로 한 번 실행하여 기간과 데이터 최신성을 확인한 뒤 일정을 활성화합니다.

매 평일 09:00 Asia/Bangkok에 FastBI의 “일일 매출” 보고서에서 “매출” 위젯을 실행해 직전의 완료된 하루를 조회하세요. 매출, 주문 수, 그 전날 대비 변화, 조회 기간, 데이터의 마지막 갱신 시점을 알려 주세요.

보고서와 위젯 이름을 워크스페이스에 맞게 바꾸고 클라이언트에 저장된 일정을 확인하세요. FastBI Jobs는 선택한 데이터를 Lake로 동기화하고, AI 클라이언트의 일정은 그 데이터를 조회합니다. 필요한 동기화가 성공한 뒤 조회하도록 설정하세요. 매 실행마다 크레딧이 사용될 수 있습니다.

OAuth 동작, 만료 및 접근 취소

승인 후 클라이언트는 반환 주소에서 짧은 유효기간의 인가 코드를 받습니다. PKCE를 사용해 이 코드를 액세스 토큰과 갱신 토큰으로 교환합니다. FastBI 비밀번호를 AI 클라이언트에 입력할 필요는 없습니다.

액세스 토큰의 유효기간은 최대 1시간입니다. 호환 클라이언트는 30일의 인가 기간 안에서 자동으로 갱신합니다. 이후에는 다시 연결하고 승인해야 합니다. 토큰 갱신이 인가 기간을 무기한 연장하지는 않습니다. 예약 실행도 유효한 인가가 필요합니다.

접근을 취소하려면 User settings → Connect your AI with MCP → Connected AI apps → Revoke를 선택합니다. 이후 접근은 중단되지만 클라이언트가 이미 받은 데이터는 삭제되지 않습니다.

수동 토큰 사용하기

Manual access tokens에서 연결 이름을 입력하고 Allowed features를 선택한 뒤 Create access token을 누릅니다. 한 번 표시되는 토큰을 복사해 같은 MCP URL에 대한 클라이언트의 Bearer 토큰 필드에 넣으세요. 채팅이나 공유 설정에는 붙여 넣지 마세요. 여기서 만든 토큰은 30일 후 만료되며 User settings에서 취소할 수 있습니다.

연결이 실패하면 만료일, 조직, 승인된 기능, 역할을 확인하세요. 결과가 오래되었다면 보고서 기간과 마지막으로 성공한 동기화를 확인합니다. 외부 MCP 데이터 소스를 FastBI에 추가하려면 MCP integrations를 참고하세요.