메뉴 경로: 설정 > AI 연동 > ChatGPT

ChatGPT 연동

ChatGPT에서 3Min API와 자연어로 대화하는 모습

개요

AI 연동은 ChatGPT 같은 AI 도구를 3Min API에 연결해서, 평소 채팅하듯이 자연어로 엔드포인트를 운영하는 기능이에요. 내부적으로는 MCP(Model Context Protocol) 라는 표준을 사용합니다. AI가 3Min API 서버에 연결되면, 우리 서비스가 노출한 도구들을 AI가 알아서 골라 사용해서 답을 만들어줍니다.

장점은 분명해요. 코딩 없이도 새 엔드포인트를 만들고, 어제 들어온 호출 로그를 검색하고, 협업자를 초대하고, 이번 달 사용량을 확인할 수 있습니다. 대시보드를 직접 클릭하지 않아도 "지난주 실패한 호출 5건만 정리해줘" 한 마디로 끝납니다.

3Min API는 두 가지 인증 방식을 모두 지원해요. ChatGPT와 Claude는 OAuth(3Min API 계정으로 로그인) 방식이라 API 키를 따로 관리할 필요가 없고, Claude Code·Cursor 같은 CLI/IDE 도구는 API 키 방식이라 로컬 설정 파일에 키를 넣어두고 사용합니다. 이 페이지는 ChatGPT Apps로 연결하는 길을 안내합니다.

할 수 있는 일

3Min API의 MCP 서버는 아래 도구들을 AI에게 노출해요. AI는 사용자의 요청을 보고 적절한 도구를 골라 사용합니다. 모든 동작은 본인 계정의 데이터에 한정되며, 다른 사용자의 자원에는 절대 접근하지 못합니다.

조회 도구

도구명	설명	권한
`help`	3Min API 서비스 가이드를 토픽별로 반환	공개
`endpoints` (list / get)	엔드포인트 목록·상세 조회	본인 소유
`logs` (lookup / search / fetch archived)	단건 로그 조회, 텍스트 검색, 아카이브된 페이로드 원격 조회	본인 소유
`stats`	월별·일별 API 사용량 통계 조회	본인 소유
`subscription`	현재 플랜·사용량·빌링 정보 조회	본인 계정
`archives` (list / download)	아카이브 파일 목록 + 임시 다운로드 URL 발급	본인 소유
`collaborators` (list_keys / list_invitations)	협업 키 및 협업자 초대 목록 조회	본인 소유

생성·수정·배포 도구

도구명	설명	권한
`endpoints` (create)	새 엔드포인트 생성	본인 계정
`endpoints` (update)	필드 정의·웹훅·알림 설정 수정	본인 소유
`endpoints` (deploy)	샌드박스 설정을 프로덕션으로 배포	본인 소유
`collaborators` (create_key)	새 협업 키 생성	본인 소유
`collaborators` (update_permissions)	협업 키의 CRUD 권한 수정	본인 소유
`collaborators` (invite)	협업자 초대 이메일 발송	본인 소유

실행 도구

도구명	설명	권한
`api_call` (GET / POST / PUT / DELETE)	본인이 배포한 엔드포인트에 HTTP 요청을 실행 (게이트웨이 경유)	본인 소유

api_call의 DELETE는 사용자가 정의한 엔드포인트의 비즈니스 로직(예: 주문 취소 API)을 호출하는 동작이에요. 엔드포인트 자체를 삭제하는 동작은 아닙니다.

보안 및 사고 방지: AI에서 제공하지 않는 동작

다음 동작은 의도적으로 AI에게 노출하지 않습니다. AI의 실수나 의도치 않은 호출로 인한 데이터 손실·과금 사고를 막기 위함이에요. 아래 동작이 필요할 땐 https://3minapi.com 에 직접 로그인해서 수행해 주세요.

