headless

// mcp

어떤 도구에든 headless MCP 붙이기

headless MCP 서버는 @h6s-ai/cli mcp 하나로 동작합니다. MCP 표준을 지원하는 모든 클라이언트(Claude Code · Cursor · Gemini · 그 외)에 같은 매니페스트로 붙습니다.

표준 매니페스트

아래 JSON 을 자기 도구의 mcpServers 설정에 그대로 붙이면 됩니다. 별도 서버 호스팅 없이 로컬에서 npx 로 실행됩니다.

mcp.json
{
  "mcpServers": {
    "h6s": {
      "command": "npx",
      "args": ["-y", "@h6s-ai/cli", "mcp"],
      "env": { "H6S_API_KEY": "h6s_live_..." }
    }
  }
}

도구별 설정 위치

많이 쓰는 세 도구는 전용 가이드가 있습니다. 그 외 MCP 호환 클라이언트는 위 매니페스트를 도구의 MCP 설정 파일에 그대로 추가하면 됩니다.

인증

서버는 환경변수 H6S_API_KEY 를 먼저 보고, 없으면 ~/.h6s/config.json 의 현재 프로필을 사용합니다. 둘 다 없으면 도구 호출 시점에 인증 오류를 돌려줍니다.

terminal
# 환경변수로 직접 주입
export H6S_API_KEY=h6s_live_...

# 또는 CLI 로 로그인 (~/.h6s/config.json 에 저장)
npx @h6s-ai/cli login

노출 도구

MCP 서버가 클라이언트에 등록하는 도구는 6 개입니다. 대부분의 시나리오는 h6s_fetch_data 하나로 끝나고, 나머지는 schema · provider · 자격증명을 사전에 탐색할 때 씁니다.

h6s_catalog
워크스페이스 capability 통합 발견 — provider + 인증 수단 + schema + 공동인증서 메타를 한 번에 반환.
h6s_list_providers
가용 금융기관(provider) 목록.
h6s_list_schemas
가용 데이터 schema 목록 (은행·홈택스·법인카드 등 데이터 종류).
h6s_get_schema
schema 상세 — 입력 항목 정의(필수/선택/타입)와 응답 메타.
h6s_list_credentials
워크스페이스에 등록된 자격증명 목록.
h6s_fetch_data
매크로 — schema + 기간(또는 provider/credentialId) 만 주면 수집 요청 생성 · 폴링 · 결과 반환까지 한 번에.

다음 단계