3Min API
메뉴 경로: 설정 > AI 연동 > CLI / IDE

MCP 연동 (CLI / IDE)

개요

AI 연동은 Claude Code·Cursor 같은 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 키 방식이라 로컬 설정 파일에 키를 넣어두고 사용합니다. 이 페이지는 API 키 방식으로 로컬 도구를 연결하는 길을 안내합니다.

진입 경로

  • 대시보드 → 설정 → AI 연동 → CLI / IDE 탭

할 수 있는 일

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

연동 방법

CLI/IDE 도구는 API 키 방식으로 연결돼요. 로컬 설정 파일에 3Min API의 MCP API 키를 한 번 넣어두면, 이후 그 도구에서 항상 본인 계정으로 인증됩니다. API 키는 한 번만 노출되니 발급 직후 바로 복사해 주세요.

1단계 — CLI / IDE 탭 진입

MCP API 키가 아직 없는 CLI / IDE 탭 화면

대시보드 우측 상단의 계정 메뉴 → 설정 → AI 연동 → CLI / IDE 탭으로 이동합니다.

2단계 — MCP API 키 발급

MCP API 키 생성 버튼을 누릅니다. tm_mcp_ 로 시작하는 키가 한 번 표시돼요.

이 화면을 떠나면 키 전체는 다시 볼 수 없어요. 옆의 복사 버튼으로 즉시 복사해서 안전한 곳에 보관하세요. 분실 시에는 키를 새로 발급해야 하고, 기존 키는 즉시 무효화됩니다.

MCP API 키가 발급되어 마스킹된 키와 메타데이터가 표시된 CLI / IDE 탭 화면

3단계 — 설정 스니펫 복사

화면 하단의 설정 코드 카드에 표시되는 JSON을 그대로 복사합니다. 발급된 키가 자동으로 채워진 형태예요.

{
	"mcpServers": {
		"3minapi": {
			"type": "http",
			"url": "https://3minapi.com/api/mcp",
			"headers": { "x-api-key": "tm_mcp_..." }
		}
	}
}

4단계 — 도구의 MCP 설정 파일에 붙여넣기

복사한 스니펫을 사용 중인 도구의 MCP 설정 파일에 추가합니다. 도구별 설정 파일 위치는 각 도구의 공식 문서를 참고하세요.

  • Claude Code: 프로젝트 루트의 .mcp.json 또는 사용자 설정
  • Cursor: 설정 → MCP Servers
  • 그 외 MCP 호환 도구도 동일한 JSON 형식을 사용합니다

설정을 저장한 뒤 도구를 재시작하면 3minapi 도구가 인식돼요.

5단계 — 키 관리

이후 키 재발급·삭제는 같은 화면에서 가능합니다.

  • 키 재발급 — 새 키를 발급하면서 기존 키는 즉시 무효화됩니다. 분실했거나 노출 의심 시 사용하세요. 재발급 후엔 모든 도구의 설정 파일에서 키를 새 값으로 교체해야 합니다.
  • 키 삭제 — 키를 완전히 제거합니다. 삭제 후엔 어떤 도구에서도 본인 계정에 접근할 수 없어요.

사용 예시

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

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

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

자주 막히는 부분

  • API 키 전체를 깜빡 못 보고 화면을 닫았어요

    보안상 키 전체는 발급 시 한 번만 노출돼요. 다시 볼 수 없는 게 정상이에요. CLI / IDE 탭에서 키 재발급으로 새 키를 만들면 됩니다(기존 키는 즉시 무효화되니, 사용 중인 도구의 설정도 함께 교체).

  • 도구에 키를 넣었는데 인식이 안 돼요

    도구를 완전히 재시작해야 MCP 서버가 새로 연결돼요. 설정 파일을 저장만 한 상태로는 적용되지 않을 수 있습니다. JSON에 오타가 있으면 도구가 조용히 무시할 수 있으니 형식도 한 번 더 확인해 주세요.

  • 다른 사람의 데이터가 섞여 보일까 걱정돼요

    걱정하지 않으셔도 돼요. MCP API 키는 발급한 본인의 계정에 묶여 있어, 모든 도구는 본인 계정의 자원에만 접근합니다. 다른 사용자의 엔드포인트·로그·아카이브는 절대 보이지 않아요.

  • AI가 엔드포인트를 지웠어요

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

  • tm_test_*, tm_live_* 와는 어떻게 다른가요?

    완전히 다른 키예요. tm_test_*(샌드박스)·tm_live_*(프로덕션)는 외부에서 본인의 API 엔드포인트를 호출할 때 쓰는 협업 키이고, tm_mcp_*는 AI 도구가 본인의 3Min API 계정에 접근할 때 쓰는 키입니다. 서로 섞어 쓰면 인증이 실패해요.

이전
Claude 연동