3Min API — MCP 서버 가이드

3Min API MCP 서버 기술 문서입니다. 사용 가능한 도구, 인증 방식, 설정 방법, 사용 예시를 안내합니다.

1. 서버 설명

3Min API는 백엔드 개발 역량이 없는 소규모 비즈니스를 위한 API 릴레이 서비스입니다. Schema-as-Data 설계를 사용하여 API 스키마를 구조화된 데이터로 저장하므로, 고객별 데이터베이스 설정이 필요 없습니다.

MCP 서버를 통해 Claude 같은 AI 어시스턴트가 API 엔드포인트 관리, 테스트 요청 전송, 로그 검색, 분석 조회, 협업자 관리를 자연어 대화로 수행할 수 있습니다.

2. 기능

사용 가능한 도구

help — 주제별 가이드 및 서비스 레퍼런스 제공
endpoints — API 엔드포인트 생성, 설정, 수정, 배포
api_call — API Gateway를 통한 HTTP 요청 (POST, GET, PUT, DELETE)
logs — 텍스트, 날짜 범위, 레코드 ID로 로그 검색 (아카이브 페이로드 지원)
stats — 엔드포인트별 월간 사용 분석 및 일별 상세
collaborators — 협업 키, 권한, 초대 관리
subscription — 플랜 정보, 사용량, 결제 정보 확인
archives — 아카이브 데이터 파일 목록 및 다운로드 (CLI 전용)

사용 사례

코드 작성 없이 API 엔드포인트를 빠르게 설정하고 테스트
로그와 통계를 통한 API 사용량 모니터링 및 문제 조사
협업 키 생성과 초대를 통한 팀 접근 관리

3. 설정 방법

MCP 서버 URL:

https://3minapi.com/api/mcp

Claude.ai / Claude Desktop

설정 → 커넥터를 엽니다
"커스텀 커넥터 추가"를 클릭합니다
위에 표시된 MCP 서버 URL을 입력합니다
프롬프트에 따라 OAuth 로그인을 완료합니다

API 키가 필요 없습니다 — OAuth를 통해 자동으로 인증됩니다.

Claude Code / CLI

대시보드에서 MCP API 키를 생성합니다 (설정 → MCP 연동)
MCP 클라이언트에 서버 설정을 추가합니다:

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

YOUR_MCP_API_KEY를 1단계에서 생성한 키로 교체하세요.

4. 인증

MCP 서버는 브라우저 기반 클라이언트를 위한 OAuth 2.1 + PKCE (S256)와 CLI 도구를 위한 API 키 인증을 지원합니다.

OAuth 2.1 (Claude.ai / Desktop)

완전 자동화 — 사용자는 브라우저에서 로그인만 하면 됩니다. 서버가 구현하는 표준:

RFC 8414 — 인증 서버 메타데이터 탐색
RFC 7591 — 동적 클라이언트 등록
RFC 9728 — 보호 리소스 메타데이터
PKCE (S256) — Proof Key for Code Exchange

API 키 (CLI)

MCP API 키를 x-api-key 헤더로 전달하거나 MCP 클라이언트 설정의 환경 변수로 설정합니다.

5. 사용 예시

예시 1: 샌드박스 API 엔드포인트 생성

"3minapi로 온라인 주문을 받고 싶어. 고객 이름, 주문 금액, 이메일 주소가 필요하고, 이름과 이메일로 검색할 수 있으면 좋겠어."

Action: Claude가 endpoints(action: "create", endpoint_name: "orders", field_definitions: [...])를 호출합니다

Result: 샌드박스 필드 정의와 함께 새 엔드포인트가 생성됩니다. 응답에는 엔드포인트 ID, 샌드박스/프로덕션 API 키가 포함된 기본 협업 키, API 호출을 받는 엔드포인트 URL이 포함됩니다.

예시 2: 샌드박스 API 테스트 호출

"방금 만든 엔드포인트에 John Doe가 $150 주문한 테스트 데이터를 보내줘"

Action: Claude가 api_call(endpoint_id: "...", environment: "sandbox", method: "POST", body: [fields])를 호출한 후, logs(endpoint_id: "...", environment: "sandbox")로 결과를 확인합니다.

Result: API Gateway가 요청을 비동기 처리합니다 (202 Accepted). 이후 Claude가 로그를 조회하여 레코드가 모든 필드 값과 함께 성공적으로 생성되었음을 확인합니다.

예시 3: 샌드박스 로그 검색

"지난 일주일간 John이 포함된 주문 내역을 보여줘"

Action: Claude가 logs(endpoint_id: "...", environment: "sandbox", search_text: "john", start_date: "...", end_date: "...")를 호출합니다

Result: 레코드 ID, HTTP 메서드, 상태 코드, 타임스탬프, 페이로드 데이터가 포함된 로그 항목을 반환합니다. 결과는 페이지당 10개로 페이지네이션되며 총 개수가 함께 표시됩니다.

6. 개인정보 처리방침

전체 개인정보 처리방침은 아래에서 확인할 수 있습니다:

https://3minapi.com/ko/privacy

7. 지원

질문, 문제, 피드백이 있으신 경우:

이메일: contact@3minapi.com