Claude Code·ChatGPT 등 AI 도구에서 UpServe 쓰기

UpServe의 AI 직원과 팀은 사용자가 자리를 비워도 계속 일합니다. 예약 실행이 돌고, 메일이 들어오면 처리하고, 자율 점검으로 스스로 할 일을 찾아요. 그래서 돌아오면 늘 소식이 쌓여 있습니다.

Claude Code, Claude, ChatGPT, Cursor 같은 AI 도구를 UpServe에 연결하면, 지금 쓰던 도구를 떠나지 않고 이런 일을 할 수 있어요.

“자리 비운 사이 무슨 일 있었어?”라고 물어 브리핑 받기
AI 직원 한 명, 또는 팀 전체에 일 맡기기
직원이 기다리고 있는 질문에 답하기
맡긴 일이 끝났는지 확인하고, 필요하면 멈추기
예약 실행 만들기, 바꾸기, 켜고 끄기

공개 상태: 이 기능은 단계적으로 열리고 있어요. 설정에 연결된 AI 앱 메뉴가 보이지 않으면 아직 내 계정에서 쓸 수 없는 상태입니다.

이런 식으로 말하면 돼요

연결한 AI 도구의 대화창에 평소 말투로 입력하면 됩니다.

이렇게 말하면	이런 일이 일어나요
”자리 비운 사이 무슨 일 있었어?”	처리할 일, 확인하지 않은 결과, 지금 일하는 직원, 곧 돌 예약 실행, 실패한 일, 사용량을 한 번에 알려줘요.
”영업 팀에 이번 주 견적 요청 정리해달라고 해줘”	팀에 일을 맡기고, 진행 상황을 확인해 결과를 알려줘요.
”리서치 직원이 나한테 뭐 물어보고 있어?”	기다리는 질문을 보여 줘요. 내가 정한 답을 말하면 그대로 전달해요.
”리서치 직원이 하는 일 멈춰줘”	지금 하는 일을 멈추도록 요청해요. 멈춤은 안전한 지점에서 이뤄져요.
”매주 월요일 오전 9시에 주간 리포트 쓰는 예약 실행 만들어줘”	시간과 지시를 확인한 뒤 예약 실행을 만들어요.

AI 도구는 직원이나 팀에게 일을 맡기기 전에 누구에게 맡길지 목록을 먼저 확인합니다. 이름이 비슷한 직원이 있으면 되물을 수 있어요.

AI 도구가 할 수 있는 일, 없는 일

할 수 있어요	할 수 없어요
직원·팀 목록, 결과, 처리할 일 보기	위험한 작업의 승인 (UpServe 앱에서 내가 직접 눌러야 해요)
직원·팀에게 일 맡기기, 진행 확인, 멈추기	직원 만들기, 수정하기
질문 카드에 내 답 전달하기	예약 실행 삭제 (앱에서 지워요)
예약 실행 만들기, 바꾸기, 켜고 끄기	앱의 읽음 표시 바꾸기

승인이 필요한 일이 생기면 AI 도구가 앱 링크를 알려 줍니다. 링크를 열어 직접 승인하세요. “이번 한 번 진행”처럼 승인과 같은 효과가 있는 선택지도 앱에서만 고를 수 있어요.

일을 맡기면 앱에서 직원과 대화할 때와 똑같이 처리됩니다. 같은 대화에 기록이 남고, 일반 실행으로 돌아가서 SU가 쓰여요. 사용량은 앱에서 맡길 때처럼 내 사용량으로 잡힙니다.

팀에 일을 맡겼는데 받은 팀원이 아무도 없으면, AI 도구가 그렇게 알려 줘요. 이때는 기다릴 일이 없으니 앱에서 팀 구성을 확인해 보세요.

연결하는 방법

Claude Code

터미널에서 아래 명령을 실행해요.


claude mcp add --transport http upserve https://api.upserve.app/mcp

Claude Code에서 /mcp를 입력하고 upserve를 골라 로그인해요.
브라우저에서 UpServe 동의 화면이 열리면 내용을 확인하고 허용을 누르세요.

Claude, ChatGPT

커넥터 설정에서 맞춤 커넥터를 추가해요.
주소에 https://api.upserve.app/mcp를 붙여 넣어요.
로그인 안내가 나오면 UpServe 계정으로 로그인하고 허용을 누르세요.

Cursor, 그 밖의 도구

UpServe 로그인을 지원하지 않는 도구는 연결 토큰으로 연결해요.

