# MCP·API 기능 카탈로그

> 비즈스프링이 외부 AI 에이전트에 공개한 MCP 서버와 REST API가 각각 어떤 기능(function)을 제공하는지 목록으로 정리한 기술 레퍼런스입니다.

## 핵심 요약
- 비즈스프링이 외부 AI 에이전트에 공개한 MCP 서버와 REST API가 각각 어떤 기능(function)을 제공하는지 목록으로 정리한 기술 레퍼런스입니다.
- 연동 전에 호출 가능한 기능을 문서로 확인 가능
- 에이전트 설계 단계에서 도구 조합을 미리 검증
- 권한 등급에 맞춘 안전한 위임 구성
- TCR 커버 활동: O-X-4

## 한 줄 정의
비즈스프링이 외부 AI 에이전트에 공개한 MCP 서버와 REST API가 각각 어떤 기능(function)을 제공하는지 목록으로 정리한 기술 레퍼런스입니다.

## 시장 배경과 문제
MCP 로 연동하겠다고 결정한 뒤에도 「그래서 어떤 도구를 부를 수 있나」를 확인할 문서가 없으면 붙일 수 없습니다. 도구 이름과 인자를 모르면 에이전트 설계가 시작되지 않습니다.

## 해결 방식
비즈스프링은 mcp.gmp.ai(MCP)와 api.gmp.ai(REST)를 단일 진입점으로 두고, 제품별 MCP 서버를 경로로 분기합니다. 인증은 OAuth 2.1 을 쓰며, 계정은 소유자·관리자·에디터 세 등급으로 나뉘어 에디터는 허용된 범위 안에서만 읽고 씁니다. 아래는 현재 공개된 서버와 기능 계열입니다.

## 핵심 기능
- GEOcare 사용자 MCP — 49개 도구 (사이트 등록·크롤·EEAT 진단·SoM 분석·인용 조회·JSON-LD 동기화·알림)
- GEOcare 관리자 MCP — 20개 도구 (고객·사이트·딜·티켓·파이프라인·EEAT 등급 집계)
- ContentLauncher MCP — 73개 도구 (스토리·에피소드·리믹스·발행·성과 측정·영상 생성)
- ChatAd MCP — 16개 도구 (캠페인 조회, 예산·입찰 변경, 소재 생성·수정, 미게재 원인 진단)
- BizPO MCP — 15개 도구 (솔루션 검색·상세, TCR 진단·스택 설계·커버리지, 제안 맥락 생성)
- AIR MCP — 4개 도구 (매체별 광고비·점유율·시즌 추이·활성 광고주 수). 같은 데이터를 REST(OpenAPI 3.1)로도 제공
- REST API(api.gmp.ai) — 통합 지표·전환·GEO 데이터셋을 표준 스키마로 제공

## GEOcare 사용자 MCP — 도구 49종
생성형 AI 검색에서 브랜드가 얼마나 인용되는지 진단하고 고치는 서버입니다. 안내 도구(`geo_guide`)가 진단 순서를 단계별로 알려 줍니다.

| 계열 | 도구 |
|---|---|
| 사이트·준비 | `list_my_sites` · `register_site` · `get_site_profile` · `check_pipeline_readiness` · `geo_guide` |
| 수집·분석 실행 | `start_crawl` · `start_full_analysis` · `start_onestep` · `start_som_analysis` · `run_eeat_analysis` · `get_analysis_jobs` |
| SoM(점유) | `get_som_summary` · `get_som_trends` · `get_som_gap` · `get_som_runs` · `get_som_queries` · `generate_som_queries` · `add_som_queries` · `update_som_query` · `delete_som_queries` · `set_som_query_active` · `search_som_evidence` · `get_unmentioned_questions` |
| EEAT·점수 | `get_eeat_summary` · `get_eeat_pages` · `get_geo_scores` · `get_url_analysis` |
| 인용·평판 | `get_citations` · `get_citation_domains` · `get_source_share` · `get_brand_reputation` |
| 경쟁사 | `get_competitors` · `add_competitors` · `update_competitor` · `remove_competitors` · `get_competitor_som` |
| 구조화 데이터 | `get_jsonld_status` · `get_jsonld_elements` · `sync_jsonld` |
| 리포트·알림 | `get_reports` · `get_alerts` · `get_alert_settings` · `update_alert_settings` · `update_brand_settings` |
| 계정 | `get_plan_status` · `get_my_usage` · `admin_list_customers` · `admin_find_customer` · `admin_customer_overview` |

