ChatGPT

ChatGPT 웹

사전 준비

• 플러그인을 사용할 수 있는 ChatGPT 요금제
• 워크스페이스(팀·엔터프라이즈) 계정은 관리자의 플러그인 사용 허용이 선행되어야 할 수 있습니다.

단계별 연결 방법(웹)

1. ChatGPT 설정에서 개발자 모드를 활성화합니다(필요에 따라 설정하며 생략해도 무방합니다).
2. 왼쪽 사이드바에서 플러그인 메뉴를 엽니다(보이지 않으면 더 보기를 눌러 찾을 수 있습니다).

   2

3. +를 눌러 새 플러그인을 만듭니다. 이름에 조인트, 연결은 서버 URL을 고르고 https://mcp.joint.now(경로·끝 슬래시 없음), 인증은 OAuth를 선택합니다. 고급 OAuth 설정은 비워 둡니다.

   3

4. 맞춤형 MCP 서버 위험 안내에 체크하고 만들기를 누릅니다. 조인트 로그인 화면이 열리면 로그인 후 동의 화면에서 요청 권한(워크스페이스 조회·메시지 보내기·챙기기 관리)을 확인하고 허용합니다.
5. 등록이 끝나면 플러그인 상세 또는 채팅에서 바로 사용할 수 있습니다.

권한 승인 과정

동의 화면은 조인트 인증 서버가 표시합니다. ChatGPT는 URL 기반 자기 등록(CIMD) 클라이언트이므로 동의 화면에 "미검증" 표시가 함께 나타날 수 있습니다. 요청 권한이 워크스페이스 조회와 메시지 보내기·챙기기 관리인지 확인하고 허용하면 됩니다. 쓰기 권한을 허용하면 ChatGPT가 내 이름으로 메시지를 보내고 챙기기를 관리할 수 있으며, 실행 전에 ChatGPT가 내용을 보여 주고 확인을 받습니다. 이미 조회용으로 연결해 두었다면 플러그인 연결을 해제하고 다시 연결하는 것을 권장합니다.

연결 확인 방법

• 플러그인 목록에 조인트가 "연결됨"으로 표시됩니다.
• 조인트 플러그인을 활성화한 대화에서 "내 조인트 워크스페이스 알려 줘"가 동작합니다.

알려진 제한 사항

• 조인트 측 호출 빈도 제한(사용자당 1분 60회, 조회와 쓰기 합산)을 넘으면 잠시 후 다시 시도해야 합니다.

연결해제

• 플러그인 목록에서 조인트 플러그인을 삭제하거나 비활성화합니다. 해제하는 즉시 이후의 모든 조회와 쓰기가 차단됩니다.

자주 발생하는 오류

ChatGPT 데스크톱 앱

사전 준비

• ChatGPT 데스크톱 앱 최신 버전. 이전 버전에서는 인증이 되지 않을 수 있습니다.
• 기업·조직 계정을 쓴다면, 조직 관리자가 외부 MCP 서버 연결을 차단해 두었을 수 있습니다. 이 경우 관리자 콘솔에서 Joint MCP 서버 주소(https://mcp.joint.now) 승인이 필요할 수 있습니다.

단계별 연결 방법

1. 데스크톱 앱의 플러그인 화면에서 오른쪽 위 추가 → MCP 서버 추가를 선택합니다.

   

2. 맞춤형 MCP에 연결 화면에서 이름은 영어로(예: joint), 유형은 스트리밍 가능한 HTTP를 고르고, URL에 https://mcp.joint.now를 경로·끝 슬래시 없이 입력한 뒤 저장합니다. 이름을 한글로 입력하면 -로 바뀌어 저장됩니다.

   

3. MCP 서버 목록에서 등록한 서버 옆의 인증을 선택합니다.

   

4. 브라우저에 조인트 화면이 열리면 로그인하고, 동의 화면에서 요청 권한을 확인한 뒤 연결 허용을 누릅니다.

   

권한 승인 과정

동의 화면은 조인트 인증 서버가 표시합니다. 요청 권한은 워크스페이스 조회(대화방·메시지·거래처 읽기)와 메시지 보내기·챙기기 관리(내 이름으로 메시지를 보내고 챙기기 관리)로 표시되며, “미검증 앱” 표시가 함께 나타날 수 있습니다(정상 동작). 쓰기 도구를 실행하기 전에 데스크톱 앱이 내용을 보여 주고 확인을 받도록, 쓰기 도구를 자동 승인으로 두지 않는 것을 권장합니다.

연결 확인 방법

• 플러그인 → MCP의 서버 목록에 등록한 이름(예: joint)이 켜진 상태로 표시됩니다.
• 데스크톱 앱 대화에서 "조인트에서 내 워크스페이스 정보 알려 줘"가 동작합니다.

알려진 제한 사항

• 연결 이름에 한글을 쓸 수 없습니다. 한글은 -로 바뀌어 저장됩니다.

연결해제

• 플러그인 → MCP의 서버 목록에서 조인트 서버를 삭제하거나 스위치를 끕니다. 삭제하는 즉시 이후의 모든 조회와 쓰기가 차단됩니다.

자주 발생하는 오류