MCP 가이드

AI를 AILabsAudit에 연결하세요

ChatGPT, Claude, Gemini 또는 기타 MCP 호환 AI 어시스턴트에서 직접 감사, 고객 및 데이터에 액세스하세요. 5분 안에 구성 완료.

목차

  1. MCP란 무엇인가요?
  2. API 키 생성하기
  3. AI 연결하기
  4. 무엇을 할 수 있나요?
  5. 사용 가능한 모든 도구
  6. 고객에게 MCP 액세스 권한 부여하기
  7. 자주 묻는 질문

MCP란 무엇인가요?

MCP(Model Context Protocol)는 AI 어시스턴트(ChatGPT, Claude 또는 Gemini 등)가 외부 서비스에 직접 연결할 수 있도록 하는 개방형 표준입니다.

구체적으로, 이는 AI와 대화하면서 감사를 조회하거나, 고객을 나열하거나, 점수를 분석하거나, 데이터를 내보내도록 요청할 수 있다는 것을 의미합니다 — 대화를 떠나지 않고도 모든 작업이 가능합니다.

예시: ChatGPT에 다음과 같이 입력합니다: "Dupont 고객의 최신 감사를 AI별 점수와 함께 보여줘" — 그러면 ChatGPT가 AILabsAudit에서 직접 답변을 가져옵니다.

AILabsAudit의 MCP 서버는 모든 데이터에 액세스할 수 있는 235개 이상의 도구를 제공합니다: 고객, 감사, 점수, PDF 보고서, 크레딧, 시나리오 등. 새로운 도구: get_geo_checklist, get_hallucinated_urls, get_native_vs_web_scores, toggle_showcase, get_scheduled_audits, create_client, get_blog_articlesget_glossary_terms.

1단계 — API 키 생성하기

AI를 연결하기 전에 MCP API 키가 필요합니다. 이는 AI가 AILabsAudit에서 인증할 수 있도록 하는 비밀번호와 같습니다.

1
ailabsaudit.com에서 계정에 로그인합니다
2
API & Integrations로 이동합니다(오른쪽 상단의 사용자 메뉴 또는 직접 이 링크)
3
"새 키"를 클릭하고, 이름을 지정한 후(예: "내 ChatGPT") 생성을 클릭합니다
4
표시되는 키를 복사합니다(aila_로 시작함).
이 키는 한 번만 표시됩니다. 안전한 곳에 보관하세요.
보안: API 키를 절대 공유하지 마세요. 키가 유출되었다고 생각되면 언제든지 키를 취소하고 새로 생성할 수 있습니다.

2단계 — AI 연결하기

아래에서 AI 어시스턴트를 선택하여 맞춤 안내를 확인하세요:

Claude
ChatGPT
Gemini
Cursor / Windsurf
기타 MCP 클라이언트

Claude Desktop (application)

Claude는 MCP를 기본적으로 지원합니다. 두 가지 방법이 가능합니다:

권장 방법: 인터페이스를 통해

1
컴퓨터에서 Claude Desktop을 엽니다
2
Settings(설정)으로 이동한 다음 Connectors로 이동합니다
3
"Add connector"를 클릭하고 URL을 입력합니다:
https://mcp.ailabsaudit.com/mcp
4
Claude가 인증 페이지를 엽니다 — API 키를 붙여넣고(aila_로 시작하는 키) 확인합니다
완료되었습니다! 이제 Claude가 AILabsAudit 데이터에 액세스할 수 있습니다. 다음과 같이 요청해 보세요: "내 고객 목록을 보여줘" 또는 "최신 감사를 보여줘".

대체 방법: 구성 파일

수동으로 구성하려면 Claude 구성 파일을 편집하세요:

파일 위치:
Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

다음 구성을 추가합니다:

claude_desktop_config.json
{
  "mcpServers": {
    "ailabsaudit": {
      "command": "npx",
      "args": [
        "-y",
        "tut-remote",
        "https://mcp.ailabsaudit.com/mcp"
      ]
    }
  }
}

Claude Desktop을 재시작합니다. 처음 사용할 때 API 키를 입력하는 페이지가 열립니다.

필수 조건: 파일 방법은 컴퓨터에 Node.js가 설치되어 있어야 합니다 (npx 명령어용). 인터페이스를 통한 방법(Connectors)은 추가 설치가 필요하지 않습니다.

ChatGPT (OpenAI)

ChatGPT는 개발자 모드의 "Apps" 기능을 통해 MCP 서버를 지원합니다.

1
ChatGPT를 엽니다(데스크톱 애플리케이션 또는 chatgpt.com)
2
Settings(설정)으로 이동한 다음 Apps로 이동합니다
3
"Advanced"를 활성화한 다음 "Developer Mode"를 활성화합니다
4
"Create app"을 클릭합니다
5
MCP 서버 URL을 입력합니다:
https://mcp.ailabsaudit.com/mcp
인증 방법으로 OAuth를 선택한 다음 Create를 클릭합니다
6
첫 대화 시 ChatGPT가 연결 승인을 요청합니다. 표시되는 양식에 API 키(aila_...)를 입력하고 확인합니다.
완료되었습니다! 이제 ChatGPT에게 다음과 같이 요청할 수 있습니다: "AILabsAudit을 사용해서 내 고객 목록을 보여줘" 또는 "최신 감사의 점수를 보여줘".
필수 조건: ChatGPT Plus, Team 또는 Enterprise 구독이 필요합니다. Developer Mode는 베타 기능입니다.

Google Gemini

Gemini는 명령줄 도구인 Gemini CLI를 통해 MCP를 지원합니다.

참고: Gemini 웹 인터페이스(gemini.google.com)는 아직 사용자 정의 MCP 서버를 지원하지 않습니다. AILabsAudit을 연결하려면 Gemini CLI를 사용하세요.

Gemini CLI 설치

Gemini CLI는 npm을 통해 설치됩니다(Node.js 18+ 필요):

