TFlow MCP 연동 가이드 (외부 AI 챗봇 연결)
Claude Desktop·ChatGPT 같은 외부 AI 챗봇을 TFlow에 연결하는 방법을 안내합니다. 제공되는 도구 목록, 플랫폼별 설정 방법, 실제 사용 시나리오, 미리 준비된 프롬프트, 자주 묻는 질문 순서로 다룹니다.
최종 업데이트: 2026-04-01
개요
TFlow MCP(Model Context Protocol)를 사용하면 Claude Desktop, ChatGPT 등 외부 AI 챗봇에서 TFlow 데이터에 직접 접근할 수 있습니다.
대화형으로 프로젝트 현황 확인, 문서 조회, 할일 관리, IRR 분석 요청 등을 수행할 수 있어 별도 웹 접속 없이도 업무를 처리할 수 있습니다.
지원 플랫폼
| 플랫폼 | 연결 방식 | 상태 |
|---|---|---|
| Claude Desktop | MCP Server (stdio) | ✅ 지원 |
| ChatGPT | MCP Streamable HTTP + OAuth 2.1 | ✅ 지원 |
| 기타 MCP 호환 앱 | MCP 프로토콜 지원 클라이언트 | ✅ 지원 |
무엇을 할 수 있나요?
| 카테고리 | 예시 질문 |
|---|---|
| 프로젝트 현황 | "내 프로젝트 목록 보여줘", "143번 프로젝트 현황은?" |
| 할일 관리 | "이번 주 할일", "태스크 완료 처리해줘", "새 태스크 추가해줘" |
| 문서 관리 | "올라온 서류 확인", "LC 문서 분석 결과", "문서 업로드해줘" |
| 알림 확인 | "새 알림 있어?", "긴급한 거 뭐야", "알림 읽음 처리해줘" |
| 통관 분석 | "IRR 분석 돌려줘", "통관 준비 됐어?" |
| LC 리스크 | "LEO 리포트 보여줘" |
| 브리핑 | "오늘 뭐 해야 해?", "아침 브리핑" |
| 코멘트 | "프로젝트에 메모 남겨줘" |
| 토큰/시스템 | "토큰 잔액 확인", "시스템 공지사항 보여줘" |
제공 도구 목록
TFlow MCP는 다음 도구들을 제공합니다:
| 카테고리 | 도구 | 설명 |
|---|---|---|
| 프로젝트 | get_projects | 프로젝트 목록 및 현황 조회 |
get_project_overview | 프로젝트 상세 현황 (거래 정보, 문서, 멤버) | |
| 태스크 | list_my_tasks | 할일/태스크 목록 조회 |
create_task | 새 태스크 생성 | |
update_task | 태스크 상태 변경, 내용 수정 | |
| 문서 | get_documents | 프로젝트 문서 목록 조회 |
get_document_detail | 문서 상세 정보 (AI 분석 결과 포함) | |
upload_document | 무역 문서 업로드 | |
| 알림 | get_notifications | 알림 목록 조회 |
get_urgent_alerts | 긴급 알림 종합 조회 | |
get_daily_briefing | 오늘의 종합 업무 브리핑 | |
mark_notifications_read | 알림 읽음 처리 | |
| 분석 | get_irr_report | IRR(수입 준비도) 보고서 조회 |
request_irr_analysis | IRR 분석 요청 (비동기, 1-3분) | |
get_leo_report | LEO LC 리스크 분석 보고서 조회 | |
| 코멘트 | add_project_comment | 프로젝트에 코멘트 추가 |
| 시스템 | get_token_balance | AI 토큰 잔고 및 사용량 조회 |
get_system_context | 사용자 프로필, 시스템 상태 | |
get_server_notices | 시스템 공지사항 | |
get_recent_activity | 최근 활동 피드 |
설정 방법
연결 방법은 두 가지입니다. Claude Desktop은 TFlow에서 발급한 **API 키(PAT)**를 설정 파일에 넣어 연결하고, ChatGPT는 OAuth 로그인(Google·Kakao)으로 연결합니다. 평소 쓰는 앱에 맞는 방법을 고르세요.
방법 1: Claude Desktop에서 연결
Step 1: TFlow에서 API 키 발급
- TFlow 웹 로그인
- Settings → My Subscription → 외부 연동 탭 이동
- API 키 발급 클릭
- 발급된 키를 복사 (⚠️ 한 번만 표시됩니다!)
💡 API 키는
pat_tflow_...형태입니다. 안전한 곳에 보관하세요.
Step 2: Claude Desktop에 TFlow 연결
- Claude Desktop 앱 실행
- Settings → MCP Servers 메뉴 이동
- TFlow 서버 추가:
방법 A: 설정 파일 직접 편집
~/Library/Application Support/Claude/claude_desktop_config.json 파일을 열고:
{
"mcpServers": {
"tflow": {
"command": "node",
"args": ["/path/to/tflow-mcp-server/index.js"],
"env": {
"TFLOW_API_URL": "https://api.tflowx.com",
"TFLOW_API_KEY": "pat_tflow_여기에_발급받은_키_붙여넣기"
}
}
}
}
방법 B: TFlow 웹에서 복사
외부 연동 탭의 Claude Desktop 설정 복사 버튼을 클릭하면 위 설정이 자동으로 클립보드에 복사됩니다.
- Claude Desktop 재시작
Step 3: 연결 확인
Claude Desktop에서 다음과 같이 물어보세요:
"내 TFlow 프로젝트 목록 보여줘"
프로젝트 목록이 표시되면 연결 성공입니다!
방법 2: ChatGPT에서 연결
ChatGPT는 OAuth 2.1 기반 인증을 사용하여 TFlow에 연결합니다. API 키를 직접 관리할 필요 없이, 소셜 로그인(Google/Kakao)으로 간편하게 인증할 수 있습니다.
Step 1: ChatGPT에서 TFlow 찾기
- ChatGPT를 열고 대화 입력창 하단의 도구(Tools) 또는 플러그인 메뉴를 확인합니다.
- MCP 서버 목록에서 TFlow를 검색합니다.
Step 2: OAuth 로그인
- TFlow 연결을 선택하면 TFlow 로그인 화면이 팝업됩니다.
- Google 또는 Kakao 계정으로 로그인합니다 (TFlow에 가입된 계정과 동일해야 합니다).
- 권한 승인 화면에서 ChatGPT가 TFlow 데이터에 접근하는 것을 허용합니다.
Step 3: 연결 확인
"TFlow 프로젝트 현황 보여줘"
프로젝트 목록이 표시되면 연결 성공입니다!
💡 Claude Desktop vs ChatGPT 차이점:
- Claude Desktop: PAT(API 키) 기반 — 설정 파일에 키를 직접 입력
- ChatGPT: OAuth 2.1 기반 — 소셜 로그인으로 자동 인증, 토큰 자동 갱신
사용 시나리오
아침 업무 시작
"아침 브리핑 해줘"
→ 오늘 할일, 마감 임박 건, 긴급 알림을 한번에 확인
"읽지 않은 알림 확인"
→ 새로운 문서 분석 완료, 코멘트 등 확인
프로젝트 현황 파악
"143번 프로젝트 현황 보여줘"
→ 거래 정보, 문서 상태, 할일 진행률, 멤버 목록
"이 프로젝트 문서 목록"
→ 업로드된 서류와 분석 상태 확인
"CI 문서 분석 결과 보여줘"
→ AI가 추출한 상세 데이터 확인
통관 준비도 분석 (IRR)
"프로젝트 143 통관 분석 해줘"
→ IRR 분석 요청 (1-3분 소요)
"알림 확인" (잠시 후)
→ "IRR 분석 완료" 알림 확인
"IRR 결과 보여줘"
→ Blocker, Warning, 확인필요 항목 상세 리포트
할일 관리
"이번 주 마감인 할일"
→ 마감 임박 태스크 목록
"Health Certificate 발급 요청 태스크 완료 처리해줘"
→ 태스크 상태 변경
"143번 프로젝트에 '선적서류 검토' 태스크 추가해줘"
→ 새 태스크 생성
LC 리스크 분석
"143번 프로젝트 LEO 리포트 보여줘"
→ 신용장 리스크 분석 결과 확인
"리스크 HIGH 항목만 따로 정리해줘"
→ AI가 리포트에서 고위험 항목 추출
사전 제공 프롬프트
Claude Desktop에서 TFlow 프롬프트를 바로 사용할 수 있습니다:
| 프롬프트 | 설명 |
|---|---|
tflow_start_here | TFlow 시작하기 — 프로필, 기능 안내, 공지 확인 |
tflow_morning_briefing | 아침 브리핑 — 긴급 알림 + 오늘 할일 + 주간 현황 |
tflow_project_review | 프로젝트 리뷰 — 특정 프로젝트 상세 현황 |
tflow_whats_new | 새 소식 — 시스템 공지 + 최근 변경사항 |
💡 ChatGPT에서도 위 프롬프트와 유사한 질문을 자유롭게 할 수 있습니다. 프롬프트 이름을 사용할 필요 없이 자연어로 물어보면 됩니다.
FAQ
API 키를 잃어버렸어요
Settings → My Subscription → 외부 연동에서 재발급 버튼을 클릭하세요. 기존 키는 즉시 폐기되고 새 키가 발급됩니다.
Claude에서 "API 키가 유효하지 않습니다" 오류가 나요
- API 키가 만료되었을 수 있습니다 (기본 90일). 재발급하세요.
- 설정 파일의 키가 정확히 복사되었는지 확인하세요 (앞뒤 공백 주의).
- Claude Desktop을 재시작해보세요.
ChatGPT에서 TFlow 연결이 안 돼요
- TFlow에 가입한 것과 동일한 Google/Kakao 계정으로 로그인했는지 확인하세요.
- 팝업 차단이 되어 있다면 브라우저 설정에서 허용해주세요.
- OAuth 인증 토큰이 만료된 경우, ChatGPT에서 TFlow 연결을 해제 후 다시 연결하세요.
특정 프로젝트 데이터가 안 보여요
본인이 멤버로 참여한 프로젝트만 접근할 수 있습니다. TFlow 웹에서 해당 프로젝트의 Parties(거래 당사자) 탭을 확인하세요.
문서 내용은 볼 수 있나요?
문서 메타데이터(파일명, 분석 상태 등)와 AI 분석 결과는 조회할 수 있습니다. 원본 파일 다운로드는 get_document_detail의 view: "full" 옵션으로 S3 URL을 받을 수 있습니다.
토큰이 차감되나요?
MCP를 통한 데이터 조회(프로젝트, 문서, 알림 등)는 토큰을 소모하지 않습니다. 단, IRR 분석(request_irr_analysis)은 AI 에이전트를 실행하므로 토큰이 차감됩니다.
Claude Desktop과 ChatGPT 중 어떤 걸 쓰는 게 좋나요?
두 플랫폼 모두 동일한 TFlow 도구에 접근합니다. 평소 사용하는 AI 챗봇을 그대로 쓰면 됩니다. Claude Desktop은 API 키 방식으로 설정이 간단하고, ChatGPT는 소셜 로그인으로 더 편리하게 연결할 수 있습니다.