미제공 동작	수행 위치
엔드포인트 삭제	대시보드 → APIs → 엔드포인트 상세
협업 키 삭제·비활성화·API 키 재발급	대시보드 → APIs → 엔드포인트 상세 → 협업 키
협업자 초대 철회	대시보드 → APIs → 엔드포인트 상세 → 협업자
플랜 변경·해지	대시보드 → 설정 → 구독
MCP API 키 재발급·삭제	대시보드 → 설정 → AI 연동 → CLI / IDE
아카이브 파일 삭제	대시보드 → APIs → 아카이브
계정 삭제	대시보드 → 설정 → 프로필

연동 방법

ChatGPT는 OAuth 방식으로 연결돼요. API 키를 ChatGPT 어딘가에 붙여 넣을 필요가 없고, 3Min API 계정으로 한 번만 로그인하면 됩니다.

1단계 — ChatGPT 웹 버전 열기

https://chatgpt.com 으로 이동하세요. 반드시 웹 버전에서 진행해야 해요. 데스크톱·모바일 앱은 Apps 메뉴가 아직 노출되지 않을 수 있습니다.

2단계 — Apps 메뉴 진입

좌측 사이드바에서 Apps를 클릭합니다.

3단계 — 3min api 검색

검색창에 3min api를 입력하고 검색 결과를 클릭합니다.

4단계 — Connect 클릭 후 OAuth 로그인

Connect 버튼을 누르면 3Min API의 로그인 화면이 새 창으로 뜹니다. 평소 사용하는 3Min API 계정으로 로그인하면 자동으로 권한이 부여돼요. API 키를 직접 입력하지 않습니다.

5단계 — 새 채팅에서 사용

연동 완료 후 3minapi에 곧바로 입력할 수 있는 ChatGPT 채팅 입력창

새 채팅을 열고 곧바로 사용해 보세요.

ChatGPT가 3min api를 잘 인식하지 못하면 채팅창에 @를 입력해 도구 목록을 띄우고 거기서 3minapi를 직접 선택하면 됩니다.

사용 예시

다음과 같은 자연어 프롬프트가 잘 작동해요.

"내 API 엔드포인트 목록 보여줘"
"고객 문의를 받을 엔드포인트를 만들어줘. 이름, 이메일, 메시지 필드 포함."
"어제 실패한 호출만 5건 정리해줘"
"이번 달 사용량을 어제까지 합쳐서 알려줘"
"협업자 chris@example.com 을 user-signup 엔드포인트에 초대해줘"

생성·수정·배포가 필요한 요청은 AI가 사용자에게 한 번 더 확인하고 진행합니다. 의도와 다른 요청이 들어가지 않도록 답변을 잘 살펴보세요.

자주 막히는 부분

ChatGPT 데스크톱 앱에 Apps 메뉴가 안 보여요

데스크톱·모바일 앱은 Apps 디렉터리가 노출되지 않을 수 있어요. 웹 버전(https://chatgpt.com)에서 진행해 주세요.
검색 결과에 3min api가 안 나와요

ChatGPT의 Apps 디렉터리는 계정 지역·플랜에 따라 일부 앱이 단계적으로 노출됩니다. 며칠 사이에 다시 검색해 보시고, 그래도 안 보이면 Claude 연동 또는 MCP 연동 (CLI/IDE)을 대신 사용하실 수 있어요.
다른 사람의 데이터가 섞여 보일까 걱정돼요

걱정하지 않으셔도 돼요. 모든 도구는 OAuth로 로그인된 본인 계정의 자원에만 접근합니다. 다른 사용자의 엔드포인트·로그·아카이브는 절대 보이지 않아요.
AI가 엔드포인트를 지웠어요

지울 수 없어요. 삭제 같은 파괴적 동작은 MCP에서 제외돼 있어서, AI가 아무리 시도해도 데이터가 사라지지 않습니다. 정말 삭제하려면 https://3minapi.com 에 직접 로그인해서 수행해 주세요.
답변이 자꾸 도구 사용 없이 일반 답변으로 와요

채팅창에 @를 입력해서 3minapi를 직접 선택한 후 질문하면 도구 사용이 강제돼요. 또는 "3minapi에서 …" 처럼 도구 이름을 프롬프트에 명시해 보세요.

Claude 연동