stackadapt-mcp

StackAdapt의 GraphQL API를 쿼리하기 위한 MCP (Model Context Protocol) 서버입니다. Claude와 같은 AI 어시스턴트가 캠페인 데이터, 성과 지표, 광고주 정보 등에 직접 액세스할 수 있도록 합니다.

도구

Related MCP server: GraphQL MCP Server

설정

API 키 발급

StackAdapt API 키는 StackAdapt 플랫폼 → 설정 → API에서 확인할 수 있습니다.

Claude Desktop

claude_desktop_config.json 파일에 다음을 추가하세요:

{
  "mcpServers": {
    "stackadapt": {
      "command": "npx",
      "args": ["-y", "stackadapt-mcp"],
      "env": {
        "STACKADAPT_API_KEY": "your-api-key-here"
      }
    }
  }
}

Claude Code

프로젝트의 .mcp.json 파일에 다음을 추가하세요:

{
  "mcpServers": {
    "stackadapt": {
      "command": "npx",
      "args": ["-y", "stackadapt-mcp"],
      "env": {
        "STACKADAPT_API_KEY": "${STACKADAPT_API_KEY}"
      }
    }
  }
}

그런 다음 셸에서 환경 변수를 설정하세요: export STACKADAPT_API_KEY=your-api-key-here

데이터 참고 사항

StackAdapt API 사용 시 유의할 점:

• **cost, ecpc, ecpm, ecpe**는 문자열로 반환되므로 float로 파싱해야 합니다.

• **ctr**은 이미 백분율 값(0.214는 0.214%를 의미)이므로 100을 곱하지 마십시오.

• **ecpe**는 참여도가 0인 기간에 대해 "0"을 반환합니다.

• 성과 데이터 페이로드는 GraphQL UNION 타입(Outcome | Progress)입니다. 대규모 쿼리의 경우 작업 ID가 포함된 Progress 응답이 반환될 수 있으며, 몇 초 후 다시 시도하십시오.

• 세분화 옵션: DAILY, WEEKLY, MONTHLY, TOTAL

개발

git clone https://github.com/aymanshaikh/stackadapt-mcp.git
cd stackadapt-mcp
npm install
npm run build

로컬에서 테스트하려면 STACKADAPT_API_KEY를 설정하고 다음을 실행하세요:

STACKADAPT_API_KEY=your-key node dist/index.js

라이선스

MIT