메인 콘텐츠로 건너뛰기

Documentation Index

Fetch the complete documentation index at: https://teeemai.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

커넥터는 Teeem AI가 회사의 기존 시스템(ERP, 그룹웨어, 클라우드)과 외부 서비스에 접근할 수 있게 해주는 모듈입니다. 모든 커넥터는 선택적이며 필요한 것만 활성화합니다.

​
Google Workspace

가장 많이 쓰이는 커넥터. 두 가지 모드를 지원합니다.

개인 OAuth 모드

각 직원이 본인의 Google 계정을 연결. 본인 메일·드라이브·캘린더만 접근.

서비스 계정 모드

조직 차원의 공용 Drive 폴더에 일괄 접근. 팀 자료 공유에 유용.
지원 작업:
  • Drive — 검색, 다운로드, 업로드, 폴더 정리
  • Gmail — 메일 검색·읽기, 메일 발송 (개인 OAuth는 gmail.readonly + gmail.send만 요청 — 최소 권한)
  • Calendar — 일정 조회·생성·수정, Meet 링크 자동 생성
  • YouTube — 채널 영상 조회, 업로드 (콘텐츠 팀용)

​
Microsoft 365

OneDrive, Outlook, Teams, Calendar 통합. 조직이 Microsoft 365 중심이라면 Google Workspace 대신 또는 함께 사용 가능합니다.

​
Notion

페이지 조회, 데이터베이스 쿼리, 페이지 생성·수정. 사내 위키나 프로젝트 트래커가 노션이라면 에이전트가 직접 읽고 씁니다.

​
한국 ERP·그룹웨어

커넥터지원 작업
더존(Douzone)매출세금계산서 조회, 전표 생성, 직원 정보 검색, 매출자료 엑셀 내보내기
위하고(Wehago)작업(Task) 생성, 메시지 발송, 결재 목록 조회, 파일 첨부
사용자: "@Teeem 어제 발행된 세금계산서 엑셀로 뽑아줘"
  ↓
에이전트가 더존에서 조회 → 엑셀 생성 → Slack 첨부 → "어제 발행된 23건의 세금계산서입니다."

​
한국 이커머스

커넥터지원 작업
Cafe24상품·주문·고객 조회, 재고 업데이트
네이버 스마트스토어주문 모니터링, CS 응대 자동화

​
한국 세무·신원확인

커넥터지원 작업
홈택스(Hometax)전자세금계산서, 사업자 등록 상태 확인
NICE사업자번호 검증, 신용 정보 조회
관세청(Customs)통관 상태 추적, HS 코드 조회

​
브라우저 자동화 (Browserbase)

API가 없거나 봇을 차단하는 사이트도 자동화할 수 있습니다.
  • 스텔스 모드 — webdriver: false 설정으로 쿠팡, 사람인 같은 사이트의 봇 탐지를 우회합니다
  • 접근성 트리 기반 — DOM selector 대신 ref(@e1, @e2)로 안정적인 요소 선택
  • 세션 유지 — 로그인 상태를 유지한 채 여러 작업 연속 수행
도구: browser_session, browser_navigate, browser_interact, browser_extract.

​
OpenAPI 스펙으로 커스텀 커넥터 만들기

기존 커넥터에 없는 외부 API라도 OpenAPI(Swagger) 스펙만 있으면 자동으로 도구가 생성됩니다. 
1. 관리자 콘솔 → 커넥터 → 새 OpenAPI 커넥터
2. OpenAPI 스펙 URL 또는 JSON 업로드
3. 인증 방식 설정 (API Key, OAuth, Basic 등)
4. 자동 생성된 도구 활성화
이렇게 만든 커넥터도 표준 커넥터처럼 에이전트가 자연어로 호출할 수 있습니다.

​
동적 HTTP 도구

OpenAPI 스펙이 없는 단순 API는 dynamic_http 도구로 직접 호출 가능합니다. 
@Teeem 이 API를 호출해줘:
  POST https://internal.api/orders
  Header: Authorization: Bearer xxx
  Body: { "id": 123 }

​
커넥터 보안 원칙

  • 시크릿 격리 — API 키와 토큰은 AWS Secrets Manager / SSM에 저장. 메모리에서도 마스킹.
  • 최소 권한 — 가능한 가장 좁은 스코프만 요청
  • 토큰 갱신 — 만료 임박 시 자동 갱신, 갱신 실패 시 재연결 프롬프트 노출 후 stale 토큰 삭제
  • 감사 로깅 — 외부 API 호출은 모두 감사 로그에 기록 (호출 시각, 사용자, 엔드포인트)
  • 연결 해제 시 토큰 폐기 — Google/MS의 폐기 API를 호출해 즉시 무효화