자체 방문 통계는 항상 수집됩니다. 사용자가 공개 페이지를 어떻게 이용하는지 파악하는 데 쓰이는 Google Analytics(로그인한 워크스페이스는 제외)는 동의한 경우에만 사용됩니다. 자세한 내용은 개인정보 처리방침을 참고하세요.

Smithery 프록시 10월 31일 종료: EveryInfra MCP를 Claude에 연결하는 방법

Smithery가 10월 31일 MCP 프록시, 계정, API 키를 종료했습니다. EveryInfra의 MCP URL을 Claude, Claude Code 또는 Claude API에 직접 추가하세요. 테스트를 거친 명령어, 지연 시간, 호출당 비용을 함께 정리했습니다.

Smithery run.tools URL을 통해 EveryInfra에 연결하고 있다면 10월 31일 전에 https://api.everyinfra.com/mcp로 바꾸고 Authorization: Bearer <API key>를 보내도록 설정하세요. 변경 후에는 웹, 데스크톱, 모바일의 Claude와 Claude Code, Claude API에서 EveryInfra를 사용할 수 있습니다. 중간에 프록시를 거치지 않습니다. 2026년 10월 21일 18:19~18:24 UTC에 Claude Code 2.1.299를 사용하고 MCP 요청을 직접 보내 테스트했습니다. 서버 추가는 명령어 하나로 0.83초 걸렸습니다. 결과 5개짜리 TikTok 검색은 8.62초가 걸렸고 비용은 $0.000556였습니다.

EveryInfra의 MCP 서버는 하나의 Streamable HTTP 엔드포인트입니다. 도구 목록 조회에는 키가 필요 없으며, 데이터 호출은 USD로 호출당 과금되고 실패하거나 결과가 빈 호출에는 과금되지 않습니다. 키 하나로 106개 플랫폼, 573개 데이터 기능, 17개 검색 도구, 52개 CAPTCHA 유형을 사용할 수 있으며, 가격은 호출 1,000건당 $0.56부터입니다.

10월 31일부터 작동하지 않는 항목

Smithery의 공지에 따르면 연결 관리 기능은 2026년 10월 31일에 종료됩니다. 이후 “Smithery는 프록시를 거치지 않는 공개 MCP 레지스트리로 남게 됩니다.” 이 디렉터리는 현재 8월 5일 Smithery를 인수한 Arcade.dev가 운영합니다. 종료일에 다음 항목이 중단됩니다:

  • run.tools 및 server.smithery.ai의 서버 URL
  • Smithery API, Connect, Toolbox
  • Smithery 계정과 API 키
  • 사용 중단 예정인 Smithery CLI와 SDK
Smithery의 MCP 프록시와 관리형 ID 서비스가 10월 31일에 종료된다는 공지 스크린샷입니다. 첫 번째 청록색 상자는 첫 문단으로, 연결 관리 서비스가 2026년 10월 31일에 종료되며 Smithery는 프록시를 거치지 않는 공개 MCP 레지스트리로 남는다는 내용입니다. 두 번째 청록색 상자는 작동이 중단되는 항목을 나열합니다. run.tools와 server.smithery.ai의 서버 URL, Smithery API, Connect, Toolbox, Smithery 계정과 API 키, Smithery CLI와 SDK입니다.
10월 25일에 캡처한 Smithery 공지입니다. 청록색 상자는 종료일과 작동이 중단되는 항목을 표시합니다. Smithery 공지(원문)

Smithery가 사용자에게 안내하는 내용은 간단합니다. 서버 제공사의 자체 MCP URL로 전환하라는 것입니다. 공지에 시간대가 명시되어 있지 않으므로 10월 30일까지 전환을 마치는 것이 좋습니다.

10월 21일 18:22 UTC에 Smithery 공개 API로 저희 Smithery 등록 페이지를 확인했습니다. 연결 URL은 여전히 프록시인 api--everyinfra.run.tools입니다. Smithery 인증 정보 없이 요청하면 401 Missing Authorization header가 반환됩니다. 해당 페이지의 도구 목록은 9월 시점의 스냅샷으로 도구가 7개뿐이지만, 직접 엔드포인트는 도구 25개를 반환합니다. Smithery에 직접 URL을 표시해 달라고 요청했으나 이 글을 쓰는 시점까지 답변을 받지 못했습니다. 등록 페이지에 이후 무엇이 표시되든 직접 URL은 바뀌지 않습니다.

