API & CLI — 콘솔의 모든 기능을 코드로

API 키 하나면 됩니다. 사용 가능한 모든 MCP 서버·스킬을 불러오고, 켜고 끄고, 사용량과 감사 로그를 읽고, 키와 통제 정책까지 — 웹 대시보드에서 하던 일을 전부 터미널과 스크립트에서. 게다가 대시보드엔 없는 일괄 토글·설정 내보내기/가져오기까지.

CLI — 한 줄 설치

의존성 없는 단일 파이썬 스크립트(3.8+). 어떤 명령에든 --json 을 붙이면 기계가 읽기 좋은 출력이 나와 CI에 바로 씁니다.

curl -fsSL https://agent.store/cli/install.sh | sh

agentstore login          # 콘솔 → API 키에서 발급한 as_live_ 키 붙여넣기
agentstore status
agentstore servers enable dart bok-stats

자주 쓰는 명령

터미널에서 도구를 바로 호출

커넥터(별도 MCP 클라이언트 앱)를 깔지 않아도, CLI가 게이트웨이의 /mcp 에 직접 말을 걸어 도구를 호출합니다. 켠 서버의 도구를 사람·스크립트·CI에서 바로 — 빠른 테스트와 자동화에 딱이에요.

agentstore servers enable archhub
agentstore tools --server archhub                       # 호출 가능한 도구 보기
agentstore call archhub_building_ledger address="서울특별시 중구 세종대로 110"
agentstore call <tool> --args '{"limit": 5}' --raw      # JSON 인자 · 원본 출력

스킬은 호출이 아니라 ‘지침’이에요. 내용을 보려면 agentstore skills cat <slug>, 로컬에 설치하려면 agentstore skills install.

코딩 에이전트에 연결

게이트웨이는 표준 streamable-HTTP MCP 서버라, MCP를 지원하는 에이전트라면 모두 동작해요. CLI가 각 도구의 정확한 설정을 키까지 채워서 출력합니다 — 붙여넣기만 하면 끝.

연결하면 켠 MCP 서버와 스킬이 모두 자동으로 붙어요(스킬은 MCP 리소스로 노출). 키 없이 모든 도구의 설정을 보려면 agentstore mcp-config · 또는 API GET /api/v1/mcp-config.

예: Cursor — ~/.cursor/mcp.json:

{
  "mcpServers": {
    "agent-store": {
      "url": "https://agent.store/mcp",
      "headers": { "X-API-Key": "as_live_…" }
    }
  }
}

이건 대시보드에 없어요

운영 구성을 그대로 복제하세요. 한 조직에서 켠 서버·스킬을 통째로 내보내, 새 조직이나 스테이징에 한 줄로 똑같이 맞춥니다.

# 운영 구성을 스테이징에 그대로 복제
agentstore --key $PROD    profile export -o setup.json
agentstore --key $STAGING profile import -f setup.json --prune

REST API

기준 주소 https://agent.store/api/v1. AI 클라이언트에 넣는 그 키를 그대로 헤더에 담으면 됩니다 — 별도 admin 스코프가 필요 없어요. 읽기는 모든 키로, 켜고 끄는 변경은 웹 콘솔과 똑같이 조직 관리자(owner/org_admin) 키만 가능합니다(개인 조직은 자동으로 관리자).

curl -H "X-API-Key: as_live_…" https://agent.store/api/v1/status

계정 · 현황

MCP 서버

스킬

사용량 · 감사 · 결제

키 · 통제 · 멤버

프로필 (구성 복제)