Hookbase MCP Server

Hookbase 웹훅 중계 API를 Claude와 같은 AI 어시스턴트를 위한 도구로 노출하는 MCP(Model Context Protocol) 서버입니다.

빠른 시작

1. API 키 받기

Hookbase 대시보드의 Settings → API Keys에서 API 키를 받으세요.

2. Claude Desktop에 추가

Claude Desktop 구성 파일에 추가하세요:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Linux: ~/.config/claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "hookbase": {
      "command": "npx",
      "args": ["-y", "@hookbase/mcp-server"],
      "env": {
        "HOOKBASE_API_KEY": "whr_live_your_key_here"
      }
    }
  }
}

3. Claude Desktop 다시 시작

Claude Desktop을 다시 시작하여 MCP 서버를 로드하세요. 이제 Claude에게 웹훅 관리를 요청할 수 있습니다!

Related MCP server: hookray-mcp

대체 설치

전역 설치

npm install -g @hookbase/mcp-server

그런 다음 Claude Desktop 구성에서 사용하세요:

{
  "mcpServers": {
    "hookbase": {
      "command": "hookbase-mcp",
      "env": {
        "HOOKBASE_API_KEY": "whr_live_your_key_here"
      }
    }
  }
}

소스에서 설치

git clone https://github.com/HookbaseApp/mcp-server.git
cd mcp-server
npm install
npm run build

원격 / 호스팅(HTTP)

위의 npx 설정은 서버를 stdio를 통해 로컬에서 실행합니다 — 로컬 프로세스를 생성하는 Claude Desktop 및 Cursor에 적합합니다. 프로세스를 생성할 수 없는 클라이언트(ChatGPT 커넥터, 웹용 Claude, 커넥터 디렉터리)는 대신 원격 URL이 필요합니다.

이러한 클라이언트를 위해 Hookbase는 동일한 도구를 무상태(stateless) Streamable HTTP 엔드포인트로 노출합니다. 설치할 필요 없음 — URL과 API 키만 있으면 됩니다:

POST https://mcp.hookbase.app/mcp
Authorization: Bearer whr_live_your_key_here

원격 MCP 커넥터로 추가하세요:

{
  "mcpServers": {
    "hookbase": {
      "url": "https://mcp.hookbase.app/mcp",
      "headers": {
        "Authorization": "Bearer whr_live_your_key_here"
      }
    }
  }
}

• 인증은 베어러 토큰으로 사용하는 whr_ API 키입니다. 조직은 키에서 확인됩니다.

• 키가 여러 조직에 속해 있다면 X-Hookbase-Org-Id 헤더를 추가하여 하나를 선택하세요.

• 엔드포인트는 무상태(세션 없음)이며 브라우저 기반 클라이언트를 위해 CORS가 활성화되어 있습니다.

구성

조직은 API 키에서 자동으로 감지됩니다. 결과는 ~/.config/hookbase/mcp.json(또는 $XDG_CONFIG_HOME/hookbase/mcp.json)에 캐시되므로 이후 실행 시 /api/auth/me 왕복 요청을 건너뜁니다. 파일을 삭제하면 강제로 새로고침됩니다.

사용 가능한 도구(142개)

인바운드 웹훅

소스

• hookbase_list_sources - 모든 웹훅 소스 나열

• hookbase_get_source - 소스 세부 정보 가져오기

• hookbase_create_source - 새 소스 생성

• hookbase_update_source - 소스 구성 업데이트

• hookbase_delete_source - 소스 삭제(해당 소스의 라우트, 라우트의 전송 기록, 그리고 해당 소스를 통해 수집된 모든 이벤트까지 연쇄 삭제)

• hookbase_rotate_source_secret - 서명 비밀키 순환(유예 기간 없음 - 이전 비밀키는 즉시 작동 중지)

대상

• hookbase_list_destinations - 모든 대상 나열