BigValue-Agent/data-marketplace-agent-skills

BigValue Real Estate 설정

플러그인 설치 뒤 MCP 연결 상태를 확인하고, 아직 로그인 전이면 클라이언트에 맞는 로그인 방법을 안내한다.

인증은 API 키 입력이 아니라 브라우저 구글 로그인(OAuth) 이다. 설치 중에 입력할 값은 없고, 첫 사용 때 로그인 한 번이면 연결된다. 토큰 보관과 갱신은 클라이언트가 알아서 한다.

이 스킬은 상태를 확인하고 안내만 한다. 로그인 명령을 대신 실행하지 않는다 — 브라우저 왕복은 사용자가 대화형 터미널에서 직접 마쳐야 안정적으로 끝난다. 설정 파일이나 자격증명 파일도 직접 편집하지 않는다.

npx skills add로 스킬만 설치했다면 MCP 연결은 온보딩 안내를 따르고 이 스킬은 건너뛴다.

상태 확인

1. 현재 클라이언트를 식별한다. Claude Code에서는 claude plugin list --json과 claude mcp list, Codex에서는 codex plugin list --json과 codex mcp list --json을 쓴다. 셸 승인이 필요하면 먼저 받는다.
2. 플러그인 bigvalue-realestate가 설치·활성 상태인지 확인한다.
3. MCP 서버 bigvalue-realestate의 상태를 확인한다. 로그인 전에는 서버가 연결 자체를 거절하므로 ! Needs authentication으로 표시되고, ✔ Connected면 로그인된 것이다. 확실히 하려면 대표 도구를 한 번 호출해 확인한다.
4. 상태만 요청받았으면 판정 결과를 한국어로 보고하고 아무것도 바꾸지 않는다.

Claude Code 경로

플러그인을 설치하면 MCP 서버는 자동 등록된다. 남는 것은 로그인 한 번이다.

따로 명령이 필요 없다 — 첫 데이터 질문에서 클라이언트가 브라우저 로그인을 띄운다. 아래는 수동 경로다.

1. claude mcp list에 ! Needs authentication이 보이면 정상이다 — 아직 로그인 전이라는 뜻이다.
2. 사용자에게 /mcp를 실행해 bigvalue-realestate를 선택하게 안내한다. 브라우저가 열리고 구글 로그인과 동의를 거치면 연결이 끝난다.
3. 대안: 외부 대화형 터미널에서 claude mcp login plugin:bigvalue-realestate:bigvalue-realestate를 직접 실행해도 된다. 이 명령을 스킬이 대신 실행하지 않는다.
4. 첫 로그인 직후에는 새 세션에서 확인한다. 로그인 전에 떠 있던 프로세스는 인증 상태를 못 읽을 수 있다.
5. 로그인 계정이 허용 목록에 없으면 "연결할 수 없는 계정입니다" 화면이 뜬다. 그 경우 온보딩 담당자에게 계정 허용을 요청하게 안내한다.

Claude Desktop의 채팅에서 쓰려면 플러그인 대신 커스텀 커넥터를 안내한다 — Settings → Connectors → Add custom connector에 https://datamarket-mcp.bigvalue.ai/mcp를 넣고 Connect를 누르면 같은 구글 로그인이 뜬다.

Codex 경로

Codex 플러그인은 스킬만 담는다. MCP는 아래로 따로 등록하고 로그인한다.

1. ~/.codex/config.toml에 서버를 추가하게 안내한다. 인증 방식은 기본값이 OAuth라 따로 적지 않는다.

   [mcp_servers.bigvalue-realestate]
   url = "https://datamarket-mcp.bigvalue.ai/mcp"
   

2. 사용자가 외부 대화형 터미널에서 로그인을 실행한다. 이 명령도 스킬이 대신 실행하지 않는다.

   codex mcp login bigvalue-realestate
   

3. Codex를 새 프로세스로 다시 시작한다. 설정과 로그인 상태는 실행 중 프로세스에 반영되지 않는다.

4. codex mcp list --json과 대표 도구 호출로 연결을 확인한다.

확인

연결되면 대표 도구를 한 번 호출해 응답을 확인한다(예: 단지 검색). 로그인 URL·인가 코드·토큰을 출력하거나 기록하지 않는다.

보안 경계

• 로그인 URL·인가 코드·토큰을 요청·출력·복사·기록하지 않는다. 브라우저 왕복은 사용자 몫이다.
• ~/.codex/config.toml 수정은 위 조각을 보여주고 사용자가 반영하게 한다. Claude 설정·자격증명 파일·플러그인 cache는 직접 편집하지 않는다.
• 사용자가 직접 구성한 다른 MCP 서버나 무관한 플러그인을 제거·변경하지 않는다.