## ContentLauncher MCP — 도구 73종
정보 수집(Source)에서 작성(Remix), 인용 최적화 발행(Launch)까지의 콘텐츠 파이프라인을 도구로 노출합니다. 사용법은 `skill_list` · `skill_get` 로 먼저 읽는 구조입니다.

| 계열 | 도구 |
|---|---|
| 시작·설명서 | `get_me` · `list_workspaces` · `skill_list` · `skill_get` · `get_overview` |
| 스토리·시즌·회차 | `create_story` · `update_story` · `get_story` · `list_stories` · `clone_master_story` · `create_season` · `update_season` · `delete_season` · `create_episode` · `update_episode` · `get_episode` · `list_episodes` · `delete_episode` · `summarize_episode` |
| 기획·생성 | `generate_storyline` · `apply_storyline` · `generate_episode_draft` · `generate_text` · `generate_assist` · `generate_video` · `get_video_status` · `export_video_candidate` |
| 리믹스(채널 변환) | `create_remix` · `generate_remix` · `generate_remix_asset` · `update_remix` · `rewrite_remix_body` · `translate_remix` · `approve_remix` · `get_remix` · `list_remixes` · `delete_remix` |
| 발행·예약 | `create_launch` · `launch_now` · `schedule_launch` · `reschedule_launch` · `cancel_launch` · `cancel_schedule` · `relaunch` · `publish_content` · `record_naver_launch` · `get_launch` · `list_launches` · `list_schedules` · `check_live` |
| 채널 | `list_channels` · `get_channel` · `test_channel` · `list_master_channels` · `set_master_channel` |
| 자료·자산 | `list_sources` · `list_source_docs` · `ingest_external_brief` · `list_assets` · `update_asset` · `delete_asset` · `set_featured_image` |
| 검수·성과 | `review_content` · `set_approval_mode` · `measure_content` · `get_performance` · `get_citation_details` · `search_content` · `list_traces` · `get_job_status` |
| 페르소나·프롬프트 | `create_persona` · `list_personas` · `list_prompts` |

## ChatAd MCP — 도구 16종
OpenAI 광고와 Google 광고를 한 창구에서 다룹니다. 돈이 걸린 도구(`set_budget` · `set_bid` · `create_ad_group`)는 2단 확인 구조라, 먼저 호출하면 「지금 값 → 바뀔 값」만 돌려주고 광고는 바뀌지 않습니다. 사람이 승인한 뒤 확인 토큰과 함께 다시 불러야 실제로 반영됩니다.

| 계열 | 도구 |
|---|---|
| 시작 | `get_me` · `list_workspaces` · `current_settings` |
| 조회 | `list_campaigns` · `list_creatives` · `campaign_performance` · `compare_campaigns` · `why_not_serving` · `get_job_status` |
| 소재 | `create_ad` · `edit_ad_creative` · `set_context_hints` |
| 집행(2단 확인) | `set_budget` · `set_bid` · `create_ad_group` · `set_status` |

캠페인 삭제·보관 도구는 두지 않았습니다. 되돌릴 수 없는 조작이라 통로 자체를 만들지 않은 것입니다.

## BizPO MCP — 도구 15종
제품 카탈로그와 TCR 프레임워크를 질의하는 영업·컨설팅용 서버입니다.

