BizRouter 비즈라우터

CLI로 콘솔 관리하기 · 에이전트 연동

BizRouter 콘솔에서 하는 일(API 키, 사용량, 조직 설정, 감사 로그, 스마트 라우팅, 보안)은 모두 HTTP API 입니다. bizrouter CLI는 그 API를 명령으로, 그리고 코딩 에이전트가 쓰는 MCP 도구로 제공합니다. 사람이 콘솔에서 클릭하는 것과 같은 권한으로, 같은 일을 터미널이나 에이전트가 대신합니다.

브라우저 승인 로그인

비밀번호를 터미널에 입력하지 않습니다. Google·웍스AI 계정과 2차 인증도 그대로 적용됩니다. 승인 화면에서는 요청한 프로그램·기기·IP를 보여주고, 이 기기용 API 키를 함께 발급할지 선택할 수 있습니다. 승인하면 두 가지가 저장됩니다. 저장되는 것 용도 유효 기간·관리 콘솔 세션 https://bizrouter.ai/api/web/* 콘솔 관리 API. bizrouter api , keys , usage 등과 MCP 도구가 사용합니다. 기본 30일. 조직 관리자가 「보안 정책」의 「CLI 로그인 세션 미사용 자동 로그아웃」을 켜면, 정한 시간 동안 콘솔 API를 부르지 않은 세션은 그 전에 만료되어 bizrouter login 으로 다시 로그인해야 합니다. 콘솔 「계정 → 로그인된 기기」 또는 bizrouter logout 으로 종료합니다. API 키 https://api.bizrouter.ai/v1/* 모델 호출. 실행되는 코딩 에이전트가 사용합니다. 일반 API 키와 같습니다. 콘솔 「API 키」에서 사용 범위·한도를 바꾸거나 삭제합니다. CI 나 컨테이너처럼 브라우저가 없는 곳에서는 BIZROUTER_API_KEY (모델 호출)와 BIZROUTER_SESSION_TOKEN (콘솔) 환경 변수를 쓰거나, 키만 붙여 넣는 bizrouter login --with-key 를 사용합니다. 세션은 로그인한 사용자의 권한(owner/member)을 그대로 따릅니다. 미사용 시간은 콘솔 API 호출만 셉니다. 모델을 호출하는 API 키는 콘솔을 거치지 않으므로 세션이 만료되어도 키 자체는 그대로 쓸 수 있고, 키의 만료·비활성화는 API 키 정책을 따릅니다. 만료된 세션으로 콘솔 명령을 실행하면 「콘솔 세션이 만료되었거나 유효하지 않습니다」 오류가 나며, bizrouter login 을 다시 실행하면 됩니다. 권한의 범위는 승인한 사람이 웹 콘솔에서 할 수 있는 일과 같습니다. API 키( sk-br-v1-… )로는 예전처럼 모델 호출만 되고 콘솔 API는 인증 오류가 납니다. 콘솔의 「사용량 조회 API」 키는 이 기능과 별개인 읽기 전용 키로, CLI는 쓰지도 바꾸지도 않습니다.

콘솔 관리 명령

모두 --json 을 지원합니다. 데이터를 바꾸는 명령은 확인을 묻고, 파이프에서는 --yes 가 있어야 실행됩니다. 래퍼가 없는 기능은 bizrouter api 로 호출합니다. 콘솔이 쓰는 OpenAPI 문서( https://bizrouter.ai/api/web/openapi.json )를 그대로 읽어 경로와 필드를 알려줍니다. 경로는 /api/web 기준입니다 /api-keys , api-keys , /api/web/api-keys , 전체 URL 모두 같은 경로로 인식합니다. 응답은 서버의 JSON을 그대로 출력하므로 jq 와 함께 쓸 수 있습니다. 오류일 때도 서버가 보낸 구조화된 오류를 {"status":…,"error":…} 로 출력합니다.

코딩 에이전트에게 콘솔 맡기기 (MCP)

「비즈라우터 세팅 다 해 줘」 한 문장으로 에이전트가 키를 만들고 정책을 설정하게 하려면 콘솔 세션이 있으면 bizrouter claude , bizrouter codex , bizrouter opencode 는 이 CLI를 MCP 서버 bizrouter 로 함께 연결합니다. 설정 파일은 바꾸지 않고 그 실행에만 적용됩니다( --no-mcp 로 끕니다). 에이전트가 쓰는 도구는 다음과 같습니다. 도구 하는 일 bizrouter_whoami 어느 계정·조직·역할로 로그인돼 있는지, API 키가 저장돼 있는지 bizrouter_openapi 콘솔 API 전체 목록과 각 경로의 요청·응답 필드 bizrouter_api 콘솔 API 호출. 조회(GET)는 자유롭게, 변경(POST·PUT·PATCH·DELETE)은 사용자에게 확인한 뒤 confirm: true 를 넘겨야 실행됩니다. bizrouter_models 이 키로 쓸 수 있는 모델과 원화 단가 bizrouter_docs 에이전트 매뉴얼과 이 개발 문서( llms-full.txt ) bizrouter_search BizRouter Search 호출. 에이전트가 법령·공시·통계·부동산·교통·논문·웹 검색 등 50종이 넘는 출처에서 실제 데이터를 찾아 출처와 함께 답을 받습니다. API 키로 동작하며 조회는 무료, 모델 토큰만 과금됩니다. Claude Code처럼 모델 별칭을 쓰는 에이전트는 이 도구로 Search를 씁니다(Responses API·Messages API로 카탈로그 모델 이름을 직접 쓰는 에이전트는 모델 이름의 :search 접미사로도 켤 수 있습니다). 다른 MCP 클라이언트(Claude Desktop, Cursor 등)에는 bizrouter mcp 를 stdio 서버로 등록합니다. 매뉴얼은 bizrouter docs 가 출력하며, 패키지 안의 AGENT_MANUAL.md 와 같습니다. 에이전트가 지켜야 하는 규칙 매뉴얼에 적혀 있고 도구 설명에도 반복됩니다. 조회는 자유, 변경은 사용자 확인 뒤에. 전체 API 키를 파일·커밋·대화에 남기지 않기. 결제·크레딧은 명시적으로 요청받았을 때만. 콘솔 접근 IP 제한과 2차 인증 필수 설정은 다른 구성원을 잠글 수 있으니 목록을 사용자와 확인하기. 감사 로그 저장을 끄면 꺼진 기간 요청의 내용은 복구되지 않는다고 알리기.

기계가 읽는 문서

이 개발 문서 전체는 빌드 때마다 같은 소스에서 https://bizrouter.ai/llms.txt (색인)과 https://bizrouter.ai/llms-full.txt (전문)로도 만들어집니다. 사람이 보는 페이지와 내용이 어긋나지 않습니다. bizrouter docs <주제> 와 MCP 도구 bizrouter_docs 가 이 파일을 읽습니다. 콘솔 관리 API의 정식 명세는 https://bizrouter.ai/api/web/openapi.json 입니다. 인증은 Authorization: Bearer <콘솔 세션 토큰> 이며, 브라우저 콘솔과 같은 조직 정책(2차 인증, 콘솔 IP 허용 목록)이 그대로 적용됩니다. 코딩 에이전트 실행 옵션과 도구별 전달 방식은 BizRouter CLI 문서에 있습니다.

bg-gray-100 px-1 rounded font-mono

주식회사 AI3 | 서울 강남구 영동대로85길 34 | support@bizrouter.ai