📊 대시보드

외부 LLM 클라이언트 연결은 streamable HTTP(/mcp)를 기본으로 사용하세요. 구형 클라이언트는 SSE(/sse)로 연결할 수 있습니다.

✅ 외부 사용자 체크리스트

• 사내망/방화벽에서 koreanads.com:443 아웃바운드 허용
• 클라이언트에 MCP 원격 서버 추가 기능이 있는지 확인
• 연결 후 도구 목록에서 search_ad_products, get_product_detail, recommend_for_brief, build_media_mix_from_db 4개 확인

🔎 1차 네트워크 점검

# 연결 확인(코드가 404/405여도 서버 도달이면 정상)
curl -i https://koreanads.com/mcp

# SSE 호환 포트 확인(선택)
curl -i https://koreanads.com/sse

💬 자연어 질문 예시

• "예산 500만원 안에서 여성 타겟 디지털 광고 상품 추천해줘"
• "브랜드 인지도 목적 캠페인에 맞는 상품 3개와 이유를 알려줘"
• "ad-mcp 도구를 사용해서 네이버/카카오 성과형 상품 비교표 만들어줘"

ChatGPT에서 원격 MCP 서버를 추가한 뒤 바로 광고 상품 도구를 호출할 수 있습니다.

1. ChatGPT의 MCP/Connector 추가 화면에서 새 서버를 생성합니다.
2. Server URL에 https://koreanads.com/mcp 를 입력합니다.
3. 저장 후 새 대화에서 도구 호출을 허용하고 테스트 프롬프트를 실행합니다.

참고: MCP 서버 단에서 ChatGPT 응답을 강제할 수는 없습니다. 대신 프롬프트에 “먼저 도구 호출 + product_id/source_file 인용 필수” 규칙을 명시해 준강제하세요.

https://koreanads.com/mcp

ad-mcp의 search_ad_products 도구를 사용해서
"20-34세 여성 대상, 예산 500만원, 앱 설치 목적"에 맞는 상품 5개를 찾아줘.

반드시 build_media_mix_from_db 도구를 먼저 호출해서
브리프 "20대 여성 선크림 신제품 런칭", 월예산 100000000원 기준으로
product_id/price_text/source_file가 포함된 DB 근거형 미디어 믹스를 제시해줘.

Gemini CLI는 설정 파일에 MCP 서버를 등록하면 외부 사용자가 동일하게 접근할 수 있습니다.

{
  "mcpServers": {
    "ad-mcp": {
      "httpUrl": "https://koreanads.com/mcp"
    }
  }
}

설정 저장 후 Gemini CLI를 재시작한 다음, 도구 사용 허용 상태에서 프롬프트를 실행하세요.

Claude Desktop은 원격 MCP(HTTP) 설정을 권장합니다. 구형 환경은 SSE 브릿지를 사용하세요.

{
  "mcpServers": {
    "ad-mcp-public": {
      "type": "http",
      "url": "https://koreanads.com/mcp"
    }
  }
}

{
  "mcpServers": {
    "ad-mcp-sse": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/client-sse", "https://koreanads.com/sse"]
    }
  }
}

Cursor/Windsurf는 UI로 추가하거나 설정 파일에 직접 MCP 서버를 등록할 수 있습니다.

{
  "mcpServers": {
    "ad-mcp": {
      "type": "http",
      "url": "https://koreanads.com/mcp"
    }
  }
}

고급 사용자용: 공개 포트를 열지 않고 SSH를 통해 stdio MCP 서버를 실행하는 방식입니다.

{
  "mcpServers": {
    "ad-mcp-remote": {
      "command": "ssh",
      "args": [
        "-i", "여기에_키_경로.pem",
        "ubuntu@152.67.220.151",
        "/home/ubuntu/ad-mcp/venv/bin/python3 /home/ubuntu/ad-mcp/mcp_server/main.py --transport stdio"
      ]
    }
  }
}

외부 사용자가 자주 겪는 오류와 조치 방법입니다.

1) Connection refused
- URL 오타 확인: https://koreanads.com/mcp 또는 https://koreanads.com/sse
- 방화벽/보안그룹에서 아웃바운드 차단 여부 확인

2) 서버는 연결되는데 도구가 보이지 않음
- 클라이언트에서 서버 삭제 후 다시 추가
- 앱 완전 종료 후 재실행 (특히 Claude Desktop)

3) Timeout 또는 느린 응답
- 회사 프록시/보안 게이트웨이에서 HTTP 스트리밍 차단 여부 확인
- 필요시 /sse 경로로 우회 연결

4) 한글 깨짐
- 클라이언트 인코딩을 UTF-8로 설정
- 터미널/IDE locale 확인