API 레퍼런스
로그인
본문으로 건너뛰기

빠른 시작

xenocast 설치, xenocast login 으로 키 넣기, AI 에이전트 MCP 등록을 끝내고 첫 macOS 잡을 실행하기까지

설치 한 줄로 xenocast 실행 파일이 생기고, xenocast login으로 키를 넣고, xenocast setup으로 설치된 AI 에이전트에 MCP 서버를 등록합니다, 이 파일이 CLI이자 MCP 서버입니다

준비물

  • 콘솔 계정(Google 또는 이메일 로그인)과 충전된 크레딧
  • macOS 또는 Linux 터미널(Windows는 PowerShell)

1. API 키 발급

  1. 콘솔 API 키(/console/keys)에서 API 키 만들기를 누릅니다
  2. 이름, 워크스페이스, 권한(실행과 조회 또는 조회만), 만료(만료 없음, 30일, 90일, 1년)를 고릅니다
  3. 키는 이때 한 번만 보입니다, 바로 복사해 두세요

잡을 보내려면 권한이 실행과 조회(run)여야 합니다

2. 설치하고 키 넣기

macOS와 Linux

curl -fsSL https://github.com/Xeno-CI/xenocast/releases/latest/download/install.sh | sh
xenocast login

Windows(PowerShell)

irm https://github.com/Xeno-CI/xenocast/releases/latest/download/install.ps1 | iex
xenocast login

설치 스크립트는 이 OS와 CPU에 맞는 실행 파일 하나를 받아 SHA256SUMS로 검증한 뒤 ~/.local/bin/xenocast에 둡니다(XENOCI_INSTALL_DIR로 바꿀 수 있습니다), Node는 필요 없습니다, xenocast login은 콘솔에서 복사한 키를 가린 입력으로 받아 macOS 키체인, Windows 자격 증명 관리자, Linux secret-service, 셋 다 없으면 이 기기에 묶인 암호화 파일에 저장합니다

셸 설정이나 CI에서는 저장하지 않고 환경 변수 XENOCI_API_KEY만 둡니다, 환경 변수가 저장된 키보다 우선합니다, 환경 변수가 있는 셸에서 설치하면 설치 스크립트가 그 키로 3단계까지 이어서 합니다

3. 도구 등록

xenocast setup
  1. 키 확인: 키의 조직, 워크스페이스, 권한을 서버에서 확인합니다, 확인하지 못하면 아무것도 바꾸지 않습니다
  2. MCP 등록: 설치된 Claude Code, Codex, Cursor, OpenCode, OmO 설정에 MCP 서버 xenocast mcp를 넣습니다, 설정 파일에는 실행 명령만 들어가고 키는 들어가지 않습니다, 이미 등록돼 있으면 건너뜁니다(--agent claude처럼 대상을 고를 수 있습니다)
  3. MCP 서버 확인: 저장된 키만으로 서버가 whoami에 답하는지 봅니다

마지막 줄이 XenoCast 준비 완료로 시작하면 끝입니다, 출력에는 키의 마지막 4자만 나옵니다

AI 에이전트에게 맡기기

키를 내 터미널에 넣어 둔 뒤라면 설치와 도구 등록, 첫 빌드를 에이전트에게 시켜도 됩니다, 에이전트 대화창에 이 한 줄만 붙여 넣습니다, 키는 들어 있지 않습니다

XenoCI 설정 안내를 읽고 따라 해 줘: https://xenoci.com/agent-setup

설정 안내는 키가 없으면 에이전트가 사람에게 xenocast login을 요청하고 키를 대화로 받지 않도록 적혀 있습니다, 키를 대화창에 붙여 넣었다면 콘솔 API 키에서 폐기하고 새 키를 xenocast login으로 넣으세요

확인

xenocast whoami

4. 첫 잡

프로젝트 폴더에서

xenocast build --script 'xcodebuild -version'

--script에는 올릴 폴더 안의 스크립트 파일 경로(./ci.sh)나 명령 문자열을 줍니다, 현재 폴더가 tar.gz로 올라가고, 잡이 접수되면 로그가 바로 흐르며, 끝나면 한 줄 요약이 남습니다

업로드: 파일 12개 (0.3MB)
잡 접수: job_Ab12Cd34
...
잡 job_Ab12Cd34 succeeded (종료 코드 0), 실행 25초, 과금 1분, 금액 $0.0396, 남은 잔액 $19.9604

명령의 종료 코드는 스크립트의 종료 코드와 같습니다, Ctrl+C로 멈추면 잡도 취소됩니다

5. 코딩 에이전트에 연결

2단계의 설치가 설치된 에이전트에 이미 등록했습니다, 그 뒤에 설치한 에이전트는 xenocast setup을 다시 실행하거나 아래처럼 직접 등록합니다, 설정 파일에 키를 넣지 않아도 저장된 키나 환경 변수를 읽습니다

claude mcp add --transport stdio --scope user xenoci -- "$(which xenocast)" mcp
codex mcp add xenoci -- "$(which xenocast)" mcp

Cursor는 ~/.cursor/mcp.json에 넣습니다

{
  "mcpServers": {
    "xenoci": { "command": "xenocast", "args": ["mcp"] }
  }
}

새 세션에서 "xenoci whoami 도구를 불러 줘"라고 하면 키의 조직과 워크스페이스가 보입니다

6. GitHub Actions에 연결

저장소 시크릿 XENOCI_API_KEY에 키를 넣고 워크플로에 액션을 추가합니다

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: Xeno-CI/build@v1
        with:
          api-key: ${{ secrets.XENOCI_API_KEY }}
          script: ./ci.sh

잔액이 모자라면

잔액이 1분 요금보다 적으면 잡은 시작하지 않고 종료 코드 3으로 끝납니다

잔액이 부족해 잡을 시작하지 않았습니다 (사용 가능 $0.0100, 1분 요금 $0.0396). 충전: https://xenoci.com/console/billing

충전은 콘솔에서 로그인한 사람이 합니다, CLI, MCP, 액션은 결제하지 않습니다

다음 단계