Agents Setup

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

8 min read

AEKO 에이전트란

AEKO 에이전트를 설치하면, Claude · Cursor · Codex 같은 AI 앱에서 AEKO의 데이터를 바로 조회하고 최적화 작업을 실행할 수 있습니다. (내부적으로 MCP라는 표준 연결 방식을 사용합니다.) 한 번 설치하면 가시성 데이터, 최적화 제안, 콘텐츠 생성 기능을 IDE나 데스크톱 앱 안에서 바로 실행할 수 있습니다.

설치는 두 단계입니다 — ① AEKO 연결 추가(데이터 접근)와 ② 스킬 팩 설치(13개 자동화 기능). 마지막에 /aeko-onboarding으로 설치를 검증합니다.

AEKO 에이전트는 AEKO 계정 로그인 기반으로 연결됩니다. 활성 구독 플랜(Starter / Pro / Enterprise)이라면 누구나 사용할 수 있습니다. AEKO 연결을 추가하면 브라우저가 자동으로 열리고, AEKO 계정으로 로그인하면 바로 연결됩니다. 별도의 키나 코드를 복사할 필요가 없습니다.

Claude Desktop 설정

Claude Desktop 앱에서 AEKO를 연결하는 방법입니다.

Step 1. Claude Desktop에서 Settings → Connectors 로 이동합니다.

Step 2. Add custom connector 를 눌러 아래 URL을 추가합니다.

https://aeko-intelligence.com/mcp

Step 3. 커넥터를 저장한 뒤 Connect 를 눌러 AEKO 계정으로 로그인하고 접근을 승인합니다.

Step 4. 대화에서 커넥터를 활성화하고 AEKO 도구가 표시되는지 확인합니다.

Cursor 설정

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

설정 절차

Step 1. Cursor Settings → MCP → Add new MCP server
Step 2. 연결 방식(Transport)은 http를 선택하고, URL에 https://aeko-intelligence.com/mcp 를 입력합니다
Step 3. 저장하면 브라우저가 열려 AEKO 계정 로그인 + 권한 승인 진행
Step 4. Cursor 재시작 → AEKO 도구가 채팅에서 사용 가능

Claude Code 설정

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

Step 1. 터미널에서 실행:

claude mcp add --transport http aeko https://aeko-intelligence.com/mcp

Step 2. 브라우저가 열려 AEKO 계정 로그인 + 권한 승인을 진행합니다.

Step 3. Claude Code 세션에서 /mcp 로 연결 상태를 확인합니다.

Codex CLI 설정

Step 1. 터미널에서 실행:

codex mcp add --transport http aeko https://aeko-intelligence.com/mcp

Step 2. 브라우저 1-클릭 로그인으로 OAuth 인증.

Step 3. Codex 세션 재시작.

AEKO 플러그인 설치 (스킬 13개)

1단계에서 추가한 연결은 데이터를 읽는 역할이고, 이 스킬 팩은 '가시성 보고서 만들기'나 '상품 설명 고치기'같은 13가지 자동화 기능을 추가합니다. Claude Code 또는 Codex 세션에서 아래 명령어를 실행하세요.

/plugin marketplace add AEKO-Intelligence/aeko-plugin
/plugin install aeko-plugin@AEKO-Intelligence/aeko-plugin

소스 저장소: github.com/AEKO-Intelligence/aeko-plugin

설치 검증

플러그인 설치 후 /aeko-onboarding 을 실행하세요. 13개 스킬을 안내하고, MCP 연결 상태를 점검하고, 실행 스킬(aeko-create-content, aeko-update-pdp, aeko-fix-technical)을 브랜드에 맞게 커스터마이즈하도록 도와줍니다.

사용 가능한 MCP 도구

AEKO를 연결하면 30개 이상의 기능을 사용할 수 있습니다. 아래 목록을 외울 필요 없이, /aeko-... 스킬을 실행하면 필요한 기능이 자동으로 실행됩니다.

가시성 · 데이터