세 가지 연결 방법 중 하나를 선택하세요

  • 웹, 데스크톱, 모바일용 Claude. Customize → Connectors에서 URL과 요청 헤더를 입력해 사용자 지정 커넥터를 추가합니다. 연결은 사용자 컴퓨터가 아니라 Anthropic 클라우드에서 이루어지므로 서버가 공용 인터넷에서 접근 가능해야 합니다(Claude Help Center). claude_desktop_config.json은 로컬 서버 전용이며, 원격 커넥터는 여기에 추가하지 않습니다.
  • Claude Code. claude mcp add 명령 하나면 됩니다. 연결이 사용자 컴퓨터에서 시작되므로 저장소 안에서 데이터 스크립트를 실행하거나 분석할 때 적합합니다.
  • Claude API. Messages API의 MCP 커넥터는 mcp_servers로 URL을 받습니다. 직접 만든 프로그램에서 Claude가 도구를 호출하게 할 때 사용합니다.

EveryInfra는 아직 Claude 커넥터 디렉터리에 등록되어 있지 않으므로, 세 방법 모두 URL을 직접 추가해야 합니다.

테스트 기록: 설정부터 첫 과금까지

10월 22일(싱가포르 시간)에 얻은 원본 결과입니다. 비용은 각 응답의 billing 객체와 everyinfra_requests 도구의 호출별 내역에서 가져왔습니다.

요청시간결과
tools/list, 키 없음(요청 3건)0.23–0.25 sHTTP 200, 도구 25개
claude mcp add0.83 s설정 저장됨
claude mcp get everyinfra0.9–1.1 s✔ Connected
TikTok 검색 "claude code", 동영상 5개8.62 s$0.000556
Amazon 검색 "usb c hub", 상품 5개19.02 s$0.001389
존재하지 않는 TikTok 프로필69.52 s빈 결과, charged: false
TikTok 검색에 sort_by 사용0.17 sunknown_param, 과금 없음
키 없이 데이터 호출—unauthorized, 과금 없음
  1. 키 없이 도구 탐색. tools/list 요청 3건이 0.23~0.25초 만에 HTTP 200과 함께 도구 25개를 반환했습니다.
  2. Claude Code 설정. claude mcp add가 0.83초 만에 설정을 저장했고, claude mcp get everyinfra는 0.9~1.1초 만에 ✔ Connected를 표시했습니다.
  3. 키가 실제로 전송됐을까? 헤더에는 키가 아니라 ${EVERYINFRA_API_KEY}라는 참조가 저장됩니다. 로컬 검증용 서버에서는 헤더의 해시만 비교했습니다. Claude Code가 연결과 도구 목록 조회를 위해 보낸 모든 요청에 변수가 치환된 키가 담겨 있었습니다.
  4. TikTok 검색 "claude code", 동영상 5개: 8.62초, $0.000556. 5개 모두 10월 16~21일에 게시되었고, 조회수는 610회부터 257,200회까지(중앙값 23,300회)였습니다. 각 행에는 view_count, like_count, share_count, hashtags, posted_at을 포함해 33개 필드가 있습니다.
  5. Amazon 검색 "usb c hub", 상품 5개: 19.02초, $0.001389. 가격은 $9.99부터 $199.99까지, 리뷰 수는 2개부터 32,501개까지였습니다.
  6. 빈 결과. 존재하지 않는 TikTok 프로필은 69.52초 후 charged: false, empty_result_refunded와 함께 빈 결과로 돌아왔고, 예약된 금액은 반환되었습니다.
  7. 잘못된 파라미터. TikTok 검색에 sort_by를 넣자 0.17초 만에 unknown_param이 반환되었습니다. 응답은 유효한 파라미터 content_type과 limit을 알려 주고 작동하는 예시도 제시했으며, 과금은 없었습니다.
  8. 키 없이 데이터를 호출하면 사용할 헤더 형식과 함께 unauthorized가 반환되었습니다. 과금은 없었습니다.

세 가지를 알 수 있었습니다. "Connected"는 도구 탐색이 된다는 뜻일 뿐 키가 유효하다는 증거는 아니며, 실제 검증은 첫 데이터 호출에서 이루어집니다. 가장 느린 호출은 존재하지 않는 대상을 조회한 경우였는데, 무료이지만 시간은 걸립니다. 오류 메시지가 다음 단계를 알려 주므로 Claude가 대개 스스로 호출을 수정합니다. 자세한 내용은 API 오류와 자가 복구를 참고하세요.

