Agent integration · MCP
베타쓰던 AI 에이전트에 Cero를 연결하세요
Claude, Claude Code, Codex, Cursor에서 경쟁사 광고 검색과 리포트 조회를 바로 호출합니다. 필요한 것은 URL 하나와 API 키 하나, 크레딧은 웹과 같은 플랜에서 함께 차감됩니다. MCP 연동은 Lite 플랜(월 4,900원)에서 제공합니다.
연결 순서
세 단계면 끝납니다
설치 프로그램도, 별도 SDK도 없습니다. 키를 받아 사용하는 도구에 붙여넣으면 에이전트가 Cero 툴을 호출합니다.
- 01
API 키 받기
Lite 플랜에서 발급합니다. 베타 기간에는 도입 문의로 신청하면 1영업일 안에 키를 보내드립니다. 키는 계정당 발급되며 한 번만 표시됩니다.
- 02
클라이언트에 추가
아래에서 사용하는 도구를 골라 스니펫을 붙여넣습니다. 엔드포인트 URL과 Authorization 헤더면 충분합니다.
- 03
첫 검색으로 확인
에이전트에게 “Cero로 경쟁사 광고 검색해줘”라고 말해보세요. 잔여 크레딧은 매 응답 하단에 표시됩니다.
클라이언트별 설정
사용하는 도구를 고르세요
스니펫의 <발급한 API 키> 자리에 받은 키를 넣으면 됩니다. 키는 비밀번호처럼 다루고, 공유 저장소에 커밋하지 마세요.
- 1claude.ai 또는 데스크톱 앱에서 설정 → 커넥터로 이동합니다.
- 2"커스텀 커넥터 추가"를 누르고 이름은 Cero, URL에는 아래 주소를 붙여넣습니다.
- 3고급 설정의 인증 헤더에 Authorization: Bearer <발급한 API 키>를 입력하고 연결합니다.
https://www.cero.ing/api/mcp/mcp커스텀 커넥터의 헤더 인증은 Anthropic이 순차 적용 중인 베타 기능이라 계정에 따라 아직 보이지 않을 수 있습니다. 보이지 않으면 Claude Code 탭의 방법을 사용하거나 문의해 주세요.
에이전트 우선
사람 대신 에이전트에게 시키기
아래 텍스트를 코딩 에이전트에 그대로 붙여넣으면, 에이전트가 자기 클라이언트를 알아서 설정하고 연결까지 확인합니다.
Cero MCP 서버를 지금 사용 중인 이 코딩 에이전트에 연결해줘.
- 엔드포인트: https://www.cero.ing/api/mcp/mcp (MCP Streamable HTTP)
- 인증: Authorization 헤더에 Bearer <내 API 키>
- 내 API 키: (여기에 붙여넣기)
클라이언트별 설정 위치:
- Claude Code: claude mcp add --transport http cero https://www.cero.ing/api/mcp/mcp --header "Authorization: Bearer <키>"
- Codex CLI: ~/.codex/config.toml에 [mcp_servers.cero] 블록 추가 (url, bearer_token_env_var = "CERO_API_KEY", tool_timeout_sec = 120 권장)
- Cursor: .cursor/mcp.json의 mcpServers.cero에 url과 headers.Authorization 추가
설정을 마치면 cero_get_usage 툴을 호출해서 연결과 남은 크레딧을 확인해줘.제공 툴
검색과 조회에 필요한 다섯 가지
크레딧을 쓰는 툴은 설명에 항상 먼저 표시합니다. 실패한 검색은 차감하지 않습니다.
- 검색 크레딧 1회
cero_search_ads
광고주 이름으로 유튜브 광고를 검색하고 게재 근거를 받습니다.
- 무료
cero_suggest_advertisers
광고주 이름을 자동완성해 오매칭으로 인한 크레딧 낭비를 막습니다.
- 무료
cero_get_report
완료된 AI 분석 리포트의 등급·축별 점수·강약점을 조회합니다.
- 무료
cero_list_reports
내 계정의 분석 리포트 목록을 가져옵니다.
- 무료
cero_get_usage
플랜과 남은 검색·분석 크레딧, 리셋 시점을 확인합니다.
베타 운영
파일럿 베타로 시작합니다
지금은 신청 계정에 한해 키를 발급합니다. 연결 문제나 개선 의견은 언제든 알려주세요. 온보딩이 5분을 넘기면 저희가 고칠 차례입니다.