도구	설명
`aeko_list_domains`	연결된 도메인 목록
`aeko_get_domain_info`	도메인 메타데이터 + 상태
`aeko_get_score`	AEKO Score (가시성 지표)
`aeko_get_visibility_summary`	가시성 요약 (멘션 · 인용 · 감성)
`aeko_get_brand_kit`	브랜드 킷 조회 (톤 · 타겟 · 금지어)
`aeko_get_product_description`	제품 설명 + 메타 조회
`aeko_list_store_integrations`	연결된 스토어 (Shopify · Cafe24 등)

프롬프트 추적 · 리서치

도구	설명
`aeko_get_tracked_prompts`	추적 중인 프롬프트 목록
`aeko_get_tracked_prompt`	단일 프롬프트의 응답 + 인용 포렌식
`aeko_search_research_prompts`	프롬프트 라이브러리 검색
`aeko_track_prompt`	새 프롬프트 추적 시작
`aeko_untrack_prompt`	추적 해제

실행 계획 · 개선 가이드

도구	설명
`aeko_list_action_items`	PDP · 콘텐츠 개선 가이드 목록
`aeko_list_technical_items`	기술 수정 개선 가이드 목록
`aeko_get_action_plan`	단일 가이드의 Plan.md 조회
`aeko_complete_action_item`	가이드 완료 처리

쓰기 (브랜드 킷 · 제품 · 스토어)

도구	설명
`aeko_update_brand_kit`	브랜드 킷 수정
`aeko_update_product_description`	제품 설명 업데이트
`aeko_update_product_meta`	제품 메타 업데이트
`aeko_update_product_tags`	제품 태그 업데이트
`aeko_list_store_writes`	스토어 쓰기 이력 조회
`aeko_revert_store_write`	스토어 쓰기 되돌리기

사용 가능한 스킬 (13개)

스킬은 /aeko-...로 시작하는 단축 명령어입니다. 한 줄만 입력하면 여러 단계가 자동으로 실행됩니다.

그룹	스킬	설명
시작점	`/aeko-onboarding`	설치 검증 + 스킬 투어 + 커스터마이즈
시작점	`/aeko-action-center`	대기 중인 모든 작업 라우터
가시성 · 리서치	`/aeko-visibility-report`	기간별 점수 · 멘션 · 인용 · 감성
	`/aeko-prompt-deep-dive`	프롬프트 1건의 플랫폼별 포렌식
	`/aeko-find-prompts-to-track`	추적할 프롬프트 발굴 + 등록
	`/aeko-brand-competitor-analysis`	AI 답변 안에서의 브랜드 vs 경쟁사
	`/aeko-product-competitor-analysis`	제품 단위 경쟁 매트릭스
실행 (커스터마이즈 가능)	`/aeko-update-pdp`	PDP 리라이트 + JSON-LD + 스토어 쓰기
	`/aeko-create-content`	인용 포렌식 기반 멀티채널 콘텐츠
	`/aeko-fix-technical`	llms.txt · robots.txt · 사이트 JSON-LD
유지보수	`/aeko-refresh-jsonld`	JSON-LD 정기 새로고침
	`/aeko-brand-kit`	브랜드 킷 조회 · 수정
	`/aeo-audit`	AEKO 계정 없이 동작하는 일반 AEO 진단

사용 예시

실제 워크플로우 예시 — 설치 직후 첫 30분 동안 해볼 수 있는 흐름입니다.

설치 후 → 첫 액션까지

Claude / Codex에서 /aeko-onboarding 실행 → 13개 스킬 투어 + MCP 연결 검증
/aeko-action-center mybrand.com → 대기 중인 Technical / PDP / Content 항목을 카테고리별로 표시
표시된 항목 중 하나를 골라 /aeko-update-pdp <item-id> 실행 → AEKO가 AI 응답 분석 결과와 브랜드 톤을 반영해서 상품 페이지 설명을 새로 작성하고, AI가 읽을 수 있는 구조화 데이터도 함께 생성
완료 후 /aeko-visibility-report mybrand.com → 점수 변화 추적
새로운 프롬프트를 발굴하고 싶다면 /aeko-find-prompts-to-track mybrand.com → 등록 → 다음 사이클부터 데이터 수집

Improvement Guides

Subscription Plans