https://api.everyinfra.com/mcp에 Authorization 헤더 없이 보낸 실제 요청 2건과 응답 스크린샷입니다. 첫 번째는 tools/list로, 200과 함께 도구 25개가 반환되었으며 그중 처음 두 개인 everyinfra_list_capabilities와 everyinfra_call_api가 표시되어 있습니다. 두 번째는 everyinfra_call_api로 TikTok 검색을 호출해 isError true, 오류 코드 unauthorized, 그리고 과금되지 않았다는 안내를 받았습니다.
10월 25일에 다시 실행한 원본 요청과 응답입니다. 키가 없어도 도구 25개가 모두 표시되고, 첫 데이터 호출은 unauthorized를 반환합니다(도구 2개만 표시, 긴 텍스트는 줄임). EveryInfra 원격 MCP 서버

Claude에 EveryInfra를 사용자 지정 커넥터로 추가하기

  1. API 키를 만듭니다. 회원가입 후 콘솔에서 키를 생성합니다(빠른 시작). 데이터만 쓴다면 키를 데이터 제품군으로 제한하고 분당 한도를 설정하세요.
  2. 커넥터 설정을 엽니다. Pro 또는 Max 요금제에서는 Customize → Connectors로 이동해 + 또는 Add를 선택한 다음 Custom → Web을 선택합니다. Team 또는 Enterprise 요금제에서는 Owner가 조직 설정에서 추가합니다. Free 요금제에서는 사용자 지정 커넥터를 1개까지 추가할 수 있습니다.
  3. 이름과 URL. 이름을 EveryInfra로 지정하고 MCP 서버 URL에 https://api.everyinfra.com/mcp를 입력합니다.
  4. 인증. No sign-in을 선택합니다. EveryInfra는 OAuth가 아닌 API 키를 사용합니다.
  5. 요청 헤더. 이름이 Authorization인 헤더를 추가하고, 값에는 Bearer 와 키를 공백 한 칸으로 구분해 입력합니다. Claude는 입력한 값을 그대로 보내며 인증 스킴을 덧붙이지 않습니다(Claude docs). 저장하면 값은 숨겨집니다.
  6. 채팅에서 켭니다. 채팅 입력창에서 + → Connectors를 선택하고 EveryInfra를 활성화합니다. 그런 다음 이렇게 요청해 보세요. "이번 주 Claude Code 관련 TikTok 동영상 중 조회수가 가장 높은 20개를 찾아서 조회수, 좋아요 수, 게시일을 표로 정리해 줘."
Claude 문서의 Enter the full header value 섹션 스크린샷입니다. 청록색 상자에는 Claude가 입력한 값을 그대로 보내며 인증 스킴이나 접두사를 추가하지 않으므로 Authorization 헤더에는 스킴을 포함해야 한다는 내용이 있습니다. 표에는 Bearer your-token은 Authorization: Bearer your-token으로, your-token만 입력하면 Authorization: your-token으로 전송된다고 나와 있습니다.
10월 25일에 캡처한 Claude 문서의 "Enter the full header value" 섹션입니다. 값은 입력한 그대로 전송되며, Claude는 Bearer를 붙이지 않습니다. Claude 문서: 디렉터리에 없는 커넥터 추가하기

인증 설정은 나중에 수정할 수 없습니다. 키를 바꾸려면 커넥터를 삭제하고 다시 추가하세요. Team 및 Enterprise 요금제에서는 헤더가 하나의 공유 자격 증명이므로 모든 구성원의 호출이 같은 EveryInfra 계정으로 과금됩니다. 대화상자에 Request headers 섹션이 없다면 아래의 Claude Code 또는 API 방식을 사용하세요.

Claude Code에 EveryInfra 추가하기

bash
export EVERYINFRA_API_KEY="<API key>"
claude mcp add --transport http everyinfra https://api.everyinfra.com/mcp \
  --scope user \
  --header 'Authorization: Bearer ${EVERYINFRA_API_KEY}'
claude mcp get everyinfra
  • 작은따옴표를 그대로 두세요. 셸이 변수를 확장하지 않아 설정에는 변수 이름이 저장되고, Claude Code가 요청 시점에 값을 채웁니다(Claude Code MCP docs). ANTHROPIC_API_KEY 같은 이름은 재사용하지 마세요. Claude Code는 원격 서버로 헤더를 보낼 때 자체 자격 증명 이름을 빈 값으로 읽습니다.
  • --scope user를 지정하면 모든 프로젝트에서 서버를 사용할 수 있습니다. 팀에서는 --scope project를 사용하세요. 항목이 저장소 루트의 .mcp.json에 기록되며, 각자 자신의 변수를 설정합니다.
  • Claude Code는 기본적으로 원격 요청마다 최대 60초를 기다립니다. 대용량 작업이나 오래 걸리는 작업에는 "mode": "async"를 전달한 뒤 everyinfra_get_job으로 결과를 무료로 조회하세요. MCP_TOOL_TIMEOUT=180000으로 Claude Code를 시작하는 방법도 있습니다.