| 계열 | 도구 |
|---|---|
| 제품 | `search_solutions` · `get_solution_detail` · `compare_solutions` · `find_integration` · `get_tech_reference` |
| TCR 진단 | `diagnose_customer_tcr` · `find_by_tcr` · `get_tcr_coverage` · `explain_tcr_journey` · `build_tcr_stack` |
| 영업 지원 | `route_opportunity` · `enrich_deal_context` · `generate_proposal_context` · `suggest_pitch_deck` · `suggest_poc_context` |

## GEOcare 관리자 MCP — 도구 20종
운영자용 서버입니다. 고객 데이터를 다루므로 관리자 권한에서만 열립니다.

| 계열 | 도구 |
|---|---|
| 현황 | `admin_dashboard` · `pipeline_summary` · `trial_status` · `geo_pipeline_guide` |
| 고객·사이트 | `list_customers` · `admin_customer_overview` · `list_sites` · `site_detail` |
| 영업 | `list_deals` · `deal_detail` · `list_tickets` · `email_feed` |
| 진단 이력 | `onestep_list` · `onestep_history` · `som_history` · `som_queries` · `som_execution_detail` · `search_som_evidence` |
| 품질 | `eeat_grade_summary` · `eeat_consulting_targets` |

## AIR MCP — 도구 4종
국내외 광고 매체 데이터를 시장·매체 수준으로 집계해 내는 서버입니다(`https://mcp.gmp.ai/air`). MCP(JSON-RPC 2.0 over HTTP)와 REST(OpenAPI 3.1)가 같은 데이터를 냅니다.

| 도구 | 내는 값 | 인자 |
|---|---|---|
| `get_korean_ad_market_overview` | 30일 매체별 광고비·점유율·활성 광고주 수 통합 | `verbosity`(compact/full) · `filter.media` |
| `get_media_market_share` | 광고비 기준 매체 점유율(`share_pct`·`rank`) | — |
| `get_seasonal_ad_spending_pattern` | 광고비 시계열 | `period`(30d/90d/180d) · `granularity`(day/week) |
| `get_advertiser_count_by_media` | 매체별 활성 광고주 수(`distinct_clients`·`rank`) | `verbosity`(compact/full) |

응답에는 언제나 네 개의 메타 블록이 함께 붙습니다 — `_citation`(제안 인용 형식과 CC-BY 4.0 라이선스) · `_methodology`(수집 출처·집계 단위·익명화·배치 시각) · `_metadata`(도구·티어·버전) · `_schema_org`(schema.org Dataset JSON-LD). 답변을 만드는 쪽이 숫자와 함께 출처와 산출 방법까지 읽을 수 있게 하려고 붙인 것입니다.

광고주별 API 키로 데이터가 격리되며, 다른 광고주 데이터를 요청하면 403 을 돌려줍니다. 대행사는 키 하나로 여러 광고주를 운영하고, 매체별 계정 매핑은 AIR 이 흡수합니다. 호출 한도는 요금제별로 나뉩니다(월 1,000회 ~ 20만 회 이상).

시장·매체 수준 집계 도구입니다. 캠페인·키워드·소재 단위 원천 데이터는 도입 시 연동 매체 기준으로 따로 구성합니다.

## 접속과 권한
| 항목 | 값 |
|---|---|
| MCP 진입점 | `https://mcp.gmp.ai/<서비스경로>` (예: `/air`) |
| REST 진입점 | `https://api.gmp.ai` |
| 개발자 콘솔·카탈로그 | `https://daas.gmp.ai` |
| 인증 | OAuth 2.1 / OIDC. 서버에 따라 광고주별 API 키(`Authorization: Bearer`) |
| 권한 등급 | 소유자(전체 데이터셋·정책) · 관리자(에디터 관리, API 키 발급·폐기, 감사 로그) · 에디터(허용 범위 내 읽기·쓰기) |

게이트웨이에 경로가 등록된 서버는 위 여섯 종이며, 그 밖의 내부 서버는 이관 진행 중이라 표준 경로로 열려 있지 않습니다.