UpServe에서 설정 > 연결된 AI 앱을 열어요.
“연결 토큰 만들기”에 이름을 적고(예: 회사 노트북 Cursor) 토큰을 만들어요.
토큰은 지금 한 번만 보여요. 바로 복사해서 안전한 곳에 두세요.
도구의 MCP 설정에 주소 https://api.upserve.app/mcp와 헤더 Authorization: Bearer <토큰>을 넣어요.

토큰이 있으면 누구든 내 직원과 팀을 다룰 수 있어요. 비밀번호처럼 보관하세요.

동의 화면에서 확인할 것

AI 도구가 연결을 요청하면 UpServe가 동의 화면을 보여 줍니다.

돌아갈 주소를 보세요. “허용하면 이 주소로 돌아가요” 아래의 주소가 지금 쓰는 도구가 맞는지 확인하세요. 위에 보이는 앱 이름은 앱이 스스로 정한 것이라, 이름만으로 믿으면 안 돼요.
내가 방금 시작한 연결일 때만 허용하세요. 시작하지 않았는데 이 화면이 떴다면 취소를 누르세요.
경고 문구가 보이면 더 조심하세요. 돌아갈 주소를 UpServe가 확인하지 못하면 “확인할 수 없는 앱” 안내가 나와요. 앱 이름이 Claude나 ChatGPT처럼 잘 알려진 제품인데 주소가 그 제품의 것이 아니면 “다른 앱을 흉내 내고 있을 수 있어요”라는 강한 경고가 나오고, 직접 시작했다는 확인란을 체크하기 전까지 허용이 눌리지 않아요. 직접 시작한 게 아니라면 취소하세요.
허용하면 할 수 있는 일을 읽어 보세요. 보기, 일 맡기기, 예약 실행 관리 중 요청된 항목이 나와요. 요청된 항목은 한꺼번에 허용돼요.
승인이 필요한 위험한 작업은 허용한 뒤에도 계속 앱에서 직접 승인해야 해요.

연결 끊기, 다시 연결하기

끊기: 설정 > 연결된 AI 앱에서 앱 옆의 연결 끊기를 누르세요. 그 도구는 바로 UpServe를 쓸 수 없게 돼요. 이미 맡긴 일과 예약 실행은 계속됩니다. 직원이 하는 일이지 연결이 하는 일이 아니기 때문이에요.
자동 만료: 로그인으로 연결한 도구는 쓸 때마다 연결이 이어져요. 하지만 30일 넘게 한 번도 쓰지 않으면 연결이 끊겨, AI 도구에서 다시 로그인(Claude Code는 /mcp)해야 해요. 연결 토큰은 쓰는 것과 상관없이 만든 지 90일이 지나면 쓸 수 없으니 새로 만들어 바꿔 주세요. 연결 토큰은 최대 20개까지 만들 수 있어요.
권한이 부족할 때: 예를 들어 “보기”만 허용한 연결로 일을 맡기려 하면 AI 도구가 권한이 부족하다고 알려요. 다시 연결해서 필요한 항목을 허용하세요.

새 대화를 시작했을 때

AI 도구에서 새 대화를 열면 이전에 맡긴 일을 AI가 기억하지 못합니다. 걱정하지 마세요. 먼저 “브리핑해줘”라고 하면, 이 연결로 최근에 맡긴 일과 그 상태가 브리핑에 함께 나와서 이어서 확인할 수 있어요.

알아 두면 좋은 점

연결은 내가 앱에서 볼 수 있는 직원과 팀 전체에 적용돼요. 조직 공간의 직원도 포함됩니다. 직원이나 조직별로 따로 제한할 수는 없고, 허용한 항목(보기, 일 맡기기, 예약 실행 관리)으로만 좁힐 수 있어요.
직원이 질문을 기다리는 중이면 새 일을 맡길 수 없어요. 먼저 질문에 답해 달라고 안내해 줘요.
예약 시간은 내 시간대 기준으로 말하면 AI 도구가 변환해서 설정하고, 다음 실행 시각을 확인해 줘요. 한 번만 도는 예약도 만들 수 있어요.
자율 점검과 조건 감지는 AI 도구에서 켜고 끄기만 할 수 있어요. 내용을 바꾸려면 앱에서 하세요.
팀이 자동 운영을 꺼 둔 상태에서 멈춘 확인 요청에 AI 도구로 답하면, 답은 전달되지만 일은 계속 멈춰 있어요. 앱에서 자동 운영을 다시 켜야 이어집니다.
자리를 비운 사이의 알림은 앱 푸시와 메일이 계속 맡아요. AI 도구에는 돌아와서 물어볼 때 소식이 나와요.