Claude API로 EveryInfra 호출하기

bash
curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: mcp-client-2025-11-20" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-opus-5-5",
    "max_tokens": 2000,
    "messages": [{"role": "user", "content": "Search Amazon for usb c hub and list title, price, rating and review count for 5 results"}],
    "mcp_servers": [{"type": "url", "url": "https://api.everyinfra.com/mcp", "name": "everyinfra", "authorization_token": "<EveryInfra API key>"}],
    "tools": [{"type": "mcp_toolset", "mcp_server_name": "everyinfra",
      "default_config": {"enabled": false},
      "configs": {"everyinfra_list_capabilities": {"enabled": true}, "everyinfra_call_api": {"enabled": true}, "everyinfra_get_job": {"enabled": true}}}]
  }'

커넥터는 authorization_token을 Bearer 토큰으로 보내며, 이는 EveryInfra가 요구하는 헤더 형식입니다. MCP 커넥터는 베타이며 도구 호출만 지원합니다(Claude API docs). 이 허용 목록은 읽기 도구 3개만 노출하고 나머지 22개는 숨깁니다.

25개 도구 중 무엇을 활성화할까

  • 데이터: everyinfra_list_capabilities(플랫폼, 액션, 파라미터), everyinfra_call_api(TikTok 검색, Instagram 프로필, Amazon 검색 등 모든 데이터 기능), everyinfra_get_job(비동기 결과, 무료).
  • 검색과 CAPTCHA: 17개 도구를 제공하는 everyinfra_search(검색 API), 52개 유형을 지원하는 everyinfra_list_captcha_types와 everyinfra_solve_captcha(호출당 과금).
  • 사용 금액: everyinfra_account, everyinfra_usage, everyinfra_billing, everyinfra_requests는 무료입니다. Claude에게 "이번 주에 얼마 썼어?" 또는 "방금 호출은 과금됐어?"라고 물어보세요.
  • 계정 변경: 키, 웹훅, 알림 설정의 생성, 비활성화, 삭제. 데이터만 읽는다면 Claude 커넥터 설정에서 이 도구들을 Blocked로 설정하거나, Claude Code 권한에서 mcp__everyinfra__everyinfra_key_delete 같은 도구 이름을 거부하세요.

오류와 과금

  • 키 누락, 잘못된 키, 비활성화된 키: unauthorized, 과금 없음.
  • 알 수 없는 파라미터 또는 잘못된 값: unknown_param 또는 유효한 옵션과 예시가 담긴 값 오류, 과금 없음.
  • 데이터 없음: empty_result_refunded로 표시된 빈 결과, 예약된 금액 반환.
  • 기능 일시 사용 불가: 사용 불가로 표시되며 과금 없음. 실시간 상태는 상태 페이지에서 확인할 수 있습니다.
  • 잔액 부족: 충전 안내, 과금 없음. everyinfra_topup_link는 콘솔 링크만 반환하며, 결제는 계정 소유자가 합니다.

환불 정산 방식은 실패 환불과 정산에서 확인하세요.

매일 키워드 30개를 조회하면 비용은 얼마일까

10월 22일 카탈로그 가격 기준입니다(요금 페이지가 최종 기준):

  • TikTok 검색, 키워드 30개를 30일간 하루 한 번: 900회 호출 × $0.000556 = $0.50.
  • 같은 키워드 30개로 Amazon 검색: 900회 호출 × $0.001389 = $1.25.
  • 합계 $1.75. 실패한 호출과 빈 결과는 과금되지 않으므로 실제 금액은 이보다 높아지지 않습니다. Claude 요금제나 API 사용료는 Anthropic이 별도로 청구합니다.

직접 URL, Smithery 프록시, 로컬 서버 비교

  • Smithery 프록시: Smithery 계정과 키가 필요하며, 10월 31일에 중단됩니다.
  • 직접 원격 URL(이 가이드): 설치할 것이 없습니다. 키는 Claude 커넥터 설정이나 로컬 설정에 저장됩니다. 요청은 제3자 중계 없이 EveryInfra로 바로 전달됩니다. Claude의 웹 커넥터는 Anthropic 클라우드에서 연결하므로 서버가 공개 인터넷에서 접근 가능해야 하며, EveryInfra 서버는 이 조건을 충족합니다.
  • 로컬 stdio 서버 또는 데스크톱 확장: 로컬 파일과 내부 도구에 적합합니다. EveryInfra는 원격 URL만 제공하며 로컬 패키지는 없습니다.
