@vidalytics/mcp

Model Context Protocol을 통해 Vidalytics 비디오 분석 데이터를 AI 코딩 어시스턴트에 연결하는 원커맨드 설정입니다.

Claude(CLI 및 Desktop), Windsurf, Cursor 및 기타 모든 MCP 호환 클라이언트에서 작동합니다.

설정

npx @vidalytics/mcp install

그게 전부입니다. 설치 프로그램이 설치된 AI 클라이언트를 감지하고, 구성할 클라이언트를 선택할 수 있게 한 다음 연결합니다. 클라이언트를 다시 시작하세요 — 첫 사용 시 OAuth 인증을 위한 브라우저 창이 열립니다.

Related MCP server: submagic-mcp-server

Cursor

또는 설치 프로그램을 통해:

npx @vidalytics/mcp install --client cursor

또는 수동으로 — ~/.cursor/mcp.json에 다음을 추가하세요:

{
  "mcpServers": {
    "vidalytics": {
      "url": "https://api.vidalytics.com/public/v1/mcp"
    }
  }
}

Cursor를 다시 시작하세요. 첫 사용 시 Vidalytics 계정에 대한 OAuth 인증을 위해 브라우저 창이 열립니다 — 설정할 API 키나 환경 변수가 없습니다.

기능

• 구성 파일, 앱 디렉터리, $PATH의 바이너리, 앱 번들(예: macOS의 /Applications)을 확인하여 설치된 MCP 클라이언트(Claude CLI, Claude Desktop, Windsurf, Cursor)를 감지합니다

• 대화형 체크리스트(감지된 클라이언트가 미리 선택됨)를 표시하여 원하는 클라이언트만 정확히 구성할 수 있게 합니다 — 또는 --client로 비대화형으로 선택할 수 있습니다

• 선택한 각 클라이언트의 구성에 Vidalytics를 MCP 서버로 추가합니다

• 작성 후 구성이 유효하고 MCP 서버에 연결할 수 있는지 검증합니다

• 비대화형 터미널(CI)과 명시적 선택 플래그(--client, --all, --yes)는 체크리스트를 건너뛰고 예측 가능하게 동작합니다

사용 가능한 도구

연결되면 AI 어시스턴트가 다음 도구에 접근할 수 있습니다:

옵션

npx @vidalytics/mcp install [flags]

  --client <names>   Configure only these clients, comma-separated
                     (claude-cli, claude-desktop, windsurf, cursor)
  --all              Configure all known clients, even if not detected
  --config <path>    Also configure a custom config file (repeatable)
  --force            Re-apply even if already configured
  --yes              Skip prompts (configure detected clients)

대화형 터미널에서 플래그 없이 실행하면 구성할 클라이언트의 체크리스트가 표시됩니다(감지된 클라이언트는 미리 선택됨, 스페이스로 토글, 엔터로 확인). --client cursor,windsurf는 동일한 선택을 비대화형으로 수행합니다.

--config 플래그는 여러 파일에 대해 반복할 수 있습니다. 대상 파일은 Claude Desktop, Cursor, Windsurf에서 사용하는 { "mcpServers": {} } 형식을 따라야 합니다 — MCP 플러그인이 있는 Zed 또는 VS Code와 같이 지원되지 않는 클라이언트에 유용합니다.

문제 해결

인증 문제가 있거나 다시 인증해야 하나요? mcp-remote가 홈 디렉터리에 캐시하는 자격 증명을 재설정한 다음 클라이언트를 다시 시작하세요:

MCP Registry

이 서버는 공식 MCP Registry에 **com.vidalytics/mcp**로 게시되어 있습니다. 원격(streamable-http) 서버이므로 레지스트리를 인식하는 MCP 클라이언트는 다음 주소에서 직접 연결할 수 있습니다:

https://api.vidalytics.com/public/v1/mcp

API 키나 환경 변수가 필요 없습니다 — 인증은 첫 사용 시 OAuth를 통해 처리됩니다.

요구 사항

• Node.js 18+

• Vidalytics 계정

라이선스

MIT