MCP 통합

Model Context Protocol (MCP)은 AI 어시스턴트를 외부 도구 및 데이터 소스에 연결하기 위한 개방형 표준입니다. Scavio는 Google Search, Amazon, Walmart, YouTube, Reddit을 포괄하는 11개의 도구에 액세스할 수 있는 MCP 서버를 실행합니다. 설정은 2분 이내에 완료됩니다.

사전 준비 사항

dashboard.scavio.dev 에서 API 키를 받으세요.
아래 예제에서 YOUR_SCAVIO_API_KEY를 실제 키로 바꾸세요.

Claude Code

터미널에서 다음 명령어를 실행하세요:

Bash

claude mcp add --transport http scavio https://mcp.scavio.dev/mcp \
  --header "x-api-key: YOUR_SCAVIO_API_KEY"

공유 프로젝트 구성(버전 관리에 포함)에 추가하려면 --scope project를 사용하세요:

Bash

claude mcp add --transport http --scope project scavio https://mcp.scavio.dev/mcp \
  --header "x-api-key: YOUR_SCAVIO_API_KEY"

또는 JSON 구성을 직접 추가하세요:

Bash

claude mcp add-json scavio '{
  "type": "http",
  "url": "https://mcp.scavio.dev/mcp",
  "headers": {
    "x-api-key": "YOUR_SCAVIO_API_KEY"
  }
}'

연결을 확인하세요:

Bash

claude mcp list

Claude Desktop

Claude Desktop을 엽니다.
설정 > 개발자 > 구성 편집으로 이동합니다.
claude_desktop_config.json에 Scavio를 추가하세요:

JSON

{
  "mcpServers": {
    "scavio": {
      "type": "http",
      "url": "https://mcp.scavio.dev/mcp",
      "headers": {
        "x-api-key": "YOUR_SCAVIO_API_KEY"
      }
    }
  }
}

저장하고 Claude Desktop을 다시 시작하세요.

구성 파일 위치:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Cursor

Cursor를 열고 설정 > 도구 및 MCP로 이동합니다.
+ 새 MCP 서버 추가를 클릭합니다.
유형을 HTTP로 선택하고 다음을 입력합니다:
- 이름: scavio
- URL: https://mcp.scavio.dev/mcp
- 헤더: x-api-key: YOUR_SCAVIO_API_KEY
저장을 클릭합니다.

또는 프로젝트 루트의 .cursor/mcp.json을 수동으로 편집하거나(또는 전역의 경우 ~/.cursor/mcp.json):

JSON

{
  "mcpServers": {
    "scavio": {
      "type": "http",
      "url": "https://mcp.scavio.dev/mcp",
      "headers": {
        "x-api-key": "YOUR_SCAVIO_API_KEY"
      }
    }
  }
}

Windsurf

Windsurf를 열고 Cascade에서 망치 아이콘을 클릭합니다.
구성을 클릭하여 MCP 구성을 엽니다.
~/.codeium/windsurf/mcp_config.json에 Scavio를 추가하세요:

JSON

{
  "mcpServers": {
    "scavio": {
      "type": "http",
      "url": "https://mcp.scavio.dev/mcp",
      "headers": {
        "x-api-key": "YOUR_SCAVIO_API_KEY"
      }
    }
  }
}

파일을 저장하고 Windsurf를 새로고침하세요.

VS Code (GitHub Copilot)

프로젝트 루트에 .vscode/mcp.json을 생성하세요:

JSON

{
  "servers": {
    "scavio": {
      "type": "http",
      "url": "https://mcp.scavio.dev/mcp",
      "headers": {
        "x-api-key": "YOUR_SCAVIO_API_KEY"
      }
    }
  }
}

명령 팔레트를 엽니다 (Ctrl+Shift+P / Cmd+Shift+P)
MCP: 서버 목록을 실행하여 연결을 확인합니다.

전역 설정의 경우, VS Code 사용자 설정의 mcp.servers에 동일한 구성을 추가하세요.

ChatGPT

