콘텐츠로 이동
mofcloud

MCP와 OAuth

마지막 업데이트:

MOF는 MCP 서버입니다. 켜면 Claude Desktop, Cursor, Dify 같은 AI 클라이언트가 각 사용자에게 허용된 비용 데이터를 조회할 수 있습니다. 접근은 읽기 전용입니다.

MCP 켜기

관리자

  1. Admin → 설정 → MCP 접근을 엽니다.
  2. “MCP 연결 허용”을 켭니다.
  3. “연결 확인”을 클릭합니다. MCP 서비스가 “연결됨”으로 표시되어야 합니다.

MCP 컨테이너는 배포 템플릿에 포함되어 있어 따로 설치할 것이 없습니다. 확인에 실패하면 mof-mcp 컨테이너가 실행 중이고 MOF와 같은 버전인지 확인하세요.

OAuth 설정

관리자 · Claude Desktop에 필요

OAuth를 설정하면 사용자는 AI 클라이언트에 주소 하나를 붙여 넣고 MOF 계정으로 로그인하기만 하면 됩니다. 설정하지 않으면 토큰을 직접 만들어야 하며, Claude Desktop은 토큰을 사용할 수 없습니다.

  1. MOF를 공개 HTTPS로 제공하세요. Claude는 자체 서버에서 접속하므로 주소가 인터넷에서 접근 가능해야 합니다.
  2. mof 서비스에 변수 두 개를 추가하고 다시 생성합니다:
compose.yaml · mof.environment
MOF_PUBLIC_URL: "https://mof.example.com"
MOF_MCP_OAUTH_SECRET: "REPLACE_WITH_A_RANDOM_SECRET_AT_LEAST_32_CHARACTERS"
  1. Admin → 설정 → MCP 접근에서 “연결 확인”을 다시 클릭합니다. OAuth 로그인이 “구성됨”으로 표시되어야 합니다.

MOF_PUBLIC_URL은 사용자가 여는 주소이며 경로는 넣지 않습니다. 시크릿은 32자 이상이어야 하고 모든 MOF 서버에서 같아야 합니다. “구성됨”은 두 값이 모두 설정되었다는 뜻일 뿐이며, 공개 콜백이 동작하는지는 Claude에서 처음 실제로 로그인해야 확인됩니다. 환경 변수

Claude Desktop 연결

모든 사용자

  1. MOF에서 설정 → MCP 연결을 열고 서버 URL을 복사합니다.
  2. Claude Desktop에서 Settings → Connectors → Add custom connector를 엽니다. MOF 같은 이름을 입력하고 주소를 붙여 넣습니다.
  3. Connect를 클릭하고 브라우저에서 MOF 계정으로 로그인한 뒤 승인합니다.
  4. Claude에게 질문해 보세요. 예: “지난달 클라우드별로 얼마를 썼어?”
OAuth를 지원하지 않는 클라이언트: 토큰 사용

설정 → MCP 연결 → 수동 토큰에서 이름을 입력하고 “토큰 만들기”를 클릭합니다. 토큰은 한 번만 표시되므로 바로 복사하세요. 유효 기간은 90일입니다. 요청 헤더로 보냅니다:

Header
Authorization: Bearer YOUR_TOKEN

접근 취소

사용자는 설정 → MCP 연결의 “연결된 앱”과 “내 토큰”에서 자신의 앱과 토큰을 취소합니다. Admin에서 “MCP 연결 허용”을 끄면 모든 연결이 한 번에 끊어집니다.