## 기술 스택과 구성
비즈스프링 GrowthPlatform™ 3계층(수집·정규화·활용) 위에서 동작하며, 퍼스트파티 수집(LOGGER RT-Collect), 표준 지표 사전, API/MCP 개방 계층과 연결됩니다. 운영 규모 참고: 2026-09-06 실측 — 공개 MCP 서버 6종, 노출 도구 합계 177개(GEOcare 사용자 49·관리자 20, ContentLauncher 73, ChatAd 16, BizPO 15, AIR 4).

## 도입 효과
- 연동 전에 호출 가능한 기능을 문서로 확인 가능
- 에이전트 설계 단계에서 도구 조합을 미리 검증
- 권한 등급에 맞춘 안전한 위임 구성

## 실증 레퍼런스
연동 전에 호출 가능한 기능을 문서로 확인 가능: 이 효과는 비즈스프링이 운영하는 GP MySQL 183TB·4.6M행 데이터 기반(AMP 60TB + MA 36TB 3계층 체계) 위에서 MCP·API 기능 카탈로그가 커버하는 O-X-4 활동에 실제 적용되며 확인된 결과입니다. 아키텍처 상세: [GrowthPlatform™ 기술 레퍼런스](/kb/solutions/growthplatform-reference).

## 가격 모델
레퍼런스 문서

## 대상 고객
- AI 에이전트 개발자
- MCP 클라이언트 운영 파트너
- 기술 검토 담당자

## TCR 매핑
이 솔루션이 커버하는 TCR 활동과, 각 활동이 해결하는 고객 문제입니다.
- [O-X-4 데이터 개방·AI 연동](/kb/tcr/o-x-4): 데이터를 AI 에이전트와 사내 시스템이 쓰지 못합니다.

## 관련 솔루션
- [BizSpring DaaS](/kb/solutions/bizspring-daas) — 수집·정제된 마케팅 데이터를 API·MCP로 제공해 사내 시스템과 AI 에이전트가 바로 쓰게 하는 데이터 서비스입니다.
- [GMP 전사 API·MCP 허브](/kb/solutions/gmp-api-mcp-hub) — 비즈스프링 전 제품의 데이터와 기능을 API와 MCP로 노출하는 전사 통합 허브입니다.
- [gp-agent 에이전트 런타임](/kb/solutions/gp-agent-runtime) — 비즈스프링의 AI 제품들이 공통으로 올라타는 에이전트 런타임으로, 개별 판매 상품이 아니라 상품들이 딛고 서는 바닥입니다.
- [GEOcare.ai](/kb/solutions/geocare-ai) — ChatGPT·Perplexity 같은 생성형 검색이 우리 브랜드를 정확히 인용하도록 관리하는 GEO 운영 솔루션입니다.

## FAQ
**Q. MCP·API 기능 카탈로그는 무엇인가요?**

A. 비즈스프링이 외부 AI 에이전트에 공개한 MCP 서버와 REST API가 각각 어떤 기능(function)을 제공하는지 목록으로 정리한 기술 레퍼런스입니다.

**Q. MCP·API 기능 카탈로그는 어떤 문제를 해결하나요?**

A. MCP 로 연동하겠다고 결정한 뒤에도 「그래서 어떤 도구를 부를 수 있나」를 확인할 문서가 없으면 붙일 수 없습니다. 도구 이름과 인자를 모르면 에이전트 설계가 시작되지 않습니다.

**Q. MCP·API 기능 카탈로그의 도입 효과는 무엇인가요?**

A. 연동 전에 호출 가능한 기능을 문서로 확인 가능 에이전트 설계 단계에서 도구 조합을 미리 검증 권한 등급에 맞춘 안전한 위임 구성

**Q. MCP·API 기능 카탈로그는 TCR 프레임워크의 어떤 활동을 커버하나요?**

A. O-X-4 데이터 개방·AI 연동

**Q. MCP·API 기능 카탈로그의 가격 모델은 어떻게 되나요?**

A. 레퍼런스 문서

---
출처: https://bizspring.ai/kb/solutions/mcp-function-catalog · 최종 갱신 2026-09-06T11:10:06.31735+00:00