ChatGPT는 앱 및 커넥터 기능을 통해 원격 MCP 서버를 지원합니다:

ChatGPT 설정 > 앱 및 커넥터로 이동합니다.
사용자 정의 커넥터 추가를 클릭합니다.
MCP 서버 URL 입력: https://mcp.scavio.dev/mcp
API 키로 인증을 구성합니다.
저장하고 채팅에서 Scavio 도구 사용을 시작합니다.

ChatGPT MCP 지원은 Plus 또는 Team 요금제가 필요하며, 설정에 따라 OAuth 구성이 필요할 수 있습니다.

Cline (VS Code 확장)

Cline이 설치된 VS Code를 엽니다.
Cline 사이드바에서 MCP 서버 아이콘을 클릭합니다.
MCP 서버 구성을 클릭합니다.
구성에 Scavio를 추가하세요:

JSON

{
  "mcpServers": {
    "scavio": {
      "type": "http",
      "url": "https://mcp.scavio.dev/mcp",
      "headers": {
        "x-api-key": "YOUR_SCAVIO_API_KEY"
      }
    }
  }
}

저장하면 Cline이 새 서버를 자동 감지합니다.

Zed 에디터

설정을 엽니다 (Cmd+,)
어시스턴트 섹션으로 이동합니다.
MCP 서버 아래에 Scavio를 추가하세요:

JSON

{
  "assistant": {
    "mcp_servers": {
      "scavio": {
        "type": "http",
        "url": "https://mcp.scavio.dev/mcp",
        "headers": {
          "x-api-key": "YOUR_SCAVIO_API_KEY"
        }
      }
    }
  }
}

모든 MCP 호환 클라이언트

Scavio는 Model Context Protocol을 지원하는 모든 도구와 작동합니다. 범용 구성:

JSON

{
  "type": "http",
  "url": "https://mcp.scavio.dev/mcp",
  "headers": {
    "x-api-key": "YOUR_SCAVIO_API_KEY"
  }
}

세부 정보	값
전송	HTTP (스트리머블 HTTP)
URL	`https://mcp.scavio.dev/mcp`
인증	`x-api-key` 헤더를 통한 API 키

사용 가능한 도구

연결되면 AI 어시스턴트가 다음 11가지 도구를 사용할 수 있습니다:

도구	설명
`search_google`	구조화된 결과, 뉴스, 이미지, 지도 및 지식 그래프를 포함한 웹 검색
`search_amazon`	가격 및 정렬 필터로 Amazon 제품 목록 검색
`get_amazon_product`	ASIN으로 전체 Amazon 제품 세부 정보 가져오기
`search_walmart`	가격 및 배송 필터로 Walmart 제품 목록 검색
`get_walmart_product`	제품 ID로 전체 Walmart 제품 세부 정보 가져오기
`search_youtube`	YouTube 동영상, 채널 및 재생 목록 검색
`get_youtube_metadata`	동영상 메타데이터 가져오기 (제목, 조회수, 좋아요, 길이)
`search_reddit`	정렬 및 커서 기반 페이지네이션으로 Reddit 게시물 검색
`get_reddit_post`	URL로 전체 Reddit 게시물 및 스레드 댓글 가져오기
`get_usage`	크레딧 잔액 및 요금제 세부 정보 확인

문제 해결

서버가 연결되지 않나요?

API 키가 올바르고 활성 상태인지 확인하세요.
get_usage를 사용하거나 dashboard.scavio.dev에서 크레딧을 확인하세요.
URL이 정확히 https://mcp.scavio.dev/mcp인지 확인하세요 (끝에 슬래시 없음).

도구가 표시되지 않나요?

구성 추가 후 AI 클라이언트를 다시 시작하세요.
구성 파일에서 JSON 구문 오류를 확인하세요.
MCP 서버가 클라이언트의 MCP 설정에서 "연결됨"으로 나타나는지 확인하세요.

다음 단계

