AxHub MCP
MCP 클라이언트에서 테넌트의 데이터 카탈로그를 둘러보고 읽기 전용 SQL로 데이터를 조회하는 호스티드 MCP 서버
AxHub MCP는 호스티드 MCP 서버예요. Claude Code 같은 MCP 클라이언트를 연결하면, 로그인한 사용자의 테넌트 범위 안에서 데이터 카탈로그를 둘러보고 읽기 전용 SQL로 데이터를 조회할 수 있어요. 엔드포인트는 하나예요.
https://mcp.axhub.ai/mcp할 수 있는 일
서버는 읽기 전용 툴 5개를 제공해요. 모두 테넌트 인자를 받지 않아요 — 테넌트는 로그인 토큰에서 서버가 결정해요.
| 툴 | 인자 | 하는 일 |
|---|---|---|
catalog_kinds | (없음) | 리소스 종류 목록 |
catalog_connectors | (없음) | 커넥터(데이터 소스) 목록 |
catalog_resources | connector? · kind? · query? | 리소스(테이블 등)를 커넥터·종류·이름으로 찾기 |
resource_read | connector · path | 특정 리소스의 메타데이터·스키마 조회 |
data_read | connector · path · sql · params? · row_limit? | SELECT 전용 SQL 실행 (최대 100행) |
탐색은 보통 이 순서로 해요: catalog_kinds·catalog_connectors로 무엇이 있는지 본 뒤 → catalog_resources로 테이블을 찾고 → resource_read로 스키마를 확인하고 → data_read로 데이터를 읽어요.
연결
Claude Code는 한 줄로 연결해요. 처음 호출할 때 브라우저로 로그인하면 끝이에요.
claude mcp add --transport http --scope user axhub https://mcp.axhub.ai/mcp다른 MCP 클라이언트 연결과 로그인 흐름은 클라이언트 연결을 보세요.
안전 경계
- 읽기 전용 —
data_read는SELECT만 실행돼요. 쓰기/DDL은 없어요. - 행 제한 — 한 번에 최대 100행을 돌려줘요.
- 테넌트 격리 — 한 세션은 하나의 테넌트로 묶여요. 로그인한 사용자의 권한 밖 데이터는 보이지 않아요.
- 자격 범위 — 모든 조회는 로그인한 사용자의 접근 권한 안에서만 이뤄져요.
자세한 인증·권한은 OAuth & 권한을 보세요.
관련 문서
- 클라이언트 연결
- OAuth & 권한
- 데이터 API — 앱에서 직접 HTTP로 동적 테이블을 다룰 때