API & MCP 문서

Claude Code, AI 에이전트, 또는 직접 API 호출로 BizScope AI의 38개 분석 도구를 사용하세요.

빠른 시작 (1줄)

Claude Code에서 이 명령어 하나면 38개 도구가 즉시 활성화됩니다:

claude mcp add bizscope -- npx -y @bizscope-ai/mcp

API 키가 있는 경우:

claude mcp add bizscope -- npx -y @bizscope-ai/mcp --key YOUR_API_KEY

또는 npm 없이 직접 URL:

claude mcp add --transport http bizscope https://bizscope-rho.vercel.app/api/mcp

설치 후 Claude에게 이렇게 말하세요:

"Analyze Samsung Electronics"
"Validate my startup idea for an AI tutoring app"
"Run a SWOT analysis on Apple"

npm 패키지

로컬 stdio 프록시로 동작합니다. BizScope 서버에 연결하여 JSON-RPC를 중계합니다.

# npmjs.com/package/@bizscope-ai/mcp
npx -y @bizscope-ai/mcp
npx -y @bizscope-ai/mcp --key YOUR_API_KEY

Claude Desktop

Claude Desktop 앱에서 사용하려면 설정 파일에 아래 내용을 추가하세요:

{
  "mcpServers": {
    "bizscope": {
      "command": "npx",
      "args": ["-y", "@bizscope-ai/mcp"],
      "env": {
        "BIZSCOPE_API_KEY": "your_key_here"
      }
    }
  }
}

설정 파일 위치:

macOS ~/Library/Application Support/Claude/claude_desktop_config.json
Windows %APPDATA%\Claude\claude_desktop_config.json

Claude Code 플러그인

슬래시 커맨드와 자동 스킬이 포함된 플러그인입니다. 마켓플레이스 등록 후 사용 가능합니다.

/plugin install bizscope-ai@claude-plugins-official

포함된 커맨드:

/analyze Samsung Electronics — Company analysis
/analyze idea: AI tutoring app — Idea validation
/search market trends AI — Web search
/finance Tesla — Financial data

MCP 엔드포인트 (직접 호출)

어떤 MCP 클라이언트에서든 직접 연결할 수 있습니다. Streamable HTTP (권장) 또는 SSE를 지원합니다.

Streamable HTTP (권장)

POST https://bizscope-rho.vercel.app/api/mcp
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY

{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}
{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}
{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"bizscope-web-search","arguments":{"query":"Samsung Electronics revenue 2025"}}}

SSE (레거시)

GET https://bizscope-rho.vercel.app/api/mcp  -> SSE stream
POST https://bizscope-rho.vercel.app/api/mcp?sessionId=xxx  -> JSON-RPC

도구 목록 (38개)

카테고리	개수	예시
Company Analysis	18	`company-overview, pest-analysis, swot-summary, final-implications`
Idea Validation	15	`idea-overview, market-size, unit-economics, action-plan`
Utilities	5	`web-search, financial-data, income-history, balance-sheet, stock-history`

인증

API 키가 설정된 경우 Bearer 토큰으로 인증합니다. 키가 없으면 오픈 액세스입니다.

# Header
Authorization: Bearer YOUR_API_KEY

# Or via environment variable
export BIZSCOPE_API_KEY=your_key_here

# Or via CLI argument
npx -y @bizscope-ai/mcp --key your_key_here