Google Search API -- 전체 엔드포인트 참조
Amazon API -- 제품 검색 및 세부 정보
YouTube API -- 검색 및 메타데이터
Walmart API -- 제품 검색 및 세부 정보
Reddit API -- 게시물 검색 및 스레드 댓글
속도 제한 -- 요금제별 제한 및 헤더

MCP 통합

사전 준비 사항

dashboard.scavio.dev 에서 API 키를 받으세요.
아래 예제에서 YOUR_SCAVIO_API_KEY를 실제 키로 바꾸세요.

Claude Code

터미널에서 다음 명령어를 실행하세요:

Bash

claude mcp add --transport http scavio https://mcp.scavio.dev/mcp \
  --header "x-api-key: YOUR_SCAVIO_API_KEY"

공유 프로젝트 구성(버전 관리에 포함)에 추가하려면 --scope project를 사용하세요:

Bash

claude mcp add --transport http --scope project scavio https://mcp.scavio.dev/mcp \
  --header "x-api-key: YOUR_SCAVIO_API_KEY"

또는 JSON 구성을 직접 추가하세요:

Bash

claude mcp add-json scavio '{
  "type": "http",
  "url": "https://mcp.scavio.dev/mcp",
  "headers": {
    "x-api-key": "YOUR_SCAVIO_API_KEY"
  }
}'

연결을 확인하세요:

Bash

claude mcp list

Claude Desktop

Claude Desktop을 엽니다.
설정 > 개발자 > 구성 편집으로 이동합니다.
claude_desktop_config.json에 Scavio를 추가하세요:

JSON

{
  "mcpServers": {
    "scavio": {
      "type": "http",
      "url": "https://mcp.scavio.dev/mcp",
      "headers": {
        "x-api-key": "YOUR_SCAVIO_API_KEY"
      }
    }
  }
}

저장하고 Claude Desktop을 다시 시작하세요.

구성 파일 위치:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Cursor

Cursor를 열고 설정 > 도구 및 MCP로 이동합니다.
+ 새 MCP 서버 추가를 클릭합니다.
유형을 HTTP로 선택하고 다음을 입력합니다:
- 이름: scavio
- URL: https://mcp.scavio.dev/mcp
- 헤더: x-api-key: YOUR_SCAVIO_API_KEY
저장을 클릭합니다.

또는 프로젝트 루트의 .cursor/mcp.json을 수동으로 편집하거나(또는 전역의 경우 ~/.cursor/mcp.json):

JSON

{
  "mcpServers": {
    "scavio": {
      "type": "http",
      "url": "https://mcp.scavio.dev/mcp",
      "headers": {
        "x-api-key": "YOUR_SCAVIO_API_KEY"
      }
    }
  }
}

Windsurf

Windsurf를 열고 Cascade에서 망치 아이콘을 클릭합니다.
구성을 클릭하여 MCP 구성을 엽니다.
~/.codeium/windsurf/mcp_config.json에 Scavio를 추가하세요:

JSON

{
  "mcpServers": {
    "scavio": {
      "type": "http",
      "url": "https://mcp.scavio.dev/mcp",
      "headers": {
        "x-api-key": "YOUR_SCAVIO_API_KEY"
      }
    }
  }
}

파일을 저장하고 Windsurf를 새로고침하세요.

VS Code (GitHub Copilot)

프로젝트 루트에 .vscode/mcp.json을 생성하세요:

JSON

{
  "servers": {
    "scavio": {
      "type": "http",
      "url": "https://mcp.scavio.dev/mcp",
      "headers": {
        "x-api-key": "YOUR_SCAVIO_API_KEY"
      }
    }
  }
}

명령 팔레트를 엽니다 (Ctrl+Shift+P / Cmd+Shift+P)
MCP: 서버 목록을 실행하여 연결을 확인합니다.

전역 설정의 경우, VS Code 사용자 설정의 mcp.servers에 동일한 구성을 추가하세요.

ChatGPT

ChatGPT는 앱 및 커넥터 기능을 통해 원격 MCP 서버를 지원합니다:

