Agents Setup

Connect AEKO Agents to Claude Desktop, Cursor, or Claude Code via MCP.

8 min read

AEKO 에이전트란

AEKO 에이전트는 MCP(Model Context Protocol)를 통해 Claude 같은 AI 어시스턴트가 AEKO의 도구와 데이터에 접근할 수 있게 해줍니다. 에이전트를 설치하면 Claude가 귀사의 가시성 데이터, 최적화 제안, 콘텐츠 생성 도구에 직접 접근할 수 있습니다.

Claude Desktop, Cursor, Claude Code 등에서 AEKO 데이터를 분석하고, 최적화된 콘텐츠를 생성하고, 제안을 실행하는 작업을 IDE나 데스크톱 앱 안에서 바로 수행할 수 있습니다.

AEKO 에이전트는 AEKO 계정 로그인 기반으로 연결됩니다. Starter 사용자는 로그인할 수 있지만 실제 에이전트 사용은 Growth 이상에서 가능합니다.

현재 상태

설정 가이드는 로그인 기반 연결 흐름에 맞춰 업데이트되고 있습니다. Growth 이상 사용자는 AEKO 앱에서 단기 토큰을 발급해 Codex 또는 Claude에 바로 연결할 수 있습니다.

Claude Desktop 설정

Claude Desktop에 AEKO 에이전트를 연결하는 방법입니다.

Step 1. 터미널에서 에이전트를 설치합니다:

pip install aeko-mcp

Step 2. AEKO 에이전트 연결 방식은 로그인 기반 플로우로 업데이트되고 있습니다. 현재는 설치만 완료해 두고 최신 연결 안내를 확인하세요:

# Install the package
pip install aeko-mcp

# Then follow the login-based AEKO Agents guide at
# https://aeko-intelligence.com/agents

Step 3. Claude Desktop을 재시작합니다.

Step 4. 도구 목록에 AEKO 도구가 표시되는지 확인합니다.

설정 파일 위치

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Cursor 설정

Cursor IDE에서 AEKO 에이전트를 설정하는 방법입니다.

설정 절차

Step 1. 터미널에서 설치: pip install aeko-mcp
Step 2. Cursor Settings → MCP → Add new MCP server
Step 3. Follow the AEKO login prompt once the updated agent connection flow is available
Step 4. Cursor 재시작

Claude Code 설정

Claude Code(CLI)에서 AEKO 에이전트를 설정하는 방법입니다.

Step 1. 터미널에서 설치:

pip install aeko-mcp

Step 2. 로그인 기반 연결 흐름이 배포되면 Claude Code에서 AEKO 계정으로 인증합니다:

# Install
pip install aeko-mcp

# Then sign in with your AEKO account when prompted by the updated MCP flow

Step 3. Claude Code 세션을 재시작합니다.

사용 가능한 도구

AEKO 에이전트는 16개의 도구를 3개 그룹으로 제공합니다.

데이터 도구 (8개)

도구명	설명
`get_domain_overview`	도메인 가시성 요약
`get_prompts`	추적 중인 프롬프트 목록
`get_prompt_results`	특정 프롬프트의 결과
`get_suggestions`	최적화 제안 목록
`get_sources`	AI 엔진이 인용한 소스 URL
`get_competitors`	경쟁사 분석 데이터
`get_product_analyses`	제품별 가시성 데이터
`get_drift_events`	멘션 변화 이벤트

생성 도구 (3개)

도구명	설명
`prepare_llms_txt`	llms.txt 콘텐츠 생성
`prepare_robots_txt_fix`	robots.txt 개선 제안
`prepare_json_ld`	JSON-LD 구조화 데이터 생성

파일 도구 (5개)

도구명	설명
`list_product_images`	제품 이미지 목록
`read_product_image`	제품 이미지 읽기
`save_content`	생성된 콘텐츠 파일 저장
`read_file`	출력 디렉토리의 파일 읽기
`list_files`	출력 디렉토리의 파일 목록

사용 가능한 스킬

스킬은 여러 도구를 조합한 고수준 워크플로우입니다. Claude에게 스킬 이름을 언급하면 자동으로 실행됩니다.

스킬	설명
`aeo-audit`	종합 AEO 감사
`aeo-optimize`	최적화 계획 생성
`generate-faq`	프롬프트 데이터 기반 FAQ 생성
`generate-jsonld`	JSON-LD 구조화 데이터 생성
`create-blog-article`	가시성 인사이트 기반 블로그 작성
`create-social-content`	소셜 미디어 콘텐츠 생성
`create-marketing-materials`	마케팅 자료 생성

사용 예시

에이전트를 활용한 실제 워크플로우 예시입니다.

예시: AEO 감사 및 블로그 작성

Claude에게 요청: "내 도메인의 AEO 감사를 실행해줘"
Claude가 get_domain_overview와 get_suggestions를 실행
Claude가 우선순위별 개선 사항을 분석하여 보고
Claude에게 요청: "경쟁 격차를 기반으로 [주제]에 대한 블로그 글을 작성해줘"
Claude가 get_competitors, get_prompt_results, save_content를 활용
생성된 콘텐츠를 검토하고 게시

Optimization Suggestions

Subscription Plans