Keitaro TDS API MCP 플러그인

설명

Keitaro TDS API와 통합하기 위한 MCP 서버로, 캠페인, 스트림, 오퍼 및 기타 Keitaro 엔터티를 다루는 도구를 제공합니다.

Related MCP server: TeamRetro MCP Server

설치

커서에 플러그인 설치

1. 저장소를 복제합니다

지엑스피1

2. 종속성 설치

npm install

3. 패키지를 전역적으로 설치합니다.

npm install -g .

4. 커서에 플러그인을 설치하세요

node install-cursor-plugin.js

5. 커서 재시작

대안: 커서의 수동 구성

커서 구성에 Keitaro MCP 서버를 수동으로 추가할 수도 있습니다.

1. 커서 MCP 구성 파일을 엽니다.

# On macOS
open ~/.cursor/mcp.json

# On Windows
notepad %USERPROFILE%\.cursor\mcp.json

# On Linux
nano ~/.cursor/mcp.json

2. "mcpServers" 개체에 다음 항목을 추가합니다.

"Keitaro": {
  "command": "mcp-keitaro-tds",
  "args": []
}

3. 파일을 저장하고 커서를 다시 시작하세요.

API 키 구성

다음 매개변수를 사용하여 프로젝트 루트에 .env 파일을 만듭니다.

KEITARO_API_URL=http://your-keitaro-domain.com/admin_api/v1
KEITARO_API_KEY=your-api-key

커서에서의 사용법

1. 커서 실행

2. 명령 팔레트를 엽니다(macOS에서는 Cmd+P, Windows/Linux에서는 Ctrl+P).

3. "케이타로"를 찾아 선택하세요

4. 이제 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
  }
})

개발

개발 모드에서 실행 중

npm run dev

MCP 서버 테스트

npm run inspect