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

Claude 연동

개요

AI 연동은 Claude 같은 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 키 방식이라 로컬 설정 파일에 키를 넣어두고 사용합니다. 이 페이지는 Claude의 커스텀 커넥터로 연결하는 길을 안내합니다.

할 수 있는 일

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 → 아카이브
계정 삭제	대시보드 → 설정 → 프로필

연동 방법

Claude는 OAuth 방식으로 연결돼요. 커스텀 커넥터에 서버 URL만 등록하면, 이후 인증은 3Min API 계정 로그인으로 끝납니다. API 키를 직접 입력하지 않습니다.

1단계 — Claude 설정 진입

Claude(https://claude.ai)를 열고 우측 상단의 계정 메뉴에서 설정으로 이동합니다.

2단계 — 커넥터 섹션 이동

Claude 설정 좌측 메뉴의 커넥터 섹션

설정 화면 좌측 메뉴에서 커넥터 섹션을 선택합니다.

3단계 — 커스텀 커넥터 추가

커스텀 커넥터 추가 화면에서 이름과 서버 URL을 입력하는 모습

커스텀 커넥터 추가 버튼을 누르고, 아래 정보를 입력합니다.

커넥터 이름: 3minapi (원하는 이름으로 자유롭게)
서버 URL:
```
https://3minapi.com/api/mcp
```

4단계 — 연결 후 OAuth 로그인

연결 버튼을 누르면 3Min API의 로그인 화면이 새 창으로 뜹니다. 평소 사용하는 3Min API 계정으로 로그인하면 자동으로 권한이 부여돼요.

5단계 — 새 채팅에서 사용

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

Claude 무료 플랜은 커스텀 커넥터를 1개까지 등록할 수 있어요. Pro 이상은 무제한입니다.

사용 예시

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

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

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

자주 막히는 부분

연결 버튼을 눌렀는데 도구가 안 떠요

Claude의 커넥터는 가끔 캐시 문제로 도구 목록이 즉시 갱신되지 않을 수 있어요. 커넥터를 한 번 연결 해제했다가 다시 연결해 보세요. 새 채팅에서 도구 목록이 정상 표시됩니다.
무료 플랜인데 커넥터를 추가할 수 없어요

이미 다른 커스텀 커넥터를 1개 등록한 상태일 수 있어요. 무료 플랜은 1개 제한이라, 기존 커넥터를 제거하거나 Pro 이상 플랜으로 업그레이드해 주세요.
다른 사람의 데이터가 섞여 보일까 걱정돼요

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

지울 수 없어요. 삭제 같은 파괴적 동작은 MCP에서 제외돼 있어서, AI가 아무리 시도해도 데이터가 사라지지 않습니다. 정말 삭제하려면 https://3minapi.com 에 직접 로그인해서 수행해 주세요.
Claude Code(터미널)에서도 같은 방식으로 연결하나요?

아니에요. Claude 웹·데스크톱은 OAuth 방식의 커스텀 커넥터를 사용하고, Claude Code(CLI)·Cursor 같은 로컬 도구는 API 키 방식을 사용해요. 후자는 MCP 연동 (CLI / IDE) 가이드를 참고해 주세요.

ChatGPT 연동

MCP 연동 (CLI / IDE)