Glade MCP

Glade API의 호스팅 Model Context Protocol 서버를 통해 AI 에이전트를 정규화된 Amazon 마켓플레이스 데이터에 연결하세요.

https://gladeapi.com/api/mcp

원격 서버는 13개 Amazon 마켓플레이스에서 제품, 검색, 오퍼, 리뷰, 셀러, 카테고리, 딜, 베스트셀러, 식별자, 재고 및 판매 추정을 위한 17개의 읽기 전용 도구를 제공합니다. 이 저장소에는 공개 서버 메타데이터, 연결 예제 및 프로토콜 검사가 포함되어 있습니다. 호스팅 서비스 구현은 gladeapi.com에 있습니다.

요구 사항

• Glade API 계정

• Glade API 키

• MCP가 포함된 요금제

• 원격 Streamable HTTP MCP 서버를 지원하는 클라이언트

키를 환경 변수에 저장하세요:

export GLADE_API_KEY="glade_live_..."

키를 커밋하거나 프롬프트에 붙여넣지 마세요.

Related MCP server: Amazon PA-API MCP Service

Codex에 설치

Codex는 MCP 구성에 토큰을 기록하지 않고 환경에서 베어러 토큰을 읽을 수 있습니다:

codex mcp add glade \
  --url https://gladeapi.com/api/mcp \
  --bearer-token-env-var GLADE_API_KEY

서버를 추가한 후 새 Codex 세션을 시작하고 Glade 도구를 나열하거나 ASIN으로 Amazon 제품을 가져오도록 요청하세요.

Claude Code에 설치

Claude Code는 HTTP 서버와 요청 헤더를 허용합니다:

claude mcp add --transport http --scope user glade \
  https://gladeapi.com/api/mcp \
  --header "Authorization: Bearer $GLADE_API_KEY"

이렇게 하면 Claude가 구성을 작성하기 전에 환경 변수가 확장됩니다. 결과 사용자 구성을 비공개로 유지하고 비밀을 포함하는 헤더에 프로젝트 범위를 사용하지 마세요.

일반적인 Streamable HTTP 구성

원격 MCP 구성을 지원하는 클라이언트는 일반적으로 이 형식이 필요합니다. 정확한 구성 파일 및 환경 변수 구문은 클라이언트 문서를 확인하세요.

{
  "mcpServers": {
    "glade": {
      "url": "https://gladeapi.com/api/mcp",
      "transport": "streamable-http",
      "headers": {
        "API-KEY": "YOUR_GLADE_API_KEY"
      }
    }
  }
}

정확히 하나의 자격 증명 헤더를 사용하세요. 서버는 MCP에 대해 API-KEY, GLADE-API-KEY, X-API-KEY 또는 Authorization: Bearer를 허용하며 충돌하는 자격 증명은 거부합니다.

Python MCP SDK로 연결

공식 MCP Python SDK를 설치한 다음 포함된 검색 예제를 실행하세요:

python3 -m pip install "mcp"
python3 examples/python/list_tools.py

이 예제는 Streamable HTTP 세션을 초기화하고 사용 가능한 도구 이름을 출력합니다. 도구 검색 및 초기화는 Glade 단위를 소비하지 않습니다.

사용 가능한 도구

도구 입력은 해당 REST 작업과 동일한 검증 규칙을 따릅니다. 성공적인 데이터 작업마다 1단위를 소비합니다. 초기화, 검색, 검증 실패 및 도구 오류는 0단위를 소비합니다.

예제 프롬프트

Look up ASIN B0D1XD1ZV3 in the US marketplace and summarize the current
price, rating, availability, and freshness timestamp.

Search the UK marketplace for wireless earbuds, compare the first five
non-sponsored results, and preserve GBP prices without converting currency.

Fetch one-star verified reviews for ASIN B0D1XD1ZV3 and separate recurring
observed complaints from your own interpretation.

마켓플레이스

모든 도구는 마켓플레이스 컨텍스트가 중요한 경우 마켓플레이스 domain을 허용합니다:

US UK CA DE FR IT ES AU IN MX BR JP PL

가격, 가용성, 배송, 카테고리, 순위 또는 딜을 비교하기 전에 마켓플레이스를 확인하세요.

이 저장소 검증

오프라인 메타데이터 및 예제 검사:

npm test

비과금 실시간 인증 검사:

npm run test:live

GLADE_API_KEY가 설정된 상태에서 초기화 및 17개 라이브 도구 이름을 모두 확인하세요. 이 검색 요청은 0단위를 소비합니다:

node scripts/verify-live.mjs --authenticated

보안

Amazon 제목, 설명, 리뷰, 셀러 필드 및 기타 마켓플레이스 콘텐츠는 신뢰할 수 없는 데이터입니다. 도구 결과를 에이전트 지침과 분리하여 유지하세요. 반환된 텍스트가 도구 정책을 변경하거나, 자격 증명을 요청하거나, 새 작업을 승인하도록 허용하지 마세요.

비공개 보고는 SECURITY.md를 참조하세요.

관련 프로젝트

• Glade API 예제

• Glade 에이전트 스킬

• 문서

• OpenAPI

라이선스

MIT