{ "id": "f2506212-3e3d-4963-ad2c-86be5e46348c", "slug": "ref/manual/geocare-사용자-매뉴얼-18-mcp-연결-ai-에이전트용", "doc_type": "ref", "title": "18 MCP 연결 (AI 에이전트용) — GEOcare 사용자 매뉴얼", "title_en": null, "one_liner": " 18 MCP 연결 (AI 에이전트용) 18 MCP 연결 (AI 에이전트용) Claude 등 AI/LLM 에이전트가 GEOcare를 대화로 바로 쓰게 하는 표준 연결 개발자·연동 · 경로 /v3/user mcp 📌 목적: \\ \\ MCP(Model Context Protocol)\\ \\ ", "summary_bullets": [], "body_md": "# 18 MCP 연결 (AI 에이전트용)\n\n## 18 MCP 연결 (AI 에이전트용)\n\n_Claude 등 AI/LLM 에이전트가 GEOcare를 대화로 바로 쓰게 하는 표준 연결_\n\n`개발자·연동 · 경로 /v3/user-mcp`\n\n> **📌 목적:** \\*\\*MCP(Model Context Protocol)\\*\\*는 Claude · ChatGPT 같은 **AI/LLM 에이전트**를 위한 표준 규약입니다. 연결만 해두면 AI가 GEOcare 기능(도구)을 **스스로 인식**해, 사용자가 **자연어로 묻고 시키면** 알맞은 도구를 호출합니다. (코딩 불필요)\n\n### 누구를 위한 것인가\n\n* ✅ Claude Desktop · Claude.ai · Claude Code, ChatGPT, Manus 등 MCP 지원 AI 에이전트 사용자\n* ✅ 대화만으로 GEO 데이터를 조회/실행하려는 마케터·운영자·경영자\n* ※ 시스템 연동·자체 서비스 확장(개발자)은 \\[19 REST API] 페이지 참조\n\n### 연동 방법 (3단계)\n\n1. **API 키 발급** — 계정 메뉴 → 'MCP 연결 설정'(/v3/user-mcp)에서 개인 키 발급(계정 단위).\n2. **AI 클라이언트에 등록** — 단일 MCP 엔드포인트 URL+키를 클라이언트별 방식으로 등록(헤더 Bearer 또는 ?token=).\n3. **대화로 사용** — AI가 도구를 자동 인식(tools/list). 자연어로 묻고 시키면 도구를 호출해 답합니다.\n\n### 엔드포인트 · 인증\n\n| 항목 | 값 |\n| ----- | ------------------------------------------------------------------------ |\n| 엔드포인트 | `https://nntuztaehnywdbttrajy.supabase.co/functions/v1/geocare-user-mcp` |\n| 프로토콜 | MCP (JSON-RPC) — initialize · tools/list · tools/call |\n| 인증 | 개인 토큰 — `Authorization: Bearer <키>` (또는 `?token=<키>`) |\n| 스코프 | 계정 단위 — 키 1개로 접근 가능한 모든 사이트 (호출마다 site\\_domain 지정) |\n\n### 제공 기능(도구) 카탈로그\n\nMCP · REST API가 **동일하게** 제공하는 도구 세트(약 41종). 조회(read)는 바로, 실행(action)은 `confirm:true`로 동작. 관리자(admin) 도구는 super\\_admin 전용. 라이브 최신 목록은 `GET /api` 또는 `GET /openapi.json`.\n\n#### 조회 (read) · 약 28종\n\n| 도구 | 설명 |\n| --------------------------- | ------------------------------------------------------- |\n| list\\_my\\_sites | 내 계정이 접근 가능한 사이트 목록 (다른 도구의 site\\_domain 확인 — 먼저 호출 권장) |\n| get\\_site\\_profile | 사이트 브랜드 프로파일 (브랜드명·별칭·업종·회사명·플랜) |\n| get\\_plan\\_status | 플랜·쿼터(사용량) 상태 |\n| check\\_pipeline\\_readiness | 분석 사전 준비상태 점검 (도메인·브랜드·경쟁사) |\n| get\\_geo\\_scores | GEO/SEO 종합 점수 + 5대 KPI |\n| get\\_url\\_analysis | URL별 분석 결과 (KPI·스키마·메타) |\n| get\\_eeat\\_summary | EEAT 4축(경험·전문성·권위·신뢰) 요약 |\n| get\\_eeat\\_pages | 페이지별 EEAT 점수 |\n| get\\_som\\_summary | SoM(AI 점유율) 요약 — 엔진별·의도별 |\n| get\\_som\\_queries | SoM 질문(쿼리) 목록 |\n| get\\_som\\_runs | SoM 분석 실행 이력 |\n| get\\_competitors | 등록된 경쟁사 목록 |\n| get\\_competitor\\_som | 경쟁사별 SoM 점유율 |\n| get\\_som\\_gap | 선두(1위) 대비 격차 분석 |\n| get\\_som\\_trends | SoM 추세(시계열) |\n| get\\_unmentioned\\_questions | 우리가 미언급된 질문 = 개선 기회 |\n| search\\_som\\_evidence | AI 응답 원문(근거) 검색 |\n| get\\_source\\_share | AI 인용 점유율(인용 해자/Moat) |\n| get\\_citations | AI 응답이 인용한 출처 URL |\n| get\\_citation\\_domains | 인용 도메인 카탈로그 |\n| get\\_jsonld\\_status | JSON-LD 송출 상태 |\n| get\\_jsonld\\_elements | 송출된 JSON-LD 요소(schema\\_type별) |\n| get\\_reports | 정기진단 보고서 목록 |\n| get\\_brand\\_reputation | 브랜드 평판 5대 지표 |\n| get\\_alerts | 알림(위기·기회·운영) 조회 |\n| get\\_alert\\_settings | 알림 임계값 설정 조회 |\n| get\\_analysis\\_jobs | 분석 작업(잡) 상태 |\n| geo\\_guide | GRAND G1 \\~ G7 단계별 할 일·도구·화면 가이드 |\n\n#### 실행 (action · confirm 필요) · 10종\n\n| 도구 | 설명 |\n| ----------------------- | ----------------------------------------------- |\n| start\\_onestep | 원스텝(GRAND) 풀 파이프라인 시작 — 크롤→EEAT→SoM→JSON-LD→리포트 |\n| start\\_full\\_analysis | 전체 분석 시작 |\n| start\\_crawl | 사이트 크롤 시작 |\n| run\\_eeat\\_analysis | EEAT 분석 실행 |\n| generate\\_som\\_queries | SoM 질문(쿼리) 생성 |\n| add\\_competitors | 경쟁사 추가 |\n| start\\_som\\_analysis | SoM(AI 점유율) 분석 실행 |\n| sync\\_jsonld | JSON-LD 생성·송출(동기화) |\n| update\\_brand\\_settings | 브랜드 설정(브랜드명·별칭·업종) 저장 |\n| update\\_alert\\_settings | 알림 임계값 저장 |\n\n#### 관리자 (admin · super\\_admin 전용) · 3종\n\n| 도구 | 설명 |\n| ------------------------- | -------------------------- |\n| admin\\_list\\_customers | 전체 고객 목록 (super\\_admin 전용) |\n| admin\\_find\\_customer | 고객 검색 (super\\_admin 전용) |\n| admin\\_customer\\_overview | 고객 종합 현황 (super\\_admin 전용) |\n\n### 사용 규칙\n\n* 계정 단위 — 먼저 `list_my_sites`로 사이트 확인 → 이후 호출에 `site_domain` 전달\n* 실행형(action)은 `confirm:true` 필요 (2단계 안전장치)\n* 키 = 계정 자격증명. 노출 시 'MCP 연결 설정'에서 즉시 폐기\n", "related_slugs": [], "faq": [], "jsonld": null, "keywords": [], "source_id": "gitbook:ypp1FQXeKh9584utppqp:VyGPCBGVLoN99aOx44aE", "video_url": null, "duration_sec": null, "thumbnail_url": null, "image_url": null, "caption": null, "solution_slug": null, "captured_at": null, "width": null, "height": null, "created_at": "2026-08-23T14:32:40.831494+00:00", "updated_at": "2026-08-23T14:32:40.831494+00:00", "visibility": "public", "source_stage": "1", "anonymized": true, "source_key": "gitbook-manuals", "origin": "ingest", "locked": false, "locked_by": null, "locked_at": null, "gate_state": { "g1": { "hits": [], "pass": true }, "g2": { "pass": true, "total": 37, "issues": [ "숫자·규격 같은 검증 가능한 구체가 부족합니다", "핵심 요약 불릿이 3개 미만입니다", "Q&A 쌍이 3개 미만입니다" ], "applies": true }, "g3": { "pass": true, "required": false }, "stage": "1", "decided_at": "2026-08-23T14:32:37.773Z" }, "raw_id": "a7137a52-7b9f-484f-a0cf-b8697c6fd2a4", "search_text": "18 MCP 연결 (AI 에이전트용) — GEOcare 사용자 매뉴얼 18 MCP 연결 (AI 에이전트용) 18 MCP 연결 (AI 에이전트용) Claude 등 AI/LLM 에이전트가 GEOcare를 대화로 바로 쓰게 하는 표준 연결 개발자·연동 · 경로 /v3/user mcp 📌 목적: \\ \\ MCP(Model Context Protocol)\\ \\ # 18 MCP 연결 (AI 에이전트용)\n\n## 18 MCP 연결 (AI 에이전트용)\n\n_Claude 등 AI/LLM 에이전트가 GEOcare를 대화로 바로 쓰게 하는 표준 연결_\n\n`개발자·연동 · 경로 /v3/user-mcp`\n\n> **📌 목적:** \\*\\*MCP(Model Context Protocol)\\*\\*는 Claude · ChatGPT 같은 **AI/LLM 에이전트**를 위한 표준 규약입니다. 연결만 해두면 AI가 GEOcare 기능(도구)을 **스스로 인식**해, 사용자가 **자연어로 묻고 시키면** 알맞은 도구를 호출합니다. (코딩 불필요)\n\n### 누구를 위한 것인가\n\n* ✅ Claude Desktop · Claude.ai · Claude Code, ChatGPT, Manus 등 MCP 지원 AI 에이전트 사용자\n* ✅ 대화만으로 GEO 데이터를 조회/실행하려는 마케터·운영자·경영자\n* ※ 시스템 연동·자체 서비스 확장(개발자)은 \\[19 REST API] 페이지 참조\n\n### 연동 방법 (3단계)\n\n1. **API 키 발급** — 계정 메뉴 → 'MCP 연결 설정'(/v3/user-mcp)에서 개인 키 발급(계정 단위).\n2. **AI 클라이언트에 등록** — 단일 MCP 엔드포인트 URL+키를 클라이언트별 방식으로 등록(헤더 Bearer 또는 ?token=).\n3. **대화로 사용** — AI가 도구를 자동 인식(tools/list). 자연어로 묻고 시키면 도구를 호출해 답합니다.\n\n### 엔드포인트 · 인증\n\n| 항목 | 값 |\n| ----- | ------------------------------------------------------------------------ |\n| 엔드포인트 | `https://nntuztaehnywdbttrajy.supabase.co/functions/v1/geocare-user-mcp` |\n| 프로토콜 | MCP (JSON-RPC) — initialize · tools/list · tools/call |\n| 인증 | 개인 토큰 — `Authorization: Bearer <키>` (또는 `?token=<키>`) |\n| 스코프 | 계정 단위 — 키 1개로 접근 가능한 모든 사이트 (호출마다 site\\_domain 지정) |\n\n### 제공 기능(도구) 카탈로그\n\nMCP · REST API가 **동일하게** 제공하는 도구 세트(약 41종). 조회(read)는 바로, 실행(action)은 `confirm:true`로 동작. 관리자(admin) 도구는 super\\_admin 전용. 라이브 최신 목록은 `GET /api` 또는 `GET /openapi.json`.\n\n#### 조회 (read) · 약 28종\n\n| 도구 | 설명 |\n| --------------------------- | ------------------------------------------------------- |\n| list\\_my\\_sites | 내 계정이 접근 가능한 사이트 목록 (다른 도구의 site\\_domain 확인 — 먼저 호출 권장) |\n| get\\_site\\_profile | 사이트 브랜드 프로파일 (브랜드명·별칭·업종·회사명·플랜) |\n| get\\_plan\\_status | 플랜·쿼터(사용량) 상태 |\n| check\\_pipeline\\_readiness | 분석 사전 준비상태 점검 (도메인·브랜드·경쟁사) |\n| get\\_geo\\_scores | GEO/SEO 종합 점수 + 5대 KPI |\n| get\\_url\\_analysis | URL별 분석 결과 (KPI·스키마·메타) |\n| get\\_eeat\\_summary | EEAT 4축(경험·전문성·권위·신뢰) 요약 |\n| get\\_eeat\\_pages | 페이지별 EEAT 점수 |\n| get\\_som\\_summary | SoM(AI 점유율) 요약 — 엔진별·의도별 |\n| get\\_som\\_queries | SoM 질문(쿼리) 목록 |\n| get\\_som\\_runs | SoM 분석 실행 이력 |\n| get\\_competitors | 등록된 경쟁사 목록 |\n| get\\_competitor\\_som | 경쟁사별 SoM 점유율 |\n| get\\_som\\_gap | 선두(1위) 대비 격차 분석 |\n| get\\_som\\_trends | SoM 추세(시계열) |\n| get\\_unmentioned\\_questions | 우리가 미언급된 질문 = 개선 기회 |\n| search\\_som\\_evidence | AI 응답 원문(근거) 검색 |\n| get\\_source\\_share | AI 인용 점유율(인용 해자/Moat) |\n| get\\_citations | AI 응답이 인용한 출처 URL |\n| get\\_citation\\_domains | 인용 도메인 카탈로그 |\n| get\\_jsonld\\_status | JSON-LD 송출 상태 |\n| get\\_jsonld\\_elements | 송출된 JSON-LD 요소(schema\\_type별) |\n| get\\_reports | 정기진단 보고서 목록 |\n| get\\_brand\\_reputation | 브랜드 평판 5대 지표 |\n| get\\_alerts | 알림(위기·기회·운영) 조회 |\n| get\\_alert\\_settings | 알림 임계값 설정 조회 |\n| get\\_analysis\\_jobs | 분석 작업(잡) 상태 |\n| geo\\_guide | GRAND G1 \\~ G7 단계별 할 일·도구·화면 가이드 |\n\n#### 실행 (action · confirm 필요) · 10종\n\n| 도구 | 설명 |\n| ----------------------- | ----------------------------------------------- |\n| start\\_onestep | 원스텝(GRAND) 풀 파이프라인 시작 — 크롤→EEAT→SoM→JSON-LD→리포트 |\n| start\\_full\\_analysis | 전체 분석 시작 |\n| start\\_crawl | 사이트 크롤 시작 |\n| run\\_eeat\\_analysis | EEAT 분석 실행 |\n| generate\\_som\\_queries | SoM 질문(쿼리) 생성 |\n| add\\_competitors | 경쟁사 추가 |\n| start\\_som\\_analysis | SoM(AI 점유율) 분석 실행 |\n| sync\\_jsonld | JSON-LD 생성·송출(동기화) |\n| update\\_brand\\_settings | 브랜드 설정(브랜드명·별칭·업종) 저장 |\n| update\\_alert\\_settings | 알림 임계값 저장 |\n\n#### 관리자 (admin · super\\_admin 전용) · 3종\n\n| 도구 | 설명 |\n| ------------------------- | -------------------------- |\n| admin\\_list\\_customers | 전체 고객 목록 (super\\_admin 전용) |\n| admin\\_find\\_customer | 고객 검색 (super\\_admin 전용) |\n| admin\\_customer\\_overview | 고객 종합 현황 (super\\_admin 전용) |\n\n### 사용 규칙\n\n* 계정 단위 — 먼저 `list_my_sites`로 사이트 확인 → 이후 호출에 `site_domain` 전달\n* 실행형(action)은 `confirm:true` 필요 (2단계 안전장치)\n* 키 = 계정 자격증명. 노출 시 'MCP 연결 설정'에서 즉시 폐기\n", "embedding": null, "embedded_at": null, "embedding_hash": null, "backlinks": [], "html_url": "https://bizspring.ai/kb/ref/manual/geocare-사용자-매뉴얼-18-mcp-연결-ai-에이전트용", "markdown_url": "https://bizspring.ai/kb/ref/manual/geocare-사용자-매뉴얼-18-mcp-연결-ai-에이전트용.md" }