AI 어시스턴트 연결하기
Claude, ChatGPT 또는 다른 MCP 클라이언트를 고객 포털에 연결하세요. 어시스턴트는 프로젝트, 청구서, 지원 티켓, 사이트 상태와 파일을 읽을 수 있습니다. Pro 및 Ultra 플랜에서는 정확한 미리보기를 확인한 후에만 티켓을 열거나 변경 요청을 보낼 수 있습니다.
도구 및 사용 한도
플랜마다 고유한 한도가 있습니다. 서버는 키 개수, 키별 분당 요청 수, 계정 전체의 월간 단위를 적용합니다.
Basic
무료읽기 전용. 이 플랜에서는 쓰기가 불가합니다
프로젝트, 인보이스, 지원 티켓, 웹사이트 상태, 프로젝트 파일 및 월간 보고서 조회.
Pro
월 3,000,000 토만읽기와 확인된 쓰기
모든 읽기 도구와 확인된 쓰기: 지원 티켓 열기 및 답변, 변경 요청과 Farr 메시지 보내기, 파일 업로드, 콘텐츠 초안 만들기 및 수정, 제안 수락 또는 거절. 각 쓰기 작업은 먼저 미리보기로 표시되며 승인한 후에만 적용됩니다.
Ultra
월 5,000,000 토만Pro의 모든 기능, 대량 작업과 웹훅 포함
Pro의 모든 기능에 티켓 대량 작업(bulk_ticket_reply, bulk_ticket_close, bulk_actions. 호출당 최대 20개 티켓), 웹훅(webhook_list, webhook_create, webhook_delete), 예약된 월간 보고서(scheduled_reports, scheduled_reports_get)를 더합니다.
보안 설계: 결제 및 소유권 변경 작업 원천 배제
어시스턴트 API에는 인보이스 결제, 송금, 계정 소유권 변경, 키 관리 기능이 전혀 포함되어 있지 않습니다. 인보이스는 읽기 전용으로만 제공되며 결제는 고객 포털에서 직접 진행합니다.
어시스턴트 키 생성 방법
고객 포털에서 3단계로 간편하게 키를 생성하세요.
1. 포털 로그인
고객 포털에 로그인한 후 메뉴에서 '어시스턴트 접근 권한'을 선택합니다.
2. 키 생성
'키 생성'을 클릭하고 3~60자의 이름(예: 'Claude Code - 노트북')을 입력한 후 권한과 유효기간을 선택합니다. 생성 시 재인증이 요구됩니다.
3. 키 복사 및 보관
전체 키는 생성 직후 단 한 번만 표시됩니다. 서버는 보안 비밀의 SHA-256 해시만 보관합니다. 분실 시 키를 취소하고 새로 생성해야 합니다.
Claude 및 ChatGPT 연결 방법
MCP Streamable HTTP 전송 프로토콜을 사용하며, Bearer 키 또는 OAuth 로그인 인증으로 연동합니다.
Claude Code 및 MCP 클라이언트
서버 URL 및 헤더를 지원하는 도구(예: Claude Code의 .mcp.json 파일)에 다음 설정을 추가하고 발급받은 키를 입력하세요:
{
"mcpServers": {
"sajjad-portal": {
"type": "http",
"url": "https://sajjad.blog/api/client/mcp",
"headers": {
"Authorization": "Bearer <YOUR_AGENT_KEY>"
}
}
}
}ChatGPT 및 웹 어시스턴트
이 주소를 맞춤형 커넥터로 등록하고 안내에 따라 로그인(OAuth)을 진행하세요. 이 방식에는 별도 키가 필요하지 않습니다.
쓰기 작업의 '미리보기 후 승인' 프로세스
어떠한 변경사항도 최초 호출 시 즉시 적용되지 않습니다.
어시스턴트가 쓰기 도구를 호출하면 서버는 요청을 임시 저장하고 10분간 유효한 일회용 확인 토큰과 함께 미리보기를 반환합니다. 사용자가 동의한 후 어시스턴트가 해당 토큰으로 확인 도구를 호출해야만 최종 적용됩니다. 각 토큰은 동일 계정 및 동일 인자에 한해 1회만 동작합니다.
검증된 도구 레퍼런스
클라이언트 엔드포인트가 제공하는 주요 도구와 미리보기 후 사용하는 확인 도구입니다. 플랜에 없는 도구는 plan_required 메시지와 함께 거부됩니다.
| 도구명 | 접근 유형 | 기능 설명 |
|---|---|---|
| projects_list | 읽기 | 최대 50개의 프로젝트 목록 조회: 코드, 이름, 상태, 진행률 및 완료 예정일. |
| invoices_list | 읽기 | 최대 25개의 인보이스 목록 조회: 만기일, 총액, 납부액, 잔액 및 상태. openOnly로 미결제 항목만 필터링 가능. 초안 및 결제 링크 제외. |
| tickets_list | 읽기 | 최대 50개의 지원 티켓 목록 조회: 상태, 우선순위 및 최근 응답 시간. |
| ticket_get | 읽기 | 특정 티켓의 메시지 내역 조회(최대 100개 메시지). 내부 메모는 제외됩니다. |
| ticket_create | 승인 기반 쓰기 | 낮음 또는 보통 우선순위의 지원 티켓 초안 작성. 미리보기 승인 후 최종 등록. |
| ticket_reply | 승인 기반 쓰기 | 진행 중인 티켓에 대한 답변 초안 작성. 종료된 티켓은 회신 불가. 승인 후 발송. |
| change_request_create | 승인 기반 쓰기 | 프로젝트 변경 요청 초안 작성. 미리보기 승인 후 최종 반영. |
| site_status | 읽기 | 연결된 사이트의 도메인 상태, 방문자 및 페이지뷰(24시간 및 7일), 가동률(%), 미해결 오류 건수 표시. 최신 텔레메트리 동기화 기준. |
| files_list | 읽기 | 프로젝트 저장소 파일 목록 조회(페이지당 최대 100개, 폴더별 필터 가능). |
| file_link | 읽기 | 저장된 파일의 다운로드 링크 생성(유효기간 15분). |
| report_monthly | 읽기 | 월간 요약 보고서 조회(최대 12개월 전까지): 프로젝트, 티켓 개폐 현황, 사이트 상태, 청구 내역 및 15분 유효 PDF 링크. |
자주 묻는 질문
클라이언트 어시스턴트, 보안 및 사용 한도 관련 자주 묻는 질문입니다.
AI 어시스턴트가 자동으로 인보이스를 결제할 수 있나요?
아니요. 어시스턴트 API에는 결제나 송금 기능이 전혀 존재하지 않습니다. 인보이스는 내역 확인만 가능하며, 결제는 고객 포털에서 직접 진행하셔야 합니다.
월간 사용 한도에 도달하면 어떻게 되나요?
각 플랜에는 계정 전체를 위한 월간 단위 예산이 있습니다. 읽기는 1단위, 쓰기 미리보기는 3단위를 사용합니다. 계정의 월간 사용량이 플랜 예산에 도달하면 이후 호출은 도구 결과 안에 quota_exceeded 오류를 반환합니다(HTTP 429가 아닌 HTTP 200). UTC 달력상의 월이 바뀔 때까지 계속됩니다.
키가 유출된 경우 어떻게 취소하나요?
고객 포털의 '어시스턴트 접근 권한'에서 해당 키의 '키 취소'를 선택하고 확인하세요. 이후 해당 키를 이용한 요청은 즉시 차단됩니다. OAuth 연동도 동일한 페이지에서 해제 가능합니다.
ChatGPT 연결을 위해 로컬 브리지 소프트웨어가 필요한가요?
아닙니다. 표준 HTTPS 엔드포인트이므로 클라우드 기반 어시스턴트에서 별도의 로컬 소프트웨어 설치 없이 직접 연동할 수 있습니다.
지금 어시스턴트 연동을 시작해보세요
원하는 요금제를 선택하거나 고객 포털에서 어시스턴트 키를 생성하세요.