나란히 놓인 세 개의 레인을 그린 일러스트로, 각 레인은 왼쪽의 클라이언트 창에서 시작합니다. 뒤쪽 레인은 차단기가 내려간 회색 중계 부스를 지나며, 그 뒤의 케이블은 점선으로 끊어집니다. 가운데 레인은 청록색 케이블 하나가 구름 위의 서버까지 곧게 이어집니다. 앞쪽 레인은 노트북 옆에 작은 로컬 박스가 아주 짧은 케이블로 연결되어 있으며, 모두 책상 위에 있습니다.
세 가지 연결 방식: 제3자 프록시 경유(10월 31일 이후 차단), 원격 URL에 직접 연결, 내 컴퓨터의 서버.

이 테스트의 한계: 웹용 Claude의 설정 단계는 Anthropic 문서를 따랐으며, 로그인한 브라우저에서 소요 시간을 측정하지는 않았습니다. 측정한 것은 Claude Code와 원본 MCP 요청입니다. 새 사양에서 바뀌는 점은 2026 MCP 사양 이후 확인할 사항에서 다룹니다.

2026년 9월과 10월에 달라진 점

  • 10월 31일: Smithery가 프록시, 계정, API 키 서비스를 종료하고 공개 디렉터리만 유지합니다(공지). 제3자 집계에 따르면 Smithery에 등록된 서버는 26,000개가 넘습니다(ScaleKit, 10월 13일). 이 서버들을 프록시 URL로 사용 중이라면 그 전에 전환해야 합니다.
  • 10월 14일: Claude Code 2.1.299에서 OAuth 로그인과 토큰 갱신 시 설정한 헤더가 전송되지 않던 문제가 수정되었습니다. 2.1.292(10월 6일)부터는 claude -p가 첫 턴 전에 원격 resources/list를 기다리지 않습니다. 2.1.265(9월 8일)부터는 --transport http로 구형 SSE 전송 방식만 지원하는 서버에도 연결할 수 있습니다(변경 내역). 실제로는 모든 원격 서버에 --transport http를 쓰면 됩니다.
  • 9월 25일: Claude가 디렉터리 등록 신청 포털을 열었습니다. 신청한 서버는 검증과 안전성 검사를 거치며, 게시된 항목에는 설치 수와 검색어 분석이 제공됩니다. 같은 글에 따르면 Claude는 흔히 MCP 2.0으로 불리는 MCP 2026-07-28의 스테이트리스 코어를 지원합니다(Claude 글). 디렉터리 등록은 심사를 기다려야 하지만, 사용자 지정 커넥터는 지금 바로 쓸 수 있습니다.
  • 10월 22일, 자체 관찰: Claude Code 2.1.299는 2026-07-28에 추가된 탐색 메서드인 server/discover로 원격 연결을 시작합니다(사양 변경 내역). 서버가 이를 지원하지 않으면 Claude Code는 initialize를 사용합니다. MCP 서버를 운영한다면 로그에 이 요청이 찍힐 것입니다.
  • 디렉터리와 전송 계층이 분리되고 있습니다. 10월 31일 이후 Smithery는 URL을 등록만 하고 트래픽을 중계하지 않습니다. MCP Registry의 EveryInfra 항목에는 이미 직접 URL과 Authorization 헤더 형식이 기록되어 있습니다.

FAQ

Claude에서 EveryInfra를 쓰려면 Smithery 대안이 필요한가요? 필요 없습니다. Smithery는 EveryInfra로 요청을 중계했을 뿐입니다. Claude에 https://api.everyinfra.com/mcp와 키를 지정하면 되며, EveryInfra 계정, 키, 잔액은 그대로입니다.

Claude 사용자 지정 커넥터에서 OAuth 대신 API 키를 쓸 수 있나요? 네. No sign-in을 선택하고, 값이 Bearer 와 키로 이루어진 Authorization 요청 헤더를 추가하세요. 계정에 해당 섹션이 없다면 Claude Code나 API를 사용하세요.

Claude Code에 Connected라고 나오는데 왜 호출이 unauthorized로 실패하나요? EveryInfra는 키 없이도 도구 목록을 보여 주므로 키가 없어도 Connected로 표시됩니다. Claude Code를 실행하는 터미널에 변수가 설정되어 있는지, 그리고 Claude Code가 빈 값으로 읽는 이름이 아닌지 확인하세요.

함께 읽을 글

참고 LF-17