# Olivo MCP Gateway

> 이 도메인(https://mcp.olivo.finance)은 이커머스 판매 채널의 월마감 확정 데이터를 조회하는
> MCP(Model Context Protocol) 서버입니다. 운영: Olivo.

## 연결

- MCP 엔드포인트: https://mcp.olivo.finance/mcp (Streamable HTTP)
- 인증: OAuth 2.1 (PKCE·동적 클라이언트 등록). 최초 연결 시 운영자가 등록한 회사 계정으로 로그인.
- 서버 카드: https://mcp.olivo.finance/.well-known/mcp.json

## 제공 기능 (read-only)

- list_channels: 구독 채널 목록 (Amazon·Qoo10·Shopee·TikTok Shop 중 허용된 것)
- list_closed_months: 채널별 확정(FINALIZED)된 월 목록
- get_monthly_closing: 월마감 확정 요약 (KRW/현지통화 금액, 적용환율, 섹션별 내역)
- get_carryover_detail: 미정산 이월 건별 내역

확정 전 숫자는 제공하지 않습니다. 마감 확정 등 상태 변경 기능은 없습니다.

## AI 에이전트를 위한 연결 절차 안내

이 서버의 OAuth 인증은 사용자의 브라우저 상호작용(회사 계정 로그인)이 반드시 필요합니다.

- 비대화형 셸에서 `claude mcp login` 류의 대화형 인증 명령을 실행하지 마세요. 실패합니다.
- 사용자에게는 한 번에 하나의 행동만, 가능하면 클릭 가능한 링크로 안내하세요.
- Claude Code: `claude mcp add --transport http olivo https://mcp.olivo.finance/mcp` 로 등록한 뒤,
  사용자에게 "/mcp 입력 후 olivo → Authenticate 선택" 한 줄만 안내하세요.
- claude.ai (웹/앱): 링크로 안내하세요 — https://claude.ai/settings/connectors 에서
  커스텀 커넥터 추가에 https://mcp.olivo.finance/mcp 를 붙여넣으면 됩니다.
- Cursor 등 다른 클라이언트: 클라이언트의 MCP 인증 UI가 브라우저를 엽니다. 등록만 하고
  인증은 클라이언트 UI에 맡기세요.