AxHub/Docs

MCP 서버 — 개요 & 설치

AxHub 의 MCP 서버 apphub-mcp 이에요. JSON-RPC 2.0 위에서 26개 tool 과 리소스·프롬프트·태스크를 OAuth Bearer 로 안전하게 쓸 수 있어요.

뭘 할 수 있어요?

Claude · Cursor 같은 MCP 호환 AI 에이전트에서 AxHub 의 앱 · 배포 · DB · API · GitHub 를 한 번에 다룰 수 있어요. 5개 카테고리에 걸쳐 총 26개 tool 을 제공해요.

서버 이름은 apphub-mcp, 프로토콜은 JSON-RPC 2.0 이에요.

서버가 열려 있는 곳

POST /mcp — 요청은 여기로

모든 tool 호출과 메서드는 단일 HTTPS 엔드포인트 /mcp 로 JSON-RPC 2.0 POST 에 담아 보내주세요.

Terminal
$ curl -X POST https://api.jocodingax.ai/mcp \
  -H "Authorization: Bearer $AX_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Mcp-Session-Id: $SESSION_ID" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

GET /mcp — 실시간 알림은 여기로

서버가 보내주는 알림 (리소스가 바뀌었어요 · 태스크가 끝났어요 같은) 은 동일 경로의 GET 에 Accept: text/event-stream 으로 연결하면 SSE 로 받을 수 있어요.

30초마다 keepalive 가 흐르고, 끊겼다 다시 붙을 때는 Last-Event-ID 헤더를 넣어 주세요. 놓친 이벤트를 다시 보내드려요.

프로토콜 정보

  • Protocol version: 최신은 2025-11-25. 예전 버전 2025-03-26 도 받아드려요.
  • 서버 이름: apphub-mcp
  • 서버 버전: 배포 시점의 APP_VERSION 값. 개발 환경에선 dev 로 찍혀요.

제공하는 기능 (capabilities)

initialize 응답 (발췌)
{
  "protocolVersion": "2025-11-25",
  "capabilities": {
    "tools": {},
    "resources": { "listChanged": true, "subscribe": true },
    "prompts":   { "listChanged": true },
    "tasks": {
      "list":   {},
      "cancel": {},
      "requests": { "tools": { "call": {} } }
    }
  },
  "serverInfo": { "name": "apphub-mcp", "version": "1.0.0" },
  "sessionId": "sess_abc123..."
}

세션은 어떻게 동작해요?

제일 처음 initialize 를 부르면 서버가 세션을 만들고 sessionId 를 돌려줘요. 그 뒤 모든 요청은 Mcp-Session-Id 헤더 로 이 ID 를 같이 보내 주세요. 세션 주인이 토큰 주인과 같은지 서버가 꼭 확인해요.

세션이 다른 사람 거라면?

Mcp-Session-Id 가 토큰 주인 (tenantID + userID) 과 안 맞으면 세션 ID 는 무시돼요. 리소스 구독·태스크 호출은 forbidden 으로 거절하니 새로 initialize 부터 시작해 주세요.

지원하는 메서드

메서드뭐 해요?인증
initialize세션 만들고 프로토콜 맞춰요OAuth 또는 guard
tools/list쓸 수 있는 tool 보여줘요OAuth + scope 필터
tools/calltool 을 실제로 실행해요scope + 앱 단위 권한
prompts/list · prompts/get프롬프트 템플릿 받아요OAuth
resources/list · resources/read배포·앱 리소스 보여주고 읽어요OAuth 전용
resources/subscribe · resources/unsubscribe리소스 변경 알림을 켜고 꺼요OAuth + 세션
tasks/get · tasks/result · tasks/list · tasks/cancel오래 걸리는 작업을 비동기로 관리해요OAuth
notifications/initialized · ping연결 유지용제한 없음

Tool 카테고리 (총 26개)

카테고리개수포함된 tool
App10register_app, list_my_apps, get_app_url, manage_app, manage_ci, import_and_deploy, whats_next, set_app_spec, manage_oauth_client, env_vars
Deploy6deploy_app, rollback_deploy, preflight_check, list_deployments, restart_app, tail_deploy_logs
GitHub1connect_repo
Table4manage_table, records, search_table, alter_table
API5list_apis, get_api_schema, test_api, manage_api_key, discover_apis

tool 하나하나의 입력·출력·예시는 Tools 레퍼런스 에 모아뒀어요.

다음으로 읽어보세요