비즈니스 모델 검색을 REST, GPTs Action, MCP로 연결하는 방법

API로 할 수 있는 일

Next BM 200 API는 산업별 비즈니스 모델 아이디어와 분석 결과를 외부 도구에서 검색할 수 있게 하는 인터페이스입니다. 웹 화면에서 직접 검색하는 대신, 사내 대시보드, 리서치 자동화 워크플로우, Custom GPT, MCP 기반 AI 클라이언트에서 같은 검색 자산을 호출할 수 있습니다.

빠른 시작

curl -X POST https://nextbm200.com/mcp_server/search \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer nbm_live_발급받은_API_키" \
  -d '{"query":"스마트팜 구독 모델","top_k":5}'

API 사용량 제한

아래 표는 현재 운영 화면의 API 제한 설정 기준입니다. 사용량 제한은 계정의 BM 검색 및 API 호출 카운터에 적용되며, 외부 REST 호출이나 MCP/GPTs Action 호출도 같은 계정 한도를 공유합니다.

엔드포인트

검색 필터

filter는 선택 항목입니다. 지원 필드는 industry_name, version, seq, doc_type, canvas_type이며, 연산자는 $eq와 $in을 사용할 수 있습니다.

{
  "query": "B2B SaaS 기반 모빌리티 운영 모델",
  "top_k": 5,
  "filter": {
    "industry_name": {"$eq": "Mobility"},
    "doc_type": {"$in": ["all-ideas", "business-model-story"]}
  }
}

호출 예시

curl -X GET "https://nextbm200.com/mcp_server/weekly-bm?include_monday=true" \
  -H "Authorization: Bearer nbm_live_발급받은_API_키"

const response = await fetch("https://nextbm200.com/mcp_server/search", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer " + process.env.NEXTBM200_API_KEY
  },
  body: JSON.stringify({
    query: "반도체 산업의 AI 기반 수율 개선 비즈니스 모델",
    top_k: 5
  })
});

const data = await response.json();

import os
import requests

response = requests.post(
    "https://nextbm200.com/mcp_server/search",
    headers={
        "Content-Type": "application/json",
        "Authorization": f"Bearer {os.environ['NEXTBM200_API_KEY']}",
    },
    json={
        "query": "헬스케어 예방관리 구독형 비즈니스 모델",
        "top_k": 5,
    },
    timeout=20,
)

response.raise_for_status()
data = response.json()

GPTs Action으로 연결하기

Custom GPT에서 자연어 질의를 Next BM 200 API 호출로 바꾸려면 GPT Builder의 Actions 설정에서 인증과 OpenAPI 스키마를 등록합니다. OpenAI 공식 문서 기준으로 GPT Actions는 외부 REST API를 OpenAPI 스키마로 설명하고, 인증은 None, API Key, OAuth 중 선택합니다.

openapi: 3.1.0
info:
  title: Next BM 200 API
  version: 1.0.0
  description: Search Next BM 200 business model database and retrieve weekly business model content.
servers:
  - url: https://nextbm200.com/mcp_server
paths:
  /search:
    post:
      operationId: searchBusinessModels
      summary: Search business model ideas and analysis
      security:
        - bearerAuth: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - query
              properties:
                query:
                  type: string
                  maxLength: 500
                  description: Natural language search query about industry, customer problem, technology, or business model.
                top_k:
                  type: integer
                  minimum: 1
                  maximum: 20
                  default: 5
                filter:
                  type: object
                  additionalProperties: false
                  description: Optional exact-match filters. Supported fields include industry_name, version, seq, doc_type, and canvas_type.
                  properties:
                    industry_name:
                      type: string
                      maxLength: 100
                    version:
                      type: string
                      maxLength: 100
                    seq:
                      type: integer
                    doc_type:
                      type: string
                      maxLength: 100
                    canvas_type:
                      type: string
                      maxLength: 100
      responses:
        "200":
          description: Search results
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
  /weekly-bm:
    get:
      operationId: getWeeklyBusinessModel
      summary: Get the current weekly business model overview
      security:
        - bearerAuth: []
      parameters:
        - name: include_monday
          in: query
          required: false
          schema:
            type: boolean
            default: false
      responses:
        "200":
          description: Weekly business model content
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

참고: GPTs Action의 UI와 옵션명은 OpenAI 운영 정책에 따라 바뀔 수 있습니다. 핵심은 Bearer API Key 인증과 OpenAPI 스키마 등록입니다.

MCP 형태로 연결하기

Next BM 200 API 자체는 REST API입니다. MCP를 지원하는 클라이언트에서 쓰려면 작은 MCP 래퍼 서버를 만들고, MCP tool handler가 Next BM 200 REST API를 호출하도록 감싸는 구조가 가장 단순합니다. 현재 Node 래퍼는 search_business_models 도구를 제공하고, 내부적으로 /mcp_server/search 엔드포인트를 호출합니다.

{
  "mcpServers": {
    "nextbm200-search": {
      "command": "node",
      "args": ["mcp-server-wrapper.js"],
      "cwd": "/path/to/nextbm200",
      "env": {
        "MCP_SERVER_URL": "https://nextbm200.com/mcp_server",
        "MCP_API_KEY": "nbm_live_발급받은_API_키"
      }
    }
  }
}

로컬 래퍼는 Node.js 18 이상과 @modelcontextprotocol/sdk 패키지를 사용합니다. 클라이언트가 MCP 서버를 다시 로드한 뒤, "스마트팜에서 구독형 BM을 찾아줘" 같은 자연어 요청으로 search_business_models 도구를 호출할 수 있습니다.

const NEXTBM_API_BASE = process.env.MCP_SERVER_URL ?? "https://nextbm200.com/mcp_server";
const NEXTBM_API_KEY = process.env.MCP_API_KEY;

async function nextbm(path, { method = "GET", body } = {}) {
  const headers = { Authorization: `Bearer ${NEXTBM_API_KEY}` };
  if (body) headers["Content-Type"] = "application/json";

  const res = await fetch(`${NEXTBM_API_BASE}${path}`, {
    method,
    headers,
    body: body ? JSON.stringify(body) : undefined,
  });
  return res.json();
}

export async function searchBusinessModels({ query, top_k = 5, filter = undefined }) {
  return nextbm("/search", {
    method: "POST",
    body: { query, top_k, filter },
  });
}

보안 운영 기준

오류 대응

AI 에이전트 프롬프트 예시

GPTs Action이나 MCP로 연결한 뒤에는 모델에게 도구 사용 기준을 분명히 알려주는 것이 좋습니다. 다음 문장을 시스템 지침 또는 GPT instructions에 넣으면 검색 결과를 더 안정적으로 활용할 수 있습니다.

사용자가 산업, 고객 문제, 수익모델, 기술 트렌드, 신규 사업 아이디어를 물으면
Next BM 200 API의 searchBusinessModels 또는 search_business_models 도구를 먼저 호출한다.
검색 결과는 그대로 복사하지 말고, 산업 맥락, 고객 세그먼트, 수익화 방식, 실행 리스크로 재구성한다.
불확실한 부분은 추정이라고 표시하고, 중요한 의사결정에는 추가 검증이 필요하다고 안내한다.