Skip to Content
AI 에이전트커넥터 & 인증

커넥터 & 인증

커넥터는 Stripe, BigQuery, 홈택스처럼 그리디 밖에 있는 서비스를 에이전트에 연결해, 데이터를 가져오거나 이메일·메시지를 보내는 작업을 할 수 있게 해 줍니다. 한 번 연결해 두면 “지난달 Stripe 결제 내역 가져와줘”처럼 자연어로 외부 데이터를 다룰 수 있습니다.

커넥터 개요

커넥터란?

커넥터는 외부 서비스를 에이전트의 도구로 만들어 줍니다. 연결된 서비스가 있으면 에이전트가 그 서비스의 데이터를 조회하거나 작업을 수행할 수 있습니다. 단, 활성화한 커넥터만 에이전트에게 노출되며, 연결하지 않은 서비스의 도구는 보이지 않습니다.

인증 방식 두 가지

서비스 연결은 인증 방식에 따라 두 가지로 나뉩니다.

OAuth 인증

서비스 로그인 화면에서 권한을 허용하면 연결됩니다. 별도의 키를 입력할 필요가 없습니다. 유저 메뉴 → 설정 → 연동 탭에서 서비스 카드의 연결 버튼을 눌러 진행합니다.

  • 대상: Gmail, Google Drive, Google Analytics, BigQuery, Slack

인증키 인증

서비스에서 발급한 API 키, 계정 정보, 또는 공동인증서(인증서 파일) 를 직접 등록합니다. 등록한 인증정보(credential)는 암호화되어 저장되며, 이를 사용하는 커넥터에 연결됩니다.

  • API 키: Stripe, Resend, Bolta, Spendit, 이카운트, SAP OData
  • 계정 정보: 은행, 이커머스
  • 공동인증서: 홈택스, 은행, 4대보험

DART 전자공시, 주식 시세, SEC EDGAR 같은 공개 데이터는 별도의 인증 없이 바로 사용할 수 있습니다.

연결 가능한 서비스

이메일

서비스설명인증 방식
GmailGoogle 계정으로 이메일 발송OAuth
Resend커스텀 도메인 이메일 발송API 키

파일 & 데이터

서비스설명인증 방식
Google DriveGoogle Drive 파일 불러오기OAuth
Google AnalyticsGA4 트래픽·사용자 행동·리포트 조회OAuth
BigQuery데이터셋·테이블 탐색 및 SQL 쿼리OAuth
Slack메시지 발송, 채널·사용자 조회, 검색OAuth

공시 & 시세

서비스설명인증 방식
DART국내 상장사 재무제표·공시 데이터인증 불필요
SEC EDGAR미국 상장사 공시·XBRL 재무 데이터인증 불필요

재무 & 결제

서비스설명인증 방식
Stripe고객·결제·구독·인보이스·잔액 조회API 키
홈택스(Hometax)세금계산서·현금영수증 매출/매입 조회공동인증서
은행국민·신한·하나·우리 등 잔액/거래내역 조회계정 정보 / 공동인증서
볼타(Bolta)전자세금계산서 발행·조회API 키

ERP & 비용 관리

서비스설명인증 방식
이카운트 ERP판매·구매·재고·생산·회계 데이터 조회·입력API 키
SAP ODataS/4HANA 판매·구매·생산·재고·회계 데이터API 키
스팬딧(Spendit)지출결의·경비 데이터 조회API 키
4대보험포털가입자 명부 조회공동인증서
이커머스배민·쿠팡·네이버·11번가 등 PG 매출 데이터계정 정보

지원 커넥터는 계속 추가되고 있으며, 일부 커넥터는 지역(국내/글로벌)에 따라 표시되지 않을 수 있습니다. 실제 목록은 앱에서 확인하세요.

인증키 등록하기

인증키 방식의 서비스는 인증정보를 먼저 등록해야 사용할 수 있습니다. 서비스에 따라 입력 양식이 다르며, 각 서비스에 맞는 등록 화면이 제공됩니다.

인증정보 등록 화면

API 키로 등록

등록 화면 열기

연결할 서비스의 인증정보 등록 화면을 엽니다.

키 입력

서비스에서 발급한 API 키 또는 인증 정보를 붙여넣습니다. (예: Stripe → 대시보드 → 개발자 → API 키의 시크릿 키 sk_live_...)

저장

저장하면 연결이 완료됩니다.

공동인증서(NPKI)로 등록

홈택스·은행·4대보험처럼 공동인증서가 필요한 경우는 다음과 같이 등록합니다.

인증서 폴더 선택

.der(서명용 인증서)와 .key(개인키) 파일이 들어 있는 인증서 폴더를 통째로 선택합니다. 폴더 위치를 모를 경우 등록 화면의 인증서 폴더 위치 안내를 참고하세요.

인증서 암호 입력

공동인증서 비밀번호를 입력합니다. 이 암호로 인증서가 암호화되어 저장됩니다.

사업자등록번호 입력

필요한 경우 사업자등록번호를 함께 입력합니다.

하나의 인증정보를 여러 커넥터가 함께 사용할 수 있습니다. 예를 들어 공동인증서 하나를 등록해 두면 홈택스·은행·4대보험에서 모두 활용할 수 있습니다.

채팅에서 커넥터 켜기

채팅 입력창 하단의 커넥터 버튼을 눌러 사용할 서비스를 선택한 뒤 요청을 입력하세요. 활성화된 커넥터의 도구만 이번 대화에서 사용됩니다.

채팅에서 커넥터 활성화

보안 & 연결 해제

  • 등록한 인증정보는 모두 암호화되어 저장되며, 공동인증서는 입력한 비밀번호로 암호화됩니다.
  • 인증정보는 등록한 폴더 범위 안에서만 사용되며, 권한이 없는 다른 사용자에게 노출되지 않습니다.
  • 연결을 해제하거나 인증정보를 삭제해도 이미 가져온 데이터에는 영향이 없습니다. 다만 이후 해당 서비스의 데이터를 새로 가져오는 작업은 할 수 없습니다.

API 키와 인증서는 민감한 정보입니다. 꼭 필요한 커넥터에만 등록하고, 더 이상 쓰지 않는 인증정보는 삭제해 주세요.

커스텀 커넥터 (MCP)

위 목록에 없는 서비스라도, 외부 MCP 서버를 직접 연결해 커스텀 커넥터로 사용할 수 있습니다. 자세한 방법은 커스텀 커넥터 (MCP) 문서를 참고하세요.

Last updated on