Terminal
npm install -g @anthropic-ai/gemini-cli
참고: Claude Code와 달리 Gemini CLI는 Google의 공식 독립 실행형 CLI가 없습니다. @anthropic-ai/gemini-cli 패키지는 커뮤니티 래퍼입니다. 원하시면 이 패키지를 설치하지 않고 모든 Gemini 호환 클라이언트(예: Google AI Studio)에서 MCP 서버 URL을 직접 사용할 수 있습니다.

MCP 서버 추가하기

빠른 방법(단일 명령어):

Terminal
gemini mcp add --transport http ailabsaudit https://mcp.ailabsaudit.com/mcp

파일 방식: ~/.gemini/settings.json을 편집하십시오:

~/.gemini/settings.json
{
  "mcpServers": {
    "ailabsaudit": {
      "url": "https://mcp.ailabsaudit.com/mcp"
    }
  }
}

첫 실행 시 Gemini CLI는 서버에 인증이 필요함을 자동으로 감지하고 API 키 입력을 안내합니다.

Cursor / Windsurf (코드 에디터)

이러한 스마트 코드 에디터는 JSON 파일을 통해 MCP를 기본적으로 지원합니다.

Cursor

프로젝트 루트에 .cursor/mcp.json 파일을 생성하거나 편집하십시오(또는 모든 프로젝트에 적용하려면 ~/.cursor/mcp.json):

