MCP 서버

작동 방식

MCP 서버는 귀하의 계정의 MCP 엔드포인트에 위치합니다. AI 어시스턴트는 OAuth2를 사용하여 연결하고, 데이터를 읽거나 작업을 수행하기 위해 도구를 호출할 수 있습니다. 서버는 귀하의 팀과 활성 이벤트를 자동으로 해결하므로 대부분의 쿼리는 구성 없이 진행됩니다.

인증

인증은 Laravel Passport를 통해 OAuth2를 사용합니다. AI 클라이언트는 OAuth 애플리케이션으로 등록하고, 접근을 승인하도록 리디렉션하며, 베어러 토큰을 수신합니다. 모든 요청에 이 토큰을 포함하세요.

Authorization: Bearer {token}

토큰은 귀하의 팀에 국한되며 구성 가능한 기간 후에 만료됩니다. 언제든지 계정 설정에서 접근을 취소할 수 있습니다.

컨텍스트 발견

항상 시작하세요 get_organizer_context. 이 도구는 팀 정보, 활성 이벤트 및 보류 중인 항목을 반환합니다. 단일 팀이나 단일 이벤트가 있는 경우 다른 도구가 명시적 ID 없이 자동으로 해결됩니다.

// get_organizer_context의 예시 응답
{
  "team": { "id": "01HX...", "name": "Acme Events" },
  "active_events": [
    { "id": "01HY...", "name": "DevConf 2026", "status": "published" }
  ],
  "pending": {
    "speaker_applications": 3,
    "refund_requests": 1,
    "sponsorship_requests": 2
  }
}

판매 분석 도구

이벤트에 대한 수익 및 티켓 판매 데이터를 쿼리합니다. 모든 금액은 원시 센트 값(예: revenue_cents) 및 사람이 읽을 수 있는 형식의 문자열(예: revenue_formatted).

트래픽 분석

get_traffic_channels 방문자를 채널(유기적, 소셜, 유료, 추천, 직접), 출처, 캠페인, 장치 유형 및 국가별로 분류합니다. 이를 통해 마케팅 ROI를 측정하고 청중이 어디에서 오는지 이해할 수 있습니다.

이벤트 관리 도구

주최자에게만 보이는 초안 이벤트를 포함하여 이벤트를 나열하고 검사합니다.

참석자 도구

search_attendees 이름 또는 이메일로 검색하고 티켓 유형 또는 체크인 상태로 필터링할 수 있습니다. get_attendee_detail 전체 참석자 기록을 반환하며 주문 내역 및 스캔 기록을 포함합니다.

// 이메일로 참석자를 검색합니다.
search_attendees({ query: "[email protected]", checked_in: false })

// 특정 참석자의 전체 세부정보를 가져옵니다.
get_attendee_detail({ attendee_id: "01HZ..." })

검토 대기 도구

귀하의 주의가 필요한 항목을 검토합니다. 모든 도구는 대기 중, 승인됨 또는 거부된 항목만 표시하도록 상태 필터링을 지원합니다.

이벤트 생성 워크플로우

MCP 서버를 통해 이벤트를 생성하는 것은 세 단계의 프로세스입니다.

• 호출 search_venues 쿼리 문자열로 일치하는 장소를 찾습니다.
• 호출 resolve_venue 선택된 결과로 확인된 장소의 전체 주소 및 좌표를 가져옵니다.
• 호출 create_event 해결된 장소 ID와 이벤트 세부정보(이름, 날짜, 설명, 티켓 유형)를 포함하여.

연락처 가져오기 워크플로우

연락처 가져오기는 두 단계의 비동기 프로세스입니다.

호출 import_contacts JSON 배열의 연락처 객체와 함께.이메일, 이름, 성, 회사, 및 직함 필드를 수락합니다. 서버는 202 상태와 가져오기 ID로 응답합니다.

// 연락처 가져오기 시작
import_contacts({
  contacts: [
    { "email": "[email protected]", "first_name": "Jane", "last_name": "Doe", "company": "Acme", "title": "CTO" },
    { "email": "[email protected]", "first_name": "Bob", "last_name": "Smith" }
  ]
})
// 반환: { "import_id": "01HZ...", "status": "pending", "count": 2 }

// 완료 확인
check_import_status({ import_id: "01HZ..." })
// 반환: { "status": "processed", "imported": 2, "skipped": 0, "errors": 0 }

가져오기 ID로 check_import_status를 폴링하여 상태가 처리됨 또는 오류.

리소스 및 프롬프트

MCP 서버는 AI 어시스턴트가 데이터에 구조화된 접근을 하고 준비된 분석 워크플로를 사용할 수 있도록 리소스 및 미리 구축된 프롬프트 템플릿을 제공합니다.

지원되는 AI 클라이언트

모든 MCP 호환 클라이언트가 Kagibag MCP 서버와 함께 작동합니다. Claude Desktop은 내장된 MCP 지원을 제공하며 추천 클라이언트입니다. 서버 URL과 OAuth 자격 증명을 클라이언트의 MCP 구성에 추가하여 시작하세요.

{
  "mcpServers": {
    "kagibag": {
      "url": "https://your-account.kagibag.com/mcp",
      "auth": {
        "type": "oauth2",
        "client_id": "your-client-id",
        "client_secret": "your-client-secret"
      }
    }
  }
}