고급 (Advanced)

아래 내용은 일반 사용자에게 필요하지 않습니다. 직접 연결 설정을 확인하거나 문제를 추적해야 할 때만 참고하세요.

연결 정보

항목	값
MCP 주소	`https://api.upserve.app/mcp` (원격 MCP, HTTP 방식)
로그인 방식	OAuth 2.1 + PKCE(S256). 클라이언트는 자동 등록
수동 연결	`Authorization: Bearer ups_mcp_...` 헤더

권한 범위

범위	할 수 있는 일
`upserve.read`	브리핑, 목록, 진행 확인, 예약 실행 조회
`upserve.work`	일 맡기기, 질문에 답하기, 멈추기
`upserve.manage`	예약 실행 만들기, 바꾸기, 켜고 끄기

연결 토큰은 세 범위를 모두 가집니다. 범위가 부족하면 도구가 필요한 범위를 알려 줍니다.

토큰 수명

토큰	수명
접근 토큰	1시간
갱신 토큰	30일. 쓸 때마다 새 값으로 바뀜. 이미 바뀐 옛 값이 다시 쓰이면 연결 전체가 회수됨
연결 토큰(수동)	90일, 갱신 없음

토큰은 UpServe 앱의 일반 화면용 API에는 쓸 수 없습니다.

도구 목록

도구	범위	하는 일
`get_briefing`	read	지난 브리핑 이후의 소식. 이 연결로 맡긴 최근 일 포함. 앱의 읽음 표시는 바꾸지 않음
`list_staff`	read	볼 수 있는 직원·팀 목록
`assign_task`	work	직원 또는 팀에게 일 맡기기
`check_task`	read	진행·결과·기다리는 질문 확인. 맡긴 일의 `message_id`를 주면 끝나거나 사용자가 필요할 때까지 최대 20초 대기(직원은 `message_id` 없이 현재 상태만 즉시 확인, 팀은 `message_id` 필수)
`answer_request`	work	직원 질문(`AGENT_QUESTION`), 팀 확인 요청(`TEAM_CONFIRMATION`)에만 답 전달. 승인 카드 등 나머지는 앱 링크로 안내
`stop_task`	work	하는 일 멈추기 요청
`list_automations`	read	예약 실행, 자율 점검, 조건 감지 조회
`save_automation`	manage	예약 실행 만들기·바꾸기. 자율 점검·조건 감지는 켜고 끄기만

호출 제한은 연결당 분당 읽기 60회, 쓰기 10회입니다.
예약 실행의 반복 시간(cron)은 5필드 형식이며 UTC로 해석됩니다. 한 번만 도는 예약(run_at)은 UTC 오프셋이 있는 시각이어야 합니다. AI 도구가 사용자 시간대에서 변환합니다.
예약 실행은 삭제 도구가 없습니다.
AI 도구로 새 예약 실행을 만들 때는 직원당 사람이 만든 활성 예약 20개가 상한입니다.
동의 화면의 경고는 서버가 판정합니다(redirect_host_verified, name_mismatch).
연결 토큰은 사용자당 활성 20개까지입니다.

많은 결과와 긴 결과 읽기

브리핑에 다 나오지 않은 항목은 AI 도구에 “나머지도 보여줘”라고 요청하세요. 결과 본문은 이어 읽을 수 있고, 다운로드가 허용된 첨부는 짧게 유효한 링크로 받을 수 있어요. 다운로드 횟수 제한이 있는 파일은 UpServe 앱에서 받아요. 이 조회는 앱의 읽음 표시를 바꾸지 않아요.

실행 상태를 확인할 수 없으면 “확인할 수 없음”으로 안내해요. 쉬고 있거나 완료됐다는 뜻은 아니에요. 같은 실행 도중 추가한 지시는 그 실행의 결과를 함께 받을 수 있어요.

개발자용: 일 맡기기와 예약 생성의 request_id는 새 요청마다 새로 만들고, 응답이 유실돼 재시도할 때는 같은 값과 같은 내용을 보내세요. 키는 연결별로 구분되며, 같은 키로 내용을 바꾸면 충돌 오류가 나요. 연결은 CIMD·DCR OAuth 및 수동 연결 토큰을 지원해요.