.cursor/mcp.json
{
  "mcpServers": {
    "ailabsaudit": {
      "url": "https://mcp.ailabsaudit.com/mcp",
      "type": "streamableHttp",
      "headers": {
        "X-Api-Key": "aila_YOUR_KEY_HERE"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json 파일을 편집하십시오:

mcp_config.json
{
  "mcpServers": {
    "ailabsaudit": {
      "serverUrl": "https://mcp.ailabsaudit.com/mcp",
      "headers": {
        "X-Api-Key": "aila_YOUR_KEY_HERE"
      }
    }
  }
}

파일 저장 후 에디터를 재시작하십시오.

aila_YOUR_KEY_HERE를 1단계에서 생성한 API 키로 교체하십시오.

기타 MCP 클라이언트

MCP 프로토콜과 호환되는 모든 소프트웨어는 AILabsAudit에 연결할 수 있습니다. 다음은 연결 정보입니다:

MCP 서버 URL
https://mcp.ailabsaudit.com/mcp
Transport
Streamable HTTP (권장) 또는 SSE
인증
OAuth 2.1 (자동) 또는 header X-Api-Key: aila_YOUR_KEY

일반 JSON 구성

대부분의 MCP 클라이언트는 유사한 JSON 형식을 사용합니다:

일반 구성
{
  "mcpServers": {
    "ailabsaudit": {
      "url": "https://mcp.ailabsaudit.com/mcp",
      "headers": {
        "X-Api-Key": "aila_YOUR_KEY_HERE"
      }
    }
  }
}

npx를 통한 방식 (범용 브리지)

클라이언트가 로컬 서버만 지원하는 경우 mcp-remote 브리지를 사용할 수 있습니다:

tut-remote를 사용한 구성
{
  "mcpServers": {
    "ailabsaudit": {
      "command": "npx",
      "args": [
        "-y",
        "tut-remote",
        "https://mcp.ailabsaudit.com/mcp"
      ]
    }
  }
}
mcp-remote 브리지는 귀하의 컴퓨터에 Node.js가 설치되어 있어야 합니다. 브라우저를 열어 OAuth 인증을 자동으로 처리합니다.

무엇을 할 수 있습니까?

연결되면 AI Labs Audit에서 일반적으로 수행하는 모든 작업을 자연어로 AI에게 요청할 수 있습니다. 다음은 몇 가지 예시입니다:

고객 관리

  • "내 모든 고객을 나열해줘"
  • "Dupont 고객의 세부 정보를 보여줘"
  • "외식업 분야의 고객은 누구입니까?"
  • "고객 X의 완전한 360도 뷰를 제공해줘"
  • "파리에 위치한 외식업 분야의 새 고객 'Restaurant Dupont'를 생성해줘"

감사 및 점수

  • "고객 Y의 최근 감사 결과를 보여줘"
  • "이 고객에 대한 ChatGPT와 Claude의 점수를 비교해줘"
  • "지난 3개월 동안 내 고객의 가시성 추세는 어떻습니까?"
  • "내 고객들에게 가장 좋은 점수를 제공하는 AI 모델은 무엇입니까?"
  • "고객 Y에 대한 전체 GEO 감사를 즉시 시작해줘"

분석 시나리오 관리

  • "Dupont 고객을 위해 온라인 레스토랑 예약에 대한 경쟁 시나리오 10개를 추가해줘"
  • "고객 X의 발견 시나리오를 비활성화해줘"
  • "고객 Y의 비교 시나리오 가중치를 8로 설정해줘"
  • "시나리오의 전체 분류 체계를 보여줘"

결합된 워크플로우 (생성 + 시나리오 + 감사를 한 문장으로)

"새 고객 'Bistro Dupont' (외식업 분야, 파리)를 생성하고, 온라인 예약에 대한 경쟁 시나리오 10개를 추가한 다음 즉시 전체 감사를 시작해줘."

귀하의 AI는 create_clientadd_prompts_bulklaunch_audit를 한 번에 연결합니다 — 복사-붙여넣기나 UI 탐색이 필요 없습니다.

보고서 및 내보내기

  • "고객 Z의 모든 감사 데이터를 내보내줘"
  • "최근 생성된 PDF 보고서를 보여줘"
  • "감사당 평균 비용은 얼마입니까?"

크레딧 및 구독

  • "남은 크레딧이 얼마입니까?"
  • "내 사용 내역을 보여줘"
  • "사용 가능한 크레딧 팩은 무엇입니까?"
팁: 도구의 정확한 이름을 알 필요가 없습니다. AI에게 자연스럽게 말하면 자동으로 사용할 적절한 도구를 찾습니다.

사용 가능한 모든 도구

AI Labs Audit MCP 서버는 20개 카테고리로 그룹화된 235개의 공개 도구를 제공합니다. 각 도구는 '읽기' (조회) 또는 '수정' (쓰기)으로 표시되며, 액세스 수준은 최종 고객 키 (단일 고객으로 범위 제한)로 사용 가능한지 또는 에이전트/에이전시 키 전용인지를 나타냅니다.

놓치지 마세요
  • AI를 통한 분석 시나리오 관리 — AI에서 직접 시나리오를 생성(create_custom_prompt, add_prompts_bulk)하고, 수정(update_custom_prompt)하고, 활성화/비활성화(toggle_client_prompt)하고, 가중치를 최적화(set_client_prompt_weight)합니다. 전체 분류 체계는 get_prompt_taxonomy로 제공됩니다.
  • 감사 및 일정 관리 — 감사를 시작(launch_audit)하고, 진행 상황을 추적(get_audit_progress)하고, 반복 감사를 예약(create_scheduled_audit)하고, 두 감사를 비교(compare_audits)합니다.
  • 고급 GEO 모듈 — SSR 진단(get_ssr_crawlability), 엔티티 상태(get_entity_health), 인용 준비도(get_citation_readiness), GEO 26포인트 체크리스트(get_geo_checklist) 및 환각 URL(get_hallucinated_urls).

고객 26

도구 설명 모드 접근
export_client_data고객의 모든 데이터를 JSON 형식으로 내보냅니다 (GDPR 데이터 이동권).읽기최종 고객
get_client_brief_for_prompts관련성 있는 프롬프트 생성을 위해 고객 컨텍스트를 COMPACT 형식으로 반환합니다.읽기에이전트
get_client_competitors고객에 대해 구성된 경쟁사 목록을 조회합니다.읽기최종 고객
get_client_contacts고객의 연락처 목록을 조회합니다.읽기최종 고객
get_client_detail고객의 전체 상세 정보를 조회합니다 (모든 필드).읽기최종 고객
get_client_portal_access읽기 전용 고객 포털 접근 링크를 조회합니다.읽기에이전트
get_client_portfolio_overview포트폴리오 요약 대시보드: 총 고객 수, 상태/업종별 분류, 최근 활동, 주의가 필요한 고객.읽기에이전트
get_client_preferences고객 환경설정을 조회합니다 (auto_report_default 등).읽기최종 고객
get_client_summary고객의 간략한 요약: 주요 정보, 최근 감사, 총 감사 수, 활성 실행 계획.읽기최종 고객
get_clients필터링 및 페이지네이션을 통해 고객 목록을 조회합니다. 파트너는 자신의 고객만 조회할 수 있습니다.읽기에이전트
get_clients_by_country국가별로 고객을 집계하여 개수와 함께 조회합니다.읽기에이전트
get_clients_by_sector업종별로 고객을 집계하여 개수와 함께 조회합니다. 포트폴리오 분석에 유용합니다.읽기에이전트
get_competitor_detail경쟁사의 전체 상세 정보를 조회합니다.읽기최종 고객
get_contact_detail특정 연락처의 상세 정보를 조회합니다.읽기최종 고객
get_geo_checklist고객에 대한 26개 항목의 전체 GEO 체크리스트를 조회합니다.읽기최종 고객
get_geo_checklist_summaryGEO 체크리스트 요약: 확인된 항목, 전체 점수, 우선순위 권장사항.읽기최종 고객
get_whitelabel_config에이전트의 화이트라벨 구성(로고, 색상, 이름)을 조회합니다.읽기에이전트
list_sectors사용 가능한 업종 목록을 조회하며, 선택적으로 하위 업종도 포함합니다.읽기에이전트
search_clients고객 간 전체 텍스트 검색을 수행합니다 (기업명, 설명, 업종, 키워드).읽기에이전트
add_competitorGEO 경쟁 분석을 위해 고객에 경쟁사를 추가합니다.수정에이전트
create_client새로운 고객을 생성합니다. 업종은 자동으로 표준 값으로 정규화됩니다.수정에이전트
create_client_portal_access고유 토큰을 사용하여 읽기 전용 고객 포털 접근 권한을 생성합니다.수정에이전트
remove_competitor고객에서 경쟁사를 제거합니다.수정에이전트
revoke_client_portal_access고객 포털 접근 권한을 취소합니다.수정에이전트
update_client_detailsAI의 관련성 있는 프롬프트 생성을 위한 핵심 필드로 기존 고객의 상세 정보를 보강합니다.수정에이전트
update_whitelabel_config에이전트의 화이트라벨 구성을 수정합니다.수정에이전트

감사 및 점수 23

도구 설명 모드 접근
compare_audits두 감사를 나란히 비교합니다: 점수 변화, 지표 차이, 모델별 비교.읽기최종 고객
get_audit_cost감사의 비용 상세 내역을 조회합니다 (크레딧, 요청 수, 사용된 모델).읽기최종 고객
get_audit_detail모든 전체 점수를 포함한 감사의 전체 상세 정보를 조회합니다.읽기최종 고객
get_audit_model_performance특정 감사에 대한 여러 AI 모델의 성능을 비교합니다.읽기최종 고객
get_audit_prompt_analysis감사에 대한 프롬프트별 결과를 분석합니다(프롬프트별 최고/최저 점수).읽기최종 고객
get_audit_results감사의 AI 결과를 모델별로 제공합니다.읽기최종 고객
get_audit_scores감사의 상세 점수를 제공합니다(별점, 10점 만점 점수, 순위, 감정, 모델/프롬프트별 언급).읽기최종 고객
get_audit_trend클라이언트의 감사별 주요 메트릭 변화 추이를 제공합니다.읽기최종 고객
get_audit_website_analysis감사 중 수집된 웹사이트 분석 데이터를 제공합니다.읽기최종 고객
get_audits필터링 및 페이지네이션을 통해 감사 목록을 제공합니다.읽기최종 고객
get_best_performing_models클라이언트에 대한 평균 점수, 언급률 및 감정별로 AI 모델을 순위화합니다.읽기최종 고객
get_client_audit_history클라이언트의 전체 감사 이력을 제공합니다: 날짜, 점수, 주요 메트릭, 비용.읽기최종 고객
get_consumption_logs상세 API 소비 로그를 제공합니다(토큰, 비용, 응답 시간).읽기에이전트
get_consumption_stats집계된 소비 통계를 제공합니다: 모델/클라이언트/기간별 토큰, 비용, 평균 시간.읽기에이전트
get_geo_metrics감사에 대한 숨겨진 지리적/시장 메트릭을 제공합니다.읽기최종 고객
get_hallucinated_urls감사 중 탐지된 환각 URL 목록을 클라이언트 및 모델별 필터링과 함께 제공합니다.읽기최종 고객
get_hallucinated_urls_by_model클라이언트에 대해 AI 모델별로 그룹화된 환각 URL을 분석합니다.읽기에이전트
get_mention_analysisAI 응답에서 클라이언트 언급을 분석합니다: 유형, 빈도, 감정.읽기최종 고객
get_native_vs_web_scores주어진 감사에 대해 모델별 네이티브 대 웹 점수를 비교합니다.읽기최종 고객
get_scheduled_audits클라이언트 및 상태별 필터링과 함께 예약된 감사(일일, 주간, 월간) 목록을 제공합니다.읽기에이전트
create_scheduled_audit예약 감사를 생성합니다. frequency: 'daily', 'weekly', 'monthly'.수정에이전트
delete_scheduled_audit예약 감사를 삭제합니다.수정에이전트
update_scheduled_audit예약 감사를 수정합니다(빈도, 활성화/비활성화).수정에이전트

감사 시작 3

도구 설명 모드 접근
estimate_audit_cost감사 실행 전 클라이언트에 대한 크레딧 비용을 추정합니다. 활성 프롬프트 수 및 활성화된 모델 수를 기반으로 합니다.읽기에이전트
get_audit_progress진행 중이거나 최근 완료된 감사의 진행 상황을 조회합니다. 상태, 진행률 및 카운터를 반환합니다.읽기에이전트
launch_audit클라이언트에 대한 AI 가시성 감사를 실행합니다. audit_id 및 예상 비용을 반환합니다. partner 또는 admin 역할이 필요합니다.수정에이전트

실행 계획 5

도구 설명 모드 접근
get_action_library카테고리, 우선순위, 난이도 및 영향도가 포함된 권장 액션 라이브러리를 제공합니다.읽기최종 고객
get_action_library_item라이브러리 액션의 상세 정보를 제공합니다(이중 언어 설명, 우선순위, 영향도).읽기최종 고객
get_action_plan_detailfindings JSON 및 메트릭 변화를 포함한 액션 플랜의 전체 상세 정보를 제공합니다.읽기최종 고객
get_action_plan_progress액션 플랜 진행 상황 요약을 제공합니다: 전체, 상태별, 완료율.읽기최종 고객
get_action_plans상태 및 진행 상황과 함께 클라이언트의 액션 플랜 목록을 제공합니다.읽기최종 고객

PDF 보고서 6

도구 설명 모드 접근
download_reportPDF 보고서를 다운로드합니다. 작은 파일의 경우 base64로 인코딩된 콘텐츠를 반환합니다.읽기최종 고객
get_pdf_config클라이언트의 현재 PDF 구성을 제공합니다(템플릿, 브랜딩, 섹션, 수신자).읽기에이전트
get_pdf_premium_prompts클라이언트 또는 전역으로 구성된 프리미엄 PDF 프롬프트 목록을 제공합니다.읽기에이전트
get_report_detailPDF 생성의 전체 세부 정보를 반환합니다(실패 시 오류 포함).읽기최종 고객
get_report_generation_statsPDF 생성 통계: 총 건수, 평균 소요 시간, 성공/실패율, 소비된 크레딧.읽기에이전트
list_reports생성된 PDF 보고서 목록을 상태, 소요 시간 및 소비된 크레딧과 함께 반환합니다.읽기최종 고객

크레딧 8

도구 설명 모드 액세스
get_credit_balance에이전트의 현재 크레딧 잔액을 반환합니다. Agency-aware: 해당되는 경우 에이전시 풀 크레딧을 반환합니다.읽기에이전트
get_credit_forecast최근 소비량을 기반으로 크레딧 소진 예측을 제공합니다.읽기에이전트
get_credit_history필터링 기능이 포함된 크레딧 이동 내역을 반환합니다.읽기에이전트
get_credit_packs구매 가능한 크레딧 팩 목록을 반환합니다.읽기에이전트
get_credit_purchases크레딧 구매 내역(금액, 결제 수단, 상태)을 반환합니다.읽기에이전트
get_credit_transactions클라이언트와 관련된 크레딧 트랜잭션을 반환합니다.읽기에이전트
get_credit_usage_summary크레딧 소비 요약: 총 소비량, 기간/감사별 소비량, 평균 비용, burn rate, 예상 잔여 일수.읽기에이전트
get_credits사용자의 현재 크레딧 잔액을 반환합니다. Agency-aware: 해당되는 경우 에이전시 풀 크레딧을 반환합니다.읽기에이전트

구독 5

도구 설명 모드 액세스
get_subscription현재 구독의 세부 정보(플랜, 잔여/사용 크레딧, 갱신 날짜, 상태)를 반환합니다.읽기에이전트
get_subscription_history구독 변경 내역(업그레이드, 다운그레이드, 취소)을 반환합니다.읽기에이전트
get_subscription_notifications구독 관련 알림(갱신 알림, 결제 확인)을 반환합니다.읽기에이전트
get_subscription_plans모든 구독 플랜을 요금, 기능 및 크레딧과 함께 나열합니다.읽기에이전트
get_subscription_transactions구독 결제의 Stripe 트랜잭션을 반환합니다.읽기에이전트

시나리오 13

도구 설명 모드 액세스
get_client_base_prompts클라이언트에 대해 활성화/비활성화된 기본 프롬프트를 가중치와 함께 반환합니다.읽기최종 고객
get_client_prompt_config클라이언트의 전체 프롬프트 구성: 기본 + 커스텀 + 가중치.읽기최종 고객
get_custom_prompts클라이언트의 커스텀 프롬프트 목록을 반환합니다.읽기에이전트
get_prompt_detail프롬프트(시스템 또는 커스텀)의 전체 세부 정보를 반환합니다.읽기에이전트
get_prompt_taxonomy프롬프트 분류 체계의 전체 구조(4개 pillar / 8개 intent / 30개 하위 카테고리)를 현지화된 설명과 함께 반환합니다.읽기에이전트
get_prompts시스템 프롬프트(감사 프롬프트 라이브러리) 목록을 반환합니다.읽기에이전트
get_user_base_prompts사용자 수준에서 활성화/비활성화된 기본 프롬프트를 반환합니다.읽기에이전트
add_prompts_bulk분류 체계 검증 및 중복 제거를 통해 한 번의 호출로 최대 30개의 프롬프트를 추가합니다.수정에이전트
create_custom_prompt전체 분류 체계 검증을 통해 커스텀 프롬프트를 생성합니다.수정에이전트
delete_custom_prompt클라이언트의 프롬프트를 삭제합니다. 커스텀 프롬프트 및 기본 프롬프트 참조를 지원합니다(상속 비활성화).수정에이전트
set_client_prompt_weight클라이언트에 대한 프롬프트의 가중치(0-10)를 변경합니다. custom_prompts 및 client_base_prompts에서 작동합니다. 가중치는 스코어링에 영향을 미칩니다.수정에이전트
toggle_client_prompt클라이언트에 대한 프롬프트(커스텀 또는 기본)를 활성화/비활성화합니다. 웹 UI의 토글과 동일합니다.수정에이전트
update_custom_prompt클라이언트의 프롬프트를 업데이트합니다. 기본 프롬프트인 경우 자동으로 커스텀 프롬프트로 변환됩니다(웹 UI와 동일). 제공된 필드(None이 아닌 것)만 수정됩니다.수정에이전트

AI 구성 7

도구 설명 모드 액세스
compare_model_pricing모든 활성 모델의 가격(1K 토큰당 입력/출력 비용)을 비용 순으로 정렬하여 비교합니다.읽기에이전트
get_client_ai_config클라이언트의 AI 구성 정보입니다(활성화된 모델, 표시 순서, 커스텀 설정).읽기최종 고객
get_client_model_stats클라이언트의 모델별 통계입니다: 실행된 감사 수, 평균 점수, 최근 감사, 누적 비용.읽기최종 고객
get_model_detailAI 모델의 전체 상세 정보입니다(pricing, max tokens, provider).읽기최종 고객
get_model_pricingAI 모델의 현재 pricing입니다(실시간 캐시).읽기에이전트
get_models사용 가능한 모든 AI 모델을 pricing 및 상태와 함께 나열합니다.읽기최종 고객
get_openrouter_config클라이언트의 LLM 구성입니다(활성화된 모델, 설정). API 키는 노출하지 않습니다.읽기에이전트

GEO 모듈 5

도구 설명 모드 액세스
get_citation_readinessGEO 모듈 4 — Citation Readiness Score(Princeton GEO KDD 2024 연구). 콘텐츠의 인용 가능성을 평가합니다: 외부 출처, 통계, 전문가, 단락 구조, H2/H3 질문, 직접 답변.읽기에이전트
get_entity_healthGEO 모듈 2 — Entity Health Check(Wikidata + Schema.org). Wikidata 존재 여부, 속성, Schema.org Organization 마크업, 검증된 sameAs 링크를 반환합니다.읽기에이전트
get_mention_citationGEO 모듈 3 — Mention vs Citation 추적. 단순 언급, 출처 링크가 있는 인용, 명시적 추천을 구분합니다. 모델별 M/C 비율을 반환합니다.읽기에이전트
get_ssr_crawlabilityGEO 모듈 1 — SSR / AI 크롤 가능성 진단. 종합 점수, SSR 감지, robots.txt 분석, AI user-agent별 WAF 테스트, llms.txt/llms-full.txt 존재 여부를 반환합니다.읽기에이전트
get_sts_detectionGEO 모듈 5 — STS Detection(Search Text Spoofing, 실험적). 경쟁사의 조작 기법을 감지합니다: 숨겨진 텍스트, token stuffing, 과도한 meta tags, CSS 마이크로 텍스트.읽기에이전트

AI 트래킹 8

도구 설명 모드 접근
get_tracking_alerts클라이언트의 AI 추적 알림입니다(사라진 봇, 트래픽 급증, 오래된 설치 등). 심각도(critical > warning > info) 및 날짜순으로 정렬됩니다.읽기최종 고객
get_tracking_correlation클라이언트의 AI 크롤과 AI 인용/referral 간 상관관계입니다. 크롤된 URL, 감사에서 인용된 URL, AI가 참조한 URL을 비교합니다.읽기최종 고객
get_tracking_pagesAI가 가장 많이 크롤하고 참조한 페이지입니다. URL, 크롤 수, referral 수, 크롤한 봇, referral 출처, 상태(high_visibility, crawled_not_cited, referral_without_crawl)를 반환합니다.읽기최종 고객
get_tracking_portfolio추적 포트폴리오 뷰입니다: 추적이 설치된 클라이언트 목록, 각 설치의 상태, 기간별 집계 통계(크롤, referral).읽기에이전트
get_tracking_referral_trends포트폴리오의 AI referral 트렌드입니다: 상위 출처, 주간 추이, referral 볼륨 기준 상위 클라이언트.읽기에이전트
get_tracking_statsAI 추적 집계 통계입니다: 총 크롤, 총 referral, 고유 봇, 고유 출처, 이전 기간 대비 트렌드, 봇/referrer별 분류, 일별 시계열.읽기최종 고객
get_tracking_status클라이언트의 추적 설치 상태입니다: 플러그인 설치 여부, 버전, 도메인, 상태(healthy/warning/stale/pending/no_data), 이벤트 카운터.읽기최종 고객
get_tracking_top_bots포트폴리오 사이트를 크롤하는 상위 AI 봇입니다. 봇 이름, provider, 카테고리, 총 크롤 수, 영향받은 클라이언트 수를 반환합니다.읽기에이전트

랜딩 페이지 7

도구 설명 모드 접근
get_my_referral_stats현재 사용자의 추천 통계입니다: 코드, 총 추천인, 전환된 수, 획득한 크레딧.읽기최종 고객
get_platform_changelog플랫폼의 최신 업데이트 내역(changelog)을 나열합니다.읽기최종 고객
get_showcase_content지정된 언어로 작성된 클라이언트 쇼케이스 페이지의 생성 콘텐츠입니다.읽기에이전트
get_showcase_status클라이언트 쇼케이스 페이지의 상태입니다: 활성화 여부, slug, 공개 URL.읽기에이전트
list_showcase_clients쇼케이스 페이지가 활성화된 모든 클라이언트를 나열합니다.읽기에이전트
regenerate_showcaseAI로 쇼케이스 페이지 콘텐츠를 재생성합니다(기사, FAQ, meta).수정에이전트
toggle_showcase클라이언트의 쇼케이스 페이지를 활성화 또는 비활성화합니다. 필요시 slug를 생성합니다.수정에이전트

데이터 품질 알림 3

도구 설명 모드 접근
get_audit_alerts감사의 데이터 품질 알림을 조회합니다. dismiss되지 않은 알림을 심각도(error > warning > info)순으로 반환합니다.읽기최종 고객
get_client_alerts클라이언트의 최근 완료된 감사의 품질 알림을 조회합니다. dismiss되지 않은 알림을 심각도순으로 최대 50개 반환합니다.읽기최종 고객
dismiss_alert데이터 품질 알림을 dismiss(숨김) 처리합니다. 알림을 timestamp와 함께 dismissed로 표시합니다.수정최종 고객

설문조사 4

도구 설명 모드 접근
compare_questionnaire_responses동일 클라이언트의 두 감사 간 설문 응답을 비교합니다.읽기최종 고객
get_custom_questionnaires고객의 맞춤형 설문지를 나열합니다.읽기최종 고객
get_questionnaire_completion_status설문지의 어느 섹션이 완료되었고 어느 섹션이 대기 중인지 확인합니다.읽기최종 고객
get_questionnaire_responses고객의 설문지 응답 (선택적으로 특정 감사에 대한)을 조회합니다.읽기최종 고객

에이전시 9

도구 설명 모드 접근
get_agency_agents역할, 크레딧 및 고객 수와 함께 에이전시의 모든 에이전트를 나열합니다.읽기에이전시
get_agency_clients에이전시의 모든 에이전트에 속한 모든 고객을 나열합니다.읽기에이전시
get_agency_credit_pool에이전트별 할당과 함께 에이전시의 크레딧 풀 세부 정보를 조회합니다.읽기에이전시
get_agency_dashboard에이전시 개요: 에이전트, 고객, 크레딧 풀, 최근 활동을 표시합니다.읽기에이전시
get_agency_whitelabel에이전시의 white-label 설정 (로고, 색상, 상호명, 연락처 정보, 웹사이트)을 조회합니다. agencies 테이블의 모든 wl_* 컬럼입니다.읽기에이전시
allocate_agency_credits풀에서 특정 에이전트에게 크레딧을 할당합니다.수정에이전시
invite_agency_agent이메일을 통해 새로운 에이전트를 에이전시에 초대합니다.수정에이전시
remove_agency_agent에이전시에서 에이전트를 제거합니다 (멤버십을 비활성화합니다).수정에이전시
transfer_agency_client에이전시 내에서 한 에이전트에서 다른 에이전트로 고객을 이전합니다.수정에이전시

Analytics & dashboards 7

도구 설명 모드 접근
export_client_full_report_data고객의 모든 감사 데이터를 구조화된 JSON으로 완전히 내보냅니다.읽기최종 고객
get_client_360단일 호출로 고객의 완전한 360° 뷰를 조회합니다: 프로필, 연락처, 경쟁사, 완전한 감사 (최신 + 이전 + 이력), 모델 분석, 진행 요약, 웹사이트 분석, 강화된 실행 계획, GEO 모듈 (SSR, entity, mention, citation, STS), 데이터 알림. 재무 데이터 (크레딧, 구독, PDF 설정)는 에이전트 및 관리자에게만 표시됩니다.읽기최종 고객
get_partner_dashboard파트너 대시보드: 고객 포트폴리오, 집계된 점수, 감사, 소비된 크레딧, 상위/하위 고객을 표시합니다.읽기에이전트
get_score_distribution감사 점수의 통계적 분포: 히스토그램, 백분위수, 평균, 중앙값을 조회합니다.읽기에이전트
get_sector_benchmarks업종별 AI 벤치마크: 업종 및 AI 모델별 평균/중앙값/백분위수 메트릭입니다. 고객을 해당 업종과 비교하는 데 유용합니다.읽기에이전트
get_visibility_leaderboard가시성 점수 (최근 감사)별 고객 순위를 조회합니다. 파트너에게 유용합니다.읽기에이전트
search_everything교차 테이블 전역 검색 (고객, 감사, 연락처, 경쟁사, 프롬프트)을 수행합니다. 결과는 범주별로 분류됩니다.읽기에이전트

블로그 & 용어집 5

도구 설명 모드 접근
get_blog_article_detail번역, FAQ 및 평가와 함께 기사의 전체 콘텐츠를 조회합니다.읽기최종 고객
get_blog_article_faqs특정 언어로 된 블로그 기사의 FAQ를 조회합니다.읽기최종 고객
get_blog_articles필터링과 함께 블로그 기사를 나열합니다.읽기최종 고객
get_glossary_term_detail번역 및 관련 용어와 함께 완전한 용어집 용어를 조회합니다.읽기최종 고객
get_glossary_terms필터링과 함께 용어집 용어를 나열합니다.읽기최종 고객

사용자 2

도구 설명 모드 접근
get_my_profile로그인한 사용자의 프로필 (안전한 필드의 하위 집합)을 조회합니다.읽기에이전트
get_partner_clients_summary로그인한 파트너의 고객 요약: 최근 감사, 가시성 점수, 실행 계획을 조회합니다.읽기에이전트

시스템 & 보안 1

도구 설명 모드 접근
get_user_activity_log본인의 활동 로그를 조회합니다. 각 사용자는 플랫폼에서의 작업 이력을 조회할 수 있습니다.읽기에이전트

MCP 키 관리 5

도구 설명 모드 접근
get_my_access_requests사용자의 도구 액세스 요청을 나열합니다.읽기최종 고객
get_my_mcp_usage로그인한 사용자의 MCP 사용 통계를 조회합니다.읽기최종 고객
get_my_permissions사용된 API 키에서 허용된 도구를 나열합니다.읽기최종 고객
list_available_tools역할에 따라 접근 가능한 MCP 도구 목록을 표시합니다. 각 역할은 권한이 부여된 도구만 확인할 수 있습니다.읽기최종 고객
request_tool_access도구 접근 권한 요청을 제출합니다. 관리자 승인 대기 중인 요청을 생성합니다.수정최종 고객

고객에게 MCP 접근 권한 부여

Agency+ 플랜을 이용하는 에이전시로서, 귀하는 최종 고객이 선호하는 AI 어시스턴트에서 자신의 데이터에만 직접 접근할 수 있도록 하는 고객 범위 키를 생성할 수 있습니다. 이는 고객이 자율적으로 분석 결과를 확인할 수 있도록 하려는 에이전시에 이상적입니다.

작동 방식: 고객 범위 키는 단일 고객에게 연결됩니다. 최종 사용자는 해당 특정 고객의 데이터만 볼 수 있습니다 — 감사, 점수, 실행 계획, 보고서 등. 다른 고객을 보거나 에이전트 수준 데이터에 접근할 수 없습니다.

고객에게 MCP 접근 권한을 부여하는 이유는 무엇입니까?

고객에게 자체 MCP 키를 제공하는 것은 단순한 기술적 기능 이상입니다 — 이는 감사 서비스를 변화시키고 고객과의 관계를 강화하는 전략적 수단입니다. 중요한 이유는 다음과 같습니다:

1. 감사의 인지 가치 증대

감사 보고서를 제공할 때, 가치는 종종 일회성 결과물로 인식됩니다. 고객에게 MCP 키를 제공함으로써, 정적인 보고서를 상호작용적이고 생동감 있는 경험으로 변환합니다. 고객은 AI 어시스턴트에게 다음과 같은 질문을 할 수 있습니다:

  • "현재 가시성 점수는 얼마이며 어떻게 변화했습니까?"
  • "어떤 AI 모델이 나를 가장 많이 언급합니까?"
  • "경쟁사가 나보다 더 높은 순위를 차지한 시나리오를 보여주세요"
  • "개선을 위해 우선순위를 두어야 할 조치는 무엇입니까?"

이는 감사를 한 번 읽고 보관하는 PDF가 아닌 영구적인 리소스로 만듭니다. 고객은 계속해서 데이터와 상호작용하며, 이는 귀하의 작업 가치를 강화합니다.

2. 고객 유지율 및 반복 수익 증대

고객이 MCP를 적극적으로 사용하여 점수를 확인하고, 감사를 비교하며, 진행 상황을 추적하면, 고객은 프로세스에 참여하게 됩니다. 참여하는 고객은 다음과 같은 가능성이 훨씬 높습니다:

  • 후속 감사 주문 — 진화를 보고 개선 사항을 추적하고 싶어합니다
  • 더 오래 구독 유지 — 데이터가 정기적인 모니터링의 일부가 됩니다
  • 서비스 추천 — 자신의 동료에게 가치를 보여줄 수 있습니다

3. 지원 부담 감소

MCP 접근 권한이 없으면, 고객이 데이터를 원할 때마다 이메일을 보내거나 통화를 예약해야 합니다. "지난달 Perplexity에서 내 점수가 얼마였습니까?" "최근 두 감사 간의 비교를 보내주실 수 있습니까?"

MCP를 사용하면 고객은 24시간 연중무휴로 자율적으로 즉각적인 답변을 얻습니다. AI 어시스턴트에게 물어보기만 하면 됩니다. 이는 전략 및 신규 고객 확보와 같은 더 높은 가치의 작업을 위한 시간을 확보합니다.

4. 투명성을 통한 신뢰 구축

고객에게 원시 감사 데이터에 대한 직접 접근 권한을 부여하는 것은 귀하의 작업에 대한 신뢰를 보여줍니다. "블랙박스"가 없습니다 — 고객은 결과를 탐색하고, 각 모델의 응답을 확인하며, 점수를 직접 검증할 수 있습니다. 이러한 투명성은 신뢰를 구축하고 귀하를 신뢰할 수 있는 전문가로 포지셔닝합니다.

5. 경쟁사와 서비스 차별화

대부분의 에이전시는 PDF를 제공하고 다음으로 넘어갑니다. 귀하는 PDF 플러스 고객이 언제든지 데이터를 탐색할 수 있는 AI 기반 인터페이스를 제공합니다. 이는 더 높은 가격을 정당화하고 기본 감사 에이전트와 차별화되는 프리미엄 차별화 요소입니다.

구체적인 예: 고객이 마케팅 팀과 회의 중이라고 상상해보십시오. PDF가 첨부된 마지막 이메일을 찾는 대신, Claude 또는 ChatGPT를 열고 다음과 같이 질문합니다: "지난 3개월 동안 모델별 점수와 함께 AI 가시성 진화를 보여주세요." 몇 초 안에 답변을 얻습니다 — 그리고 누가 이 능력을 제공했는지 기억합니다: 귀하입니다.

1단계 — 고객 키 생성

1

API & Integrations로 이동하여 "새 키"를 클릭합니다.

2

접근 유형에서 "최종 고객 (단일 고객, 읽기 전용)"을 선택합니다.

3

드롭다운 목록에서 고객을 선택합니다.

4

"키 생성"을 클릭합니다. 키가 생성되며 나중에 다시 표시할 수 있습니다 (에이전트 키와 달리, 고객 키는 저장되며 버튼을 통해 언제든지 조회할 수 있습니다).

2단계 — 고객에게 구성 정보 전송

고객이 AI 어시스턴트를 구성할 수 있도록 다음 정보를 공유하십시오:

공유할 정보:

  • 서버 URL: https://mcp.ailabsaudit.com/mcp
  • API 키: 생성한 키 (aila_로 시작)
  • 전송: streamable-http

고객에게 복사하여 전달할 수 있는 준비된 메시지 템플릿입니다:

안녕하세요,

이제 AI 어시스턴트(Claude, ChatGPT, Gemini 등)에서 직접 AI 가시성 데이터에 접근할 수 있습니다.

접근 구성 방법:

1. AI 도구 설정을 엽니다 (예: Claude Desktop > 설정 > MCP)
2. 다음 정보로 새 MCP 서버를 추가합니다:
   - 서버 URL: https://mcp.ailabsaudit.com/mcp
   - API 키: 여기에_귀하의_키
   - 전송: streamable-http

3. 연결되면 다음과 같이 질문할 수 있습니다:
   - "최근 감사 결과를 보여주세요"
   - "ChatGPT와 Claude에서 내 가시성 점수는 얼마입니까?"
   - "실행 계획을 보여주세요"
   - "최근 두 감사를 비교해주세요"

귀하의 키는 자신의 데이터에 대한 읽기 전용 접근 권한을 제공합니다.
질문이 있으시면 언제든지 연락주십시오!

3단계 — 고객이 할 수 있는 작업

고객 범위 키를 사용하면 최종 고객은 다음을 포함한 47개의 도구에 접근할 수 있습니다:

  • 감사: 결과, 점수, 추세, 모델 비교 보기
  • 실행 계획: 진행 상황 추적, 권장 사항 탐색
  • 보고서: PDF 보고서 목록 및 다운로드
  • 크레딧: 잔액 조회, 이력 보기
  • 프로필: 자신의 프로필 및 활동 보기
중요: 고객 키는 읽기 전용이며 단일 고객으로 범위가 지정됩니다. 다른 고객을 나열하거나, 에이전트 분석에 접근하거나, 관리 작업을 수행할 수 없습니다.

고객 키 관리

  • 키 보기: 키 옆의 를 클릭하여 언제든지 다시 표시합니다
  • 재생성: 를 클릭하여 이전 키를 취소하고 새 키를 생성합니다
  • 취소: 를 클릭하여 키를 영구적으로 비활성화합니다 — 고객은 즉시 접근 권한을 잃습니다
팁: 동일한 고객에 대해 여러 키를 생성할 수 있습니다 (예: 마케팅 팀용 하나와 GEO 팀용 하나). 각 키는 독립적으로 작동합니다.

자주 묻는 질문

내 데이터는 안전합니까?

예. API 키는 귀하 자신의 데이터에만 접근 권한을 부여합니다. 표준 사용자는 자신의 고객과 감사만 볼 수 있습니다. 파트너는 자신의 포트폴리오를 볼 수 있습니다. 관리자만 모든 것에 접근할 수 있습니다. 모든 통신은 HTTPS로 암호화됩니다.

크레딧이 소모됩니까?

아니요. MCP를 통한 접근은 구독에 포함되어 있습니다. 일반적으로 크레딧을 소비하는 작업(감사 실행, PDF 생성)만 MCP를 통해서도 크레딧을 소비합니다.

휴대폰에서 작동합니까?

애플리케이션에 따라 다릅니다. iOS/Android의 Claude는 이미 구성된 MCP 서버를 사용할 수 있습니다. 모바일의 ChatGPT는 아직 MCP 앱을 지원하지 않습니다. Gemini의 경우 CLI를 통해야 합니다(컴퓨터만 해당).

언제든지 키를 취소할 수 있습니까?

예. API & Integrations로 이동하여 해당 키 옆의 삭제 버튼을 클릭하십시오. 접근 권한이 즉시 차단됩니다.

AI가 AILabsAudit 도구를 찾지 못합니다

다음을 확인하십시오:

  • API 키가 유효하며 취소되지 않았습니다
  • 서버 URL이 올바릅니다: https://mcp.ailabsaudit.com/mcp
  • 구성 후 AI 클라이언트가 재시작되었습니다
  • AI가 어떤 도구를 사용할지 알 수 있도록 메시지에서 "AILabsAudit"를 명시적으로 언급합니다

사용 가능한 도구는 몇 개입니까?

MCP 서버는 다음 카테고리로 분류된 235개 이상의 도구를 제공합니다: 고객, 감사, 점수, 보고서, 크레딧, 구독, 시나리오, AI 구성, 뉴스레터, 블로그, 용어집, 사용자, 파트너, 시스템 및 분석.

AI를 연결할 준비가 되셨습니까?

30초 만에 API 키를 생성하고 선호하는 AI 어시스턴트에서 AILabsAudit 사용을 시작하세요.

API 키 생성하기

AI 가시성 감사를 시작할 준비가 되셨습니까?

무료 계정을 생성하고 500 보너스 크레딧을 받으세요.

무료 계정 생성