AI 도구 연결하기
Claude Code · Claude Desktop을 AxHub에 연결하고, 대화로 앱 · 배포 · 데이터를 조회해요
Claude Code 같은 AI 도구를 AxHub에 연결하면, "내 앱들 최근 배포 상태 알려줘" 같은 말로 앱과 데이터를 조회하고 배포까지 시킬 수 있어요. 연결은 처음 한 번이면 되고, 내 계정으로 로그인해 내 권한 안에서만 동작해요.
연결하면 되는 것
연결한 AI 도구는 대화만으로 이런 일을 대신해 줘요.
- 앱 · 배포 살펴보기 — 배포 이력과 상태를 확인하고, 실패했다면 원인까지 짚어줘요.
- 데이터 읽기 — 앱 전용 데이터베이스의 표와 행, 연결된 회사 데이터(커넥터)를 읽어와요.
- AxHub 지식 검색 — SDK 사용법과 사내 문서(NAS)를 찾아서 답해줘요.
연결 대상은 AxHub MCP 서버 하나예요. 여러분이 쓰는 AI 도구가 이 주소를 통해 AxHub와 대화해요.
https://mcp.axhub.ai/mcp연결하기
터미널에 한 줄만 입력하면 돼요.
claude mcp add --transport http --scope user axhub https://mcp.axhub.ai/mcp처음 툴을 호출할 때 브라우저가 열리고, 로그인 · 동의를 거치면 연결돼요. client_id나 secret을 따로 만들 필요 없어요 — 클라이언트가 알아서 처리해요.
axhub 플러그인을 쓰고 있다면 온보딩("온보딩해줘")이 이 MCP 연결까지 같은 흐름에서 안내해줘요.
다른 MCP 클라이언트
Claude가 아니어도, Streamable HTTP(POST/JSON)와 OAuth 자동 등록(DCR)+PKCE를 지원하는 MCP 클라이언트면 같은 방식으로 연결돼요. 클라이언트 설정에 필요한 값은 엔드포인트 하나예요.
| 항목 | 값 |
|---|---|
| Endpoint | https://mcp.axhub.ai/mcp |
| Transport | Streamable HTTP (POST/JSON) |
나머지(인가 서버 · 클라이언트 등록)는 클라이언트가 표준 discovery로 자동 처리해요 — 메타데이터는 https://mcp.axhub.ai/.well-known/oauth-protected-resource/mcp에서 광고돼요.
이렇게 보이면 성공
연결되면 툴 목록에 sdk_search · connector_list · deployment_list 같은 이름이 보여요. 목록을 뒤질 것 없이 자연어로 확인해도 돼요.
내 앱들 최근 배포 상태 알려줘이 한마디에 배포 조회 툴(deployment_list 또는 tenant_recent_deployments)이 호출되면서 연결과 권한이 한 번에 확인돼요.
연결하면 할 수 있는 일 — 툴 20개
AI 도구가 대신 눌러 주는 버튼이 툴이에요. 기본으로 열리는 툴은 읽기 중심 20개 — 조회하고 검색할 뿐, 무언가를 바꾸지는 않아요. 어떤 툴을 쓸지는 AI가 대화 내용에 맞게 알아서 골라요.
| 영역 | 툴 | 하는 일 |
|---|---|---|
| SDK 지식 | sdk_search · get_recipe · validate_usage | SDK 사용법 검색, 앱 스키마에 맞춘 레시피, 작성한 SDK/DB 코드 정적 점검. AxHub SDK 코드를 쓰기 전 sdk_search를 먼저 불러요. |
| 앱 데이터 | raw_table_list · raw_row_list · table_list · table_get · row_list | 앱 전용 DB의 테이블 구조 · 행 읽기(행 조회 최대 200행). raw_*가 현행 DB 모델용이고, table_* · row_list는 예전 테이블 모델용이에요. |
| 외부 커넥터 | connector_list · connector_resources · connector_query · connector_document_query | grant 받은 외부 DB · API 커넥터 탐색과 읽기 전용 조회 — SQL은 SELECT · WITH로 시작하는 단일 조회 구문만, 문서형(NoSQL)은 find/findOne/count/distinct만. |
| 배포 조회 | deployment_list · deployment_status · deployment_diagnosis · deployment_logs · tenant_recent_deployments | 배포 이력 · 상태 · 실패 원인 진단 · 런타임 로그(시크릿 마스킹) · 테넌트 최근 배포 브리핑. |
| 사내 문서(NAS) | nas_search · nas_get_document · nas_list_sources | 사내 NAS 문서 의미검색 · 본문 텍스트 조회 · 색인 중인 소스 목록. 원본 바이너리는 반환하지 않아요 — 파싱된 텍스트만. |
운영 변경 툴 — 게이트 뒤의 21개
서버 운영 설정에서 deploy-write 게이트(AXHUB_MCP_DEPLOY_WRITE_ENABLED)가 켜져 있으면 운영 변경 툴 21개가 추가돼 총 41개가 돼요. 이 툴들은 deploy:write 권한이 있어야 쓸 수 있어요.
| 영역 | 툴 |
|---|---|
| 앱 관리 | app_list · app_get · app_create · app_update · app_suspend · app_resume · app_archive · app_reactivate · app_delete |
| 배포 실행 | deployment_trigger · deployment_cancel · deployment_rollback |
| 환경변수 | env_var_list · env_var_set · env_var_delete |
| GitHub 연동 | github_link_start · github_link_poll · github_accounts_list · github_repos_list · git_connection_status · git_connection_set |
운영 변경 툴은 호출 즉시 실행돼요 — 웹 승인이나 추가 확인 단계가 없어요. 에이전트가 쓸 때는 호출 전에 사용자 확인을 거치도록 하세요. 영구 삭제는 MCP에 없고 웹 콘솔에서만 가능해요.
안전 경계
- 데이터 읽기는 읽기 전용이에요 — 커넥터 조회는 읽기 쿼리만 실행되고, 테이블 행 조회는 한 번에 최대 200행이에요. 앱 DB에 쓰는 건 MCP가 아니라 배포된 앱이 직접 해요(
DATABASE_URL). - 범위가 지정된 grant는 자유 SQL이 막혀요 — grant에 테이블 범위가 걸려 있으면
connector_query의 자유 SQL은 거부되고, 지정된 범위 안의 조회만 돼요. - 비밀값은 가려져요 — 환경변수 값은
***로 마스킹되고, 로그 속 시크릿 패턴도 가려져요.