BizSpring.ai

지식센터 / 레퍼런스

19 REST API (개발자·시스템 연동용) — GEOcare 사용자 매뉴얼

19 REST API (개발자·시스템 연동용) 19 REST API (개발자·시스템 연동용) 표준 HTTP로 GEOcare를 외부 시스템·자체 서비스에 연동 개발자·연동 · 경로 /v3/rest api 📌 목적: REST API는 MCP와 똑같은 기능 을 표준 HTTP(GET/POS

핵심 요약

    # 19 REST API (개발자·시스템 연동용)

    19 REST API (개발자·시스템 연동용)

    _표준 HTTP로 GEOcare를 외부 시스템·자체 서비스에 연동_

    개발자·연동 · 경로 /v3/rest-api

    > 📌 목적: REST API는 MCP와 똑같은 기능을 표준 HTTP(GET/POST)로 제공합니다. AI에서도 쓸 수 있지만, 주로 다른 시스템과의 연동(예: bmp.ai)·자체 GEO 데이터 기반 서비스 확장을 하려는 개발자를 위한 것입니다.

    MCP vs REST API — 무엇을 쓸까

    구분MCPREST API
    주 사용자Claude 등 AI/LLM 에이전트개발자 · 연동 시스템(bmp.ai 등)
    방식JSON-RPC · 자동 도구 인식(tools/list)표준 HTTP · OpenAPI 자동 인식
    연결AI 클라이언트 커넥터에 등록코드/도구에서 endpoint 호출
    인증계정 토큰(공용)계정 토큰(공용 — 같은 키)
    대표 용도대화로 조회·실행시스템 확장·자동화·자체 데이터 활용

    누구를 위한 것인가

    연동 방법 (3단계)

    1. API 키 발급 — 계정 메뉴 → 'REST API'(/v3/rest-api)에서 발급. MCP 키와 공용(계정 단위).
    2. Base URL · 인증 설정 — Authorization 헤더에 Bearer 토큰을 담아(또는 쿼리 파라미터 key) Base URL을 호출.
    3. 호출 또는 OpenAPI import — 직접 HTTP 호출하거나, openapi.json을 ChatGPT Actions · Make · Zapier · Postman에 import해 자동 호출.

    엔드포인트

    메서드 · 경로용도
    GET /api도구 카탈로그(공개) — 사용 가능한 도구 목록
    GET/POST /api/call디스패치형 호출 — {tool, arguments}
    GET/POST /api/call/{tool}도구별 경로 — OpenAPI operation 1:1 (arguments = 본문/쿼리)
    GET /openapi.jsonOpenAPI 3.1 명세(공개) — 외부 도구 자동 import용
    GET /docsAPI 문서(Redoc) — 사람용 매뉴얼

    Base URL: https://nntuztaehnywdbttrajy.supabase.co/functions/v1/geocare-user-mcp/api

    호출 예제

    ① 내 사이트 목록 (가장 먼저)

    ② SoM 요약 조회 (site\_domain 지정)

    { "site_domain": "example.com" }

    표준 자동 연동 (OpenAPI)

    openapi.json을 import하면 엔드포인트·파라미터가 자동 인식됩니다 — ChatGPT Custom GPT(Actions) · Make · Zapier · Postman · bmp.ai. (= MCP가 AI에게 도구를 자동 인식시키는 것의 REST 표준판)

    제공 기능(도구)

    MCP와 동일한 도구 세트(약 41종)를 제공합니다 — 전체 목록은 \[18 MCP 연결] 페이지의 도구 카탈로그 참조. 라이브 최신 목록은 GET /openapi.json.

    사용 규칙

    다른 표현: Markdown · JSON · 최종 갱신 2026-08-23