Keitaro TDS API MCP 플러그인
설명
Keitaro TDS API와 통합하기 위한 MCP 서버로, 캠페인, 스트림, 오퍼 및 기타 Keitaro 엔터티를 다루는 도구를 제공합니다.
설치
커서에 플러그인 설치
- 저장소를 복제합니다
지엑스피1
- 종속성 설치
- 패키지를 전역적으로 설치합니다.
- 커서에 플러그인을 설치하세요
node install-cursor-plugin.js
- 커서 재시작
대안: 커서의 수동 구성
커서 구성에 Keitaro MCP 서버를 수동으로 추가할 수도 있습니다.
- 커서 MCP 구성 파일을 엽니다.
# On macOS
open ~/.cursor/mcp.json
# On Windows
notepad %USERPROFILE%\.cursor\mcp.json
# On Linux
nano ~/.cursor/mcp.json
- "mcpServers" 개체에 다음 항목을 추가합니다.
"Keitaro": {
"command": "mcp-keitaro-tds",
"args": []
}
- 파일을 저장하고 커서를 다시 시작하세요.
API 키 구성
다음 매개변수를 사용하여 프로젝트 루트에 .env
파일을 만듭니다.
KEITARO_API_URL=http://your-keitaro-domain.com/admin_api/v1
KEITARO_API_KEY=your-api-key
커서에서의 사용법
- 커서 실행
- 명령 팔레트를 엽니다(macOS에서는 Cmd+P, Windows/Linux에서는 Ctrl+P).
- "케이타로"를 찾아 선택하세요
- 이제 Cursor를 통해 Keitaro API를 사용할 수 있습니다.
사용 가능한 도구
캠페인
list_campaigns
- 캠페인 목록을 가져옵니다get_campaign
- 특정 캠페인에 대한 정보를 가져옵니다.create_campaign
- 새 캠페인을 만듭니다update_campaign
- 기존 캠페인 업데이트delete_campaign
- 캠페인 삭제
트래픽 스트림
list_streams
- 캠페인에 대한 트래픽 스트림 목록을 가져옵니다.get_stream
- 특정 스트림에 대한 정보를 가져옵니다
트래픽 소스
list_traffic_sources
- 트래픽 소스 목록을 가져옵니다get_traffic_source
- 특정 트래픽 소스에 대한 정보를 가져옵니다.
제안
list_offers
- 제안 목록 가져오기get_offer
- 특정 제안에 대한 정보를 가져옵니다
클릭 및 전환
list_clicks
- 클릭 목록 가져오기get_click
- 특정 클릭에 대한 정보를 가져옵니다list_conversions
- 변환 목록을 가져옵니다get_conversion
- 특정 변환에 대한 정보를 가져옵니다.
보고서
get_report
- 지정된 매개변수로 보고서 생성
도메인
list_domains
- 도메인 목록을 가져옵니다get_domain
- 특정 도메인에 대한 정보를 가져옵니다
사용 예
캠페인 목록 가져오기
list_campaigns({
limit: 10,
page: 1,
search: "search query"
})
새 캠페인 만들기
create_campaign({
name: "New Campaign",
type: "position",
cost_type: "CPC",
cost_value: 1.5,
group_id: 1,
state: "active",
traffic_source_id: 1
})
보고서 받기
get_report({
from: "2025-01-01",
to: "2025-01-31",
group: "campaign",
filters: {
campaign_id: 123
}
})
개발
개발 모드에서 실행 중
MCP 서버 테스트