MCP 연결

OnGleam MCP를 연결하면 Claude Code, Codex, Claude Desktop, ChatGPT Desktop에서 조직의 소셜 리스닝 데이터를 조회할 수 있습니다. 공개 서버는 Streamable HTTP endpoint https://mcp.ongleam.com/mcp를 사용합니다.

연결 전 확인

활성 OnGleam 계정과 온보딩을 마친 조직 멤버십이 필요합니다.
인증할 때 OnGleam 이메일과 비밀번호로 로그인합니다.
OAuth가 token 저장과 갱신을 처리하므로 PAT나 API key를 복사할 필요가 없습니다.

클라이언트 연결

사용하는 클라이언트를 선택하고 순서대로 진행하세요.

MCP 서버 추가

MCP 연결을 공유할 repository root에서 일반 터미널을 열고 실행하세요.

claude mcp add --scope project --transport http ongleam "https://mcp.ongleam.com/mcp"

생성되는 .mcp.json에는 서버 URL만 들어갑니다. credential 없이 팀과 함께 commit할 수 있습니다.

인증 및 연결 확인

프로젝트에서 Claude Code를 실행해 /mcp를 입력하고 ongleam → Authenticate를 선택하세요. 브라우저에서 OnGleam 이메일과 비밀번호로 로그인한 뒤 /mcp 또는 claude mcp list에서 connected 상태를 확인합니다.

인증과 권한

MCP 조회 결과는 로그인 계정의 기본 OnGleam 조직 범위로 제한됩니다. 현재 MCP 로그인 화면에서는 다른 조직을 선택할 수 없습니다.

contents:read 권한이 있으면 활성 Pro 이상 프로젝트의 채널 추적 데이터를 다음 read-only tool로 조회할 수 있습니다.

channel_watch_list: projectId, platforms, statuses 필터로 추적 대상을 찾습니다.
channel_watch_get: watchId의 계정 식별자와 최근 성공·실패, 다음 실행 상태를 조회합니다.
channel_watch_content_list: watchId가 발견한 콘텐츠만 provenance 기준으로 조회합니다.

목록 tool은 기본 20개, 최대 50개를 반환합니다. 응답의 nextCursor가 null이 아니면 같은 필터와 함께 다음 요청의 cursor로 전달하세요. cursor는 불투명 문자열이므로 내용을 수정하거나 다른 watch·필터에 재사용하면 INVALID_CURSOR가 반환됩니다.

{
  "projectId": "00000000-0000-7000-8000-000000000001",
  "platforms": ["YOUTUBE"],
  "statuses": ["ACTIVE", "FAILED"],
  "limit": 20
}

응답은 schemaVersion: 1과 안전한 공개 필드만 포함합니다. credential, platform token, crawler cursor, lease 및 내부 오류 원문은 노출하지 않습니다. 다른 조직이거나 구독 범위 밖인 watchId와 존재하지 않는 ID는 모두 NOT_FOUND로 동일하게 응답합니다.