ChatGPT 설정 > 앱 및 커넥터로 이동합니다.
사용자 정의 커넥터 추가를 클릭합니다.
MCP 서버 URL 입력: https://mcp.scavio.dev/mcp
API 키로 인증을 구성합니다.
저장하고 채팅에서 Scavio 도구 사용을 시작합니다.

ChatGPT MCP 지원은 Plus 또는 Team 요금제가 필요하며, 설정에 따라 OAuth 구성이 필요할 수 있습니다.

Cline (VS Code 확장)

Cline이 설치된 VS Code를 엽니다.
Cline 사이드바에서 MCP 서버 아이콘을 클릭합니다.
MCP 서버 구성을 클릭합니다.
구성에 Scavio를 추가하세요:

JSON

{
  "mcpServers": {
    "scavio": {
      "type": "http",
      "url": "https://mcp.scavio.dev/mcp",
      "headers": {
        "x-api-key": "YOUR_SCAVIO_API_KEY"
      }
    }
  }
}

저장하면 Cline이 새 서버를 자동 감지합니다.

Zed 에디터

설정을 엽니다 (Cmd+,)
어시스턴트 섹션으로 이동합니다.
MCP 서버 아래에 Scavio를 추가하세요:

JSON

{
  "assistant": {
    "mcp_servers": {
      "scavio": {
        "type": "http",
        "url": "https://mcp.scavio.dev/mcp",
        "headers": {
          "x-api-key": "YOUR_SCAVIO_API_KEY"
        }
      }
    }
  }
}

모든 MCP 호환 클라이언트

Scavio는 Model Context Protocol을 지원하는 모든 도구와 작동합니다. 범용 구성:

JSON

{
  "type": "http",
  "url": "https://mcp.scavio.dev/mcp",
  "headers": {
    "x-api-key": "YOUR_SCAVIO_API_KEY"
  }
}

세부 정보	값
전송	HTTP (스트리머블 HTTP)
URL	`https://mcp.scavio.dev/mcp`
인증	`x-api-key` 헤더를 통한 API 키

사용 가능한 도구

연결되면 AI 어시스턴트가 다음 11가지 도구를 사용할 수 있습니다:

도구	설명
`search_google`	구조화된 결과, 뉴스, 이미지, 지도 및 지식 그래프를 포함한 웹 검색
`search_amazon`	가격 및 정렬 필터로 Amazon 제품 목록 검색
`get_amazon_product`	ASIN으로 전체 Amazon 제품 세부 정보 가져오기
`search_walmart`	가격 및 배송 필터로 Walmart 제품 목록 검색
`get_walmart_product`	제품 ID로 전체 Walmart 제품 세부 정보 가져오기
`search_youtube`	YouTube 동영상, 채널 및 재생 목록 검색
`get_youtube_metadata`	동영상 메타데이터 가져오기 (제목, 조회수, 좋아요, 길이)
`search_reddit`	정렬 및 커서 기반 페이지네이션으로 Reddit 게시물 검색
`get_reddit_post`	URL로 전체 Reddit 게시물 및 스레드 댓글 가져오기
`get_usage`	크레딧 잔액 및 요금제 세부 정보 확인

문제 해결

서버가 연결되지 않나요?

API 키가 올바르고 활성 상태인지 확인하세요.
get_usage를 사용하거나 dashboard.scavio.dev에서 크레딧을 확인하세요.
URL이 정확히 https://mcp.scavio.dev/mcp인지 확인하세요 (끝에 슬래시 없음).

도구가 표시되지 않나요?

구성 추가 후 AI 클라이언트를 다시 시작하세요.
구성 파일에서 JSON 구문 오류를 확인하세요.
MCP 서버가 클라이언트의 MCP 설정에서 "연결됨"으로 나타나는지 확인하세요.

다음 단계

Google Search API -- 전체 엔드포인트 참조
Amazon API -- 제품 검색 및 세부 정보
YouTube API -- 검색 및 메타데이터
Walmart API -- 제품 검색 및 세부 정보
Reddit API -- 게시물 검색 및 스레드 댓글
속도 제한 -- 요금제별 제한 및 헤더