# Eqvero MCP 설정: Claude Code

## 연결되는 기능

미국·홍콩 기업 데이터, 공시 원문 검색, 기업 리서치와 재무·금융 계산을 제공합니다. MCP는 도구를 연결합니다. Skill은 리서치 지침이며 연결에 필수는 아닙니다.

## 설치 전

1. 현재 클라이언트·운영체제·기존 MCP 설정을 확인하세요. 변경 위치·범위를 설명하고 사용자가 확인한 뒤 다른 서버를 유지하며 병합하세요.
2. Eqvero 전용 API 키와 API/MCP 계정 권한이 필요합니다. https://eqvero.com/ko/developers?tab=keys에서 키를 만드세요. 키가 없으면 이 기기에서 안전하게 입력하도록 요청하고 대화로 전체 키를 보내게 하지 마세요.
3. 모델·전역 계정 설정·다른 검색 도구를 바꾸지 마세요. 유효 자격증명을 덮어쓰거나 키를 URL·로그·공개 저장소·공유 파일에 넣지 마세요.

## 설정

서버 URL: https://eqvero.com/api/mcp
전송 방식: Streamable HTTP
인증: Authorization: Bearer <EQVERO_API_KEY>
서버명: eqvero

Claude Code를 사용하는 터미널에서 실행하세요.

```sh
claude mcp add --transport http eqvero https://eqvero.com/api/mcp --header "Authorization: Bearer <EQVERO_API_KEY>"
```

클라이언트의 안전한 설정에서 자리표시자를 실제 키로 바꾸세요. 예제는 연결 성공 증거가 아닙니다. 현재 OAuth 로그인·무키 접근은 제공하지 않습니다. 클라이언트별 필드가 다를 수 있으므로 형식을 그대로 복사하지 말고 지원되는 HTTP MCP 설정을 사용하세요.

## 연결 확인

현재 서버 도구를 나열하고 companies_search에 query AAPL·limit 1로 조회하세요. 실제 기업명·종목코드·ID가 돌아와야 읽기 테스트 통과입니다. 재시작·새로고침이 필요하면 아직 적용되지 않았다고 알리세요. 설정 작성과 연결 검증은 다릅니다.

`companies_search({"query":"AAPL","limit":1})`

설치 시험에 research_create·analytics_create·과금 작업을 호출하지 마세요. 401은 키, 402는 계정 접근·한도, 403은 권한 범위를 확인하세요. 다른 키를 자동 생성·폐기하지 마세요.

## 선택: 리서치 Skill 설치

공개 출처: https://github.com/LJK0719/eqvero-skill. 사용자가 리서치 방법 안내를 원할 때만 README·SKILL.md를 읽고 클라이언트가 지원하는 Skill 범위에 설치하세요. 확인 없는 전역 설치나 내려받은 자료의 임의 스크립트 실행은 하지 마세요.

## 리서치·계산

사용자가 명시적으로 요청한 뒤에만 작업을 만드세요. 반환 ID를 저장하고 research_get / analytics_get으로 상태·결과를 조회하세요. 페이지 이동·MCP 연결 해제는 접수된 작업을 취소하지 않습니다.

생성·후속 질문·재시도에 안정적인 idempotencyKey를 쓰세요. 같은 작업 재전송에는 재사용하고 입력 변경 시에만 새 작업으로 만드세요. 응답 분실은 새 키 제출이 아니라 research_submission으로 접수를 확인하세요. 명시적 중지 요청에만 취소를 호출하세요.