MCP 서버
MCP 서버
임의의 Model Context Protocol 클라이언트(Claude Desktop, Claude Code, Cursor, Windsurf, VS Code)에서 FourA를 4개의 네이티브 도구 및 6개의 워크플로 프롬프트로 사용하세요. 연동 코드나 커스텀 HTTP 클라이언트가 필요 없습니다.
GitHub에서 오픈 소스로 제공되며, npm에서는 @fouradata/mcp 패키지로 제공됩니다. 현재 릴리스: 0.8.3.
빠른 시작: 로컬 stdio (Claude Desktop 권장)
foura.ai/dashboard#api-keys에서 키를 발급받으세요 (원클릭, 형식 pk_live_..., Reveal을 통해 나중에 키를 다시 확인할 수 있습니다). MCP 클라이언트 설정에 다음 내용을 추가하세요:
{
"mcpServers": {
"foura": {
"command": "npx",
"args": ["-y", "@fouradata/mcp"],
"env": { "FOURA_API_KEY": "pk_live_..." }
}
}
}
Claude Desktop 주의사항: 설정 파일을 수정하기 전에 Claude Desktop을 완전히 종료하세요(macOS에서는
Cmd+Q). 앱이 실행 중인 상태에서 종료되면 메모리에 로드된 설정으로 수정 사항을 덮어씁니다.
npx 명령은 첫 실행 시 @fouradata/mcp 항목을 다운로드하고 MCP 클라이언트의 하위 프로세스로 실행합니다. 전역 설치는 필요하지 않습니다.
| 클라이언트 | 설정 파일 위치 |
|---|---|
| Claude Desktop (macOS) | ~/Library/Application Support/Claude/claude_desktop_config.json |
| Claude Desktop (Windows) | %APPDATA%\Claude\claude_desktop_config.json |
| Claude Code | claude mcp add foura -- npx -y @fouradata/mcp (먼저 환경 변수에 FOURA_API_KEY 설정) |
| Cursor | ~/.cursor/mcp.json |
| Windsurf | ~/.codeium/windsurf/mcp_config.json |
| VS Code (MCP 확장) | .vscode/mcp.json, mcpServers 대신 최상위 servers 키 아래에 위치 |
클라이언트를 재시작하세요. 도구(foura_auto, foura_single, foura_proxy, foura_browser)와 6가지 프롬프트가 도구 목록에 표시됩니다.
빠른 시작: 호스팅 방식 (Streamable HTTP)
Streamable HTTP 전송을 지원하는 클라이언트(Cursor, Windsurf, VS Code, --transport http가 설정된 Claude Code)의 경우, 로컬 하위 프로세스를 실행하는 대신 호스팅된 엔드포인트를 지정하세요.
{
"mcpServers": {
"foura": {
"url": "https://mcp.foura.ai/mcp",
"headers": {
"Authorization": "Bearer pk_live_..."
}
}
}
}
Claude Desktop의 경우 위의 stdio 설정을 사용하거나 mcp-remote를 통해 호스팅된 엔드포인트를 브리지하십시오:
{
"mcpServers": {
"foura": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://mcp.foura.ai/mcp", "--header", "Authorization: Bearer pk_live_..."]
}
}
}
호스팅 endpoint 레퍼런스
| 속성 | 값 |
|---|---|
| URL | https://mcp.foura.ai/mcp |
| 전송 방식 | 스트리밍 가능한 HTTP (POST /mcp, SSE 응답) |
| 인증 | 요청당 Authorization: Bearer pk_live_.... Authorization 내 단순 키 또는 X-API-Key: pk_live_...도 지원 |
| MCP-Protocol-Version | @modelcontextprotocol/sdk 기준 (현재 2025-11-25, 2025-06-18, 2025-03-26, 2024-11-05, 2024-10-07) |
| 401 챌린지 | WWW-Authenticate: Bearer realm="foura-mcp" |
401 챌린지에는 의도적으로 RFC 9728 resource_metadata 파라미터가 포함되지 않습니다. 이를 알리면 OAuth 지원 클라이언트가 이 서버에서 구현되지 않은 플로우를 시작하게 됩니다. pk_live_ 키를 Bearer 토큰으로 전송하면 401 오류가 해결됩니다.
호스팅 서버는 stateless입니다. 모든 요청은 자체 키를 포함하며, 서버는 이를 X-API-Key로 FourA API에 전달합니다. 키 하나로 4개 도구를 모두 사용할 수 있습니다.
DNS 리바인딩(CVE-2025-66414) 방지를 위해 서버는 Host 헤더(mcp.foura.ai 또는 localhost여야 함)와 존재하는 경우 Origin 헤더(허용 목록: mcp.foura.ai, claude.ai, app.cursor.sh, app.cursor.com)를 검증합니다. 서버 간 호출자(curl, stdio 브리지 모드의 MCP 클라이언트)는 Origin를 보내지 않으며 그대로 통과합니다.
도구
4개 도구 모두 MCP 2025-06-18 규격에 따라 readOnlyHint: true 및 openWorldHint: true 주석이 지정되어 있습니다. 신뢰할 수 있는 읽기 전용 도구를 자동 승인하는 클라이언트는 요청별 확인 모달 없이 이를 호출합니다.
foura_auto는 스마트 기본값입니다. URL을 전달하면 가져오기 방식을 자동으로 선택하여 콘텐츠를 반환합니다. 나머지 3개는 이를 구성하는 하위 프리미티브이며, 명시적인 제어가 필요할 때 사용합니다.
foura_auto
FourA가 요청 방식을 직접 선택하도록 하려면 URL을 전달하세요. 사용 가능한 HTTP, proxy 및 브라우저 경로에서 제한된 횟수의 시도를 수행합니다. 보호된 대상에 대해서는 validate를 전달하여 응답에 실제 페이지를 식별할 수 있는 콘텐츠가 포함되도록 하세요. 어떤 시도도 검증을 충족하지 못하면 도구는 챌린지 페이지를 성공으로 처리하지 않고 오류를 반환합니다.
응답에는 meta의 완료 세부 정보와 기본적으로 proxy, cookies, userAgent가 포함된 재사용 가능한 session가 포함됩니다. 일반 후속 작업의 경우 session.proxy를 proxy로 지정하여 foura_single를 호출하고, 쿠키를 Cookie 헤더로 직렬화한 후 session.userAgent를 User-Agent 헤더로 전송하세요. JavaScript 렌더링의 경우 세션 값을 일치하는 foura_browser 필드에 전달하세요.
표준 풀이 페이지에 접근할 수 없을 때 Auto가 프리미엄 출구로 승격하도록 하려면 exitClass: "premium"을(를) 설정하십시오. exitClass: "standard"을(를) 지정하거나 필드를 비워 두면 모두 Auto가 표준 풀에 유지되며, 클래스를 지정한 요청만 exitClass을(를) 반환받습니다. 이는 foura_proxy에서와 동일하게 작동합니다. 강제 지시가 아닌 허용 한도로 적용되고, 요금제의 프리미엄 트래픽으로 차감되며, 프리미엄 출구가 없는 요금제에서는 code: "plan_limit_premium" 오류로 거부됩니다. 결과의 exitClass 항목은 전달된 클래스를 나타냅니다. Smart Fetch의 exitClass를 참고하십시오.
foura_single
단일 HTTP request 및 response를 반환합니다. POST /api/single/와(과) 1:1로 매핑됩니다.
정적 페이지, JSON API, 서버 렌더링 HTML에 사용하십시오.
제시할 브라우저 선택
request는 기본적으로 최신 Google Chrome을 제시합니다. 대상 사이트가 특정 브라우저만 허용하고 다른 브라우저를 거부하는 경우, browser(Chrome, Edge, Safari, Firefox 또는 Tor), os(Windows, macOS, Android 또는 iOS), version을(를) 설정하거나 정확한 profile ID를 전달하십시오.
{
"method": "GET",
"url": "https://example.com",
"browser": "Firefox",
"os": "Windows"
}
여러 프로필이 일치할 경우 최신 버전이 우선 적용됩니다. 존재하지 않는 조합은 사용 가능한 목록이 포함된 오류를 반환하므로, 선택하지 않은 브라우저로 request가 전송되지 않습니다. 프로필을 선택하려면 기본적으로 활성화되어 있는 unblocker이(가) 필요합니다. 카탈로그는 GET /api/profiles에 게시되어 있으며 API key가 필요하지 않습니다.
동일한 네 개의 필드가 foura_proxy의 request 객체 내에 위치합니다.
foura_proxy
자동 재시도 기능이 포함된 순환 proxy를 통해 단일 HTTP request를 라우팅합니다. foura_single이(가) 차단되었거나 대상에서 특정 출구 국가를 요구할 때 사용합니다.
사용자 또는 대상 요구 사항에 따라 제공된 2자리 대상 가시 국가 코드의 엄격한 허용 목록으로 exitCountries을(를) 설정합니다.
{
"maxTries": 5,
"exitCountries": ["CZ", "GB"],
"request": {
"method": "GET",
"url": "https://example.com/pricing",
"browser": "Chrome",
"os": "Windows"
}
}
값은 공백이 제거되고 대문자로 변환되며 중복이 제거됩니다. 국가를 알 수 없는 standard pool exit는 제외되며, standard pool은 요청되지 않은 국가로 절대 폴백하지 않습니다. 프리미엄 exit 역시 목록 내에서 유지됩니다. exitClass: "premium"를 사용하면 standard pool이 먼저 시도되며, 프리미엄 exit는 지정된 국가 중 하나에서 시작되고 exitCountry에 해당 국가가 명시됩니다. 선택 과정에는 대개 10분 이내에 업데이트되는 대상 기준의 최신 가용 국가 메타데이터가 사용됩니다. 이는 요청 중 실시간으로 수행되는 지리적 위치 조회가 아닙니다. proxy 호스트 주소로부터 서빙 국가를 추론하지 마십시오.
범위 지정이 적용되어 성공하면 exitCountry 및 재사용 가능한 proxy ID가 반환됩니다. exitCountry가 요청된 허용 목록에 속하는지 확인하십시오. 현재 pool에 일치하는 항목이 없으면 도구는 details.exitCountries에 정규화된 범위를 포함하여 code: "no_eligible_proxy"을 반환합니다. 해당 범위를 유지하고 나중에 다시 시도하십시오. 사용자가 명시적으로 요구 사항을 변경할 때만 범위를 변경하거나 확장하십시오. 국가 범위 지정은 Startup 플랜 이상부터 포함됩니다. 해당 기능이 없는 플랜에서 exitCountries를 전송하는 호출은 403 및 X-FourA-Limit: plan_limit_feature와 함께 거부됩니다.
선택된 페이지에 나중에 JavaScript가 필요한 경우, 반환된 proxy ID를 foura_browser.proxy에 전달하여 브라우저가 동일한 exit를 재사용하도록 하십시오.
아무리 많은 exit를 시도해도 standard pool이 도달할 수 없는 대상에는 exitClass: "premium"을 설정하십시오. 이는 강제 명령이 아닌 허용 설정입니다. standard pool이 여전히 응답을 우선 시도하며 보통 먼저 처리되므로, 프리미엄 exit를 시도하기 전에 standard pool이 응답한 요청에 대해서는 프리미엄 트래픽 요금이 발생하지 않습니다. 프리미엄 시도는 실패하더라도 사용된 트래픽을 집계합니다. 응답은 exitClass로 premium 또는 standard을 반환하므로, 요청별로 어떤 클래스가 처리했는지 확인할 수 있습니다. standard은 플랜에 포함된 프리미엄 트래픽을 모두 소진했을 때도 반환되며 오류가 아닌 정상적인 결과입니다. exitClass: "standard"는 에스컬레이션을 완전히 금지합니다. 프리미엄 exit가 없는 플랜에서 exitClass: "premium"을 설정하면 code: "plan_limit_premium"와 함께 거부됩니다. exitClass를 참고하십시오.
응답을 얻기 위해 로테이션이 다른 브라우저로 전환되어야 했던 경우, 성공 응답에는 최종 선택된 카탈로그 프로필 ID인 profile가 포함됩니다. 다음 호출에서 profile으로 이를 전달하여 동일한 브라우저를 사용할 수 있습니다.
로테이션 실패 시에는 오류 옆에 attemptReport이 함께 전달됩니다. 여기에는 summary 문장 하나와 함께 응답이 전혀 없었던 exit(noResponse), 봇 검사로 거부된 exit(defense, vendors에 공급업체 명시), 도달했으나 사용자가 설정한 validate.data에 의해서만 거부된 페이지(contentRejected), statusRejected 및 other에 대한 구분된 집계가 포함됩니다. profilesTried은 작업이 전송한 브라우저 목록을 최초 사용 순서대로 나열하며, default은 요청이 작성된 그대로 나갔음을 의미합니다. contentRejected 값이 높다면 FourA가 실제 페이지를 전달했으나 사용자의 자체 규칙이 이를 폐기했음을 의미합니다. Why a Proxy Request Ran Out of Tries를 참고하십시오.
foura_browser
전체 브라우저 세션입니다. JavaScript가 실행되고, DOM이 렌더링되며, cookie가 반환됩니다. POST /api/browser/를 그대로 미러링합니다.
단일 페이지 애플리케이션(SPA), 지연 로딩 콘텐츠, 또는 완료를 위해 실제 브라우저가 필요한 검사가 포함된 페이지에 사용합니다.
각 툴의 입력 형태, 기본값, 유효성 검사 규칙은 REST 엔드포인트 참조 문서를 확인하세요. 툴 스키마는 REST API 및 MCP 전용 offload_large 옵트인(아래 참조)과 일치하지만, 두 가지 예외가 있습니다. foura_browser에는 lean 필드가 없으며, foura_proxy에는 아직 exit location 필드가 없습니다. 해당 이름으로 전송된 값은 API에 전달되지 않습니다. 이를 설정하려면 POST /api/browser/ 또는 POST /api/proxy/를 직접 호출하세요.
대상 사이트가 봇 검사를 실행할 때
foura_single 및 foura_proxy는 대상 사이트가 본문으로 가는 도중 봇 검사를 실행한 경우 defense를 반환합니다. defense.solved: true는 검사를 통과했으며 data가 실제 페이지임을 의미합니다. false는 본문이 챌린지 페이지일 수 있음을 의미합니다. 챌린지 페이지를 콘텐츠로 처리하는 대신 다른 브라우저, os, 버전으로 재시도하거나 foura_proxy 또는 foura_browser로 단계를 올리세요.
타입이 지정된 응답
모든 툴 응답에는 content(사람이 읽을 수 있는 텍스트 요약)와 structuredContent(툴의 outputSchema에 대해 유효성이 검증된 타입 지정 JSON)가 모두 포함됩니다. 각 툴은 고유한 형태를 갖습니다.
foura_auto: 단일 형태의{ status, headers, data }및meta(항상 존재하는{ rung, solved, attempts, credits, attemptsByEngine, browserRequests }. 여기서rung는cache,probe,proxy,browser,warmup,fail중 하나), 그리고 하위 수준 툴을 통한 재생을 위한session(기본값{ proxy, cookies, userAgent }). 클래스를 지정한 request에는exitClass도 포함됩니다.meta.attemptsByEngine는 호출이 Single, Proxy, Browser로 보낸 request 수를 집계하며,meta.browserRequests는 일일 Browser 허용량을 사용한 횟수를 집계합니다. 실패 시에는attemptReport도 포함됩니다.total_time는 포함되지 않습니다.foura_single:{ status, headers, data, total_time, ... }(headers는 배열이며 리디렉션 홉당 하나의 항목이 들어감)foura_proxy: single과 동일하며{ proxy, total }가 추가됩니다. 범위가 지정된 성공에는exitCountry가 포함되고, 클래스를 지정한 request에는exitClass가 포함되며, 브라우저 제품군이 변경된 로테이션에는profile가 포함되고, 실패 시에는attemptReport가 포함됩니다.foura_browser: 고유 형태{ status, headers: object, body, cookies, userAgent }(참고:body는 content-type에 따라 문자열 또는 객체일 수 있음)
또한 모든 툴은 API의 response header에서 읽어온 호출 비용과 추적 방법을 보고합니다.
credits- 이 호출에 사용된 크레딧입니다. 작업은 어느 경우든 수행되었으므로 실패 시에도 표시됩니다. 요금은 성공한 호출에 대해서만 청구되므로, 실패 시 크레딧이 여기에 표시되더라도 비용은 청구되지 않습니다.request_id- FourA의 호출 ID입니다. 지원 요청 시 이 값을 전달하십시오.exitClass- 프리미엄 exit가 호출을 처리한 경우premium입니다.foura_single및foura_browser에서는proxy가foura_proxy또는foura_auto에서 찾은 프리미엄 exit를 재생할 때 발생합니다.
API가 아무것도 반환하지 않은 경우 각 항목은 생략되므로, 이전 버전을 기준으로 작성된 클라이언트도 변경 없이 그대로 작동합니다. 동일한 값들이 Response Headers에 문서화되어 있습니다.
structuredContent를 지원하는 클라이언트는 LLM이 텍스트에서 JSON을 파싱하도록 요구하는 대신 타입이 지정된 객체를 직접 전달할 수 있습니다.
다중 값 응답 헤더
여러 번 나타나는 헤더(Set-Cookie, Link, WWW-Authenticate)는 배열로 반환됩니다.
{
"headers": [
{
"result": { "version": "HTTP/2", "code": 200, "reason": "" },
"content-type": "text/html",
"set-cookie": ["a=1; Path=/", "b=2; Path=/"]
}
]
}
단일 response에서 세션, 추적, 동의 cookie를 한 번에 설정하는 사이트(대부분의 전자상거래 사이트)에서 중요합니다.
대용량 response: offload_large (기본값: inline)
기본적으로(v0.2.0부터) 크기와 관계없이 전체 response body가 structuredContent에 인라인으로 반환됩니다. 이는 모든 MCP client에서 별도 설정 없이 바로 작동합니다.
사용 중인 client가 MCP resources/read를 지원하고 대형 페이지에서 token을 절약하려는 경우, 각 도구 호출마다 offload_large: true를 전달하십시오. 그러면 50 KB 이상의 response는 디스크에 기록되어 resource_link 형식으로 반환되며, client는 실제로 필요할 때만 body를 가져옵니다. 호스팅 서버에서 캐시된 payload는 1시간 후 만료됩니다. 자체 인스턴스에서는 저장된 payload가 자동으로 삭제되지 않으므로, payload 디렉터리에서 1시간이 지난 파일을 직접 정리하십시오.
오프로드된 결과에는 body 대신 offloaded_resource_uri 및 size_bytes가 포함됩니다. 또한 오프로드된 결과는 defense 및 foura_proxy의 profile를 생략하므로, 해당 필드를 읽는 호출에서는 offload_large를 건너뛰십시오.
{
"method": "GET",
"url": "https://en.wikipedia.org/wiki/Web_scraping",
"offload_large": true
}
| 클라이언트 | offload_large: true |
|---|---|
| Claude Desktop | 아직 지원 안 됨, 기본값 false 유지 |
| Claude Code, Cursor, Windsurf | 지원됨 |
| VS Code MCP 확장 | 지원됨 |
테넌트 격리: 각 API 키는 자체 네임스페이스(sha256(apiKey)[:16])를 가집니다. 페이로드를 저장한 키만 해당 페이로드를 다시 읽을 수 있습니다. 테넌트 간 읽기는 존재 여부 유출 없이 Payload not found을 반환합니다.
기본 제공 프롬프트
모든 MCP 클라이언트의 /prompts 아래에 6개의 워크플로 템플릿이 표시됩니다. 각 템플릿은 명명된 인수를 받아 하나 이상의 도구를 조율하는 템플릿화된 사용자 메시지를 반환합니다.
| 프롬프트 | 인수 | 동작 설명 |
|---|---|---|
smart_fetch |
url, 선택 사항 must_contain, extract |
자동 가져오기(방법 선택, 봇 보호 처리) 후 콘텐츠 반환 또는 추출 |
scrape_product_page |
url |
브라우저 가져오기 후 상품명, 가격, 이미지, 재고, SKU를 JSON으로 추출 |
extract_article |
url |
프록시 폴백을 포함한 단일 가져오기 후 네비게이션/광고를 제거하고 정제된 기사 JSON 반환 |
monitor_pricing |
url, 선택 사항 target_price |
프록시 가져오기, 현재 가격 추출, 목표 가격과 비교 |
check_endpoint_health |
url, 선택 사항 expected_text |
엄격한 유효성 검사를 거친 단일 가져오기, 접근 가능 여부 및 소요 시간 반환 |
bulk_fetch_urls |
urls (쉼표로 구분) |
병렬 단일 가져오기, URL별 프록시 자동 폴백, 메타데이터만 반환 |
프롬프트는 유휴 상태에서 토큰을 소모하지 않습니다. 호출된 프롬프트만 LLM 컨텍스트에 포함됩니다.
전체 텍스트 및 수동 폴백 프롬프트: MCP 레시피.
오류 엔벨로프
모든 오류(isError: true)에는 structuredContent 엔벨로프가 포함됩니다. 모든 오류의 최소 필드는 다음과 같습니다.
{
"service": "auto | single | proxy | browser",
"code": "rate_limited",
"error": "Rate limit exceeded"
}
HTTP 상태 코드가 있는 업스트림 오류에서는 status도 제공됩니다. rate limit 및 용량 오류의 경우, 업스트림 엔벨로프에 retryAfter, current.{concurrency, rpm}, limits.{maxConcurrency, maxRpm}이 추가됩니다. 기본 REST 형태는 API Errors를 참고하십시오.
안정적인 code 값:
| 코드 | HTTP | 의미 | 재시도 안전 여부 |
|---|---|---|---|
ssrf_blocked |
해당 없음 | 대상이 프라이빗 또는 예약 주소(RFC 5735, 6598, IPv6 예약)이거나, URL이 http(s)가 아니거나, 호스트 이름이 확인되지 않음 | 불가, URL 확인 필요. 일시적으로 실패한 조회는 재시도 가능 |
upstream_non_json |
다양함 | 업스트림에서 잘못된 형식의 본문을 반환함 | 재시도 가능성 있음, 원인 조사 필요 |
output_validation_failed |
해당 없음 | MCP 서버의 outputSchema이(가) 업스트림 응답을 거부했거나, 도구가 호출을 전혀 완료하지 못함(API 키 미구성, API 연결 불가) |
재시도 가능성 있음: 설정 확인 후 보고 |
bad_request |
400 | 입력 형태가 거부되었거나, 대상 URL이 페이지 대신 FourA 자체 API를 가리키거나(해당 위치에서는 /inspect만 가져올 수 있음), URL 내부에 인코딩되지 않은 공백이 포함됨(%20(으)로 인코딩 필요) |
불가, 인자 수정 필요 |
auth_failed |
401 | 키가 누락되었거나, 유효하지 않거나, 비활성화됨 | 불가, 키 수정 필요 |
forbidden |
403 | 대상이 403으로 응답했고 validate이(가) 이를 거부함(사이트 확인, 국가 제한) |
불가, 또는 foura_proxy(으)로 전환 |
not_found |
404 | 대상 또는 endpoint가 누락됨 | 불가 |
rate_limited |
429 | RPM 한도 초과 | 가능, retryAfter 대기 |
at_capacity |
503 | 동시성 한도를 초과했거나, 유지보수를 위해 서비스가 꺼짐(error 값이 Service disabled임) |
가능, retryAfter 대기 |
service_disabled |
503 | 예약됨. 현재 유지보수를 위해 꺼진 서비스는 at_capacity(으)로 반환되며, 플랜에 포함되지 않은 도구는 plan_limit_feature(으)로 반환됨 |
고객 지원팀 문의 |
service_unavailable |
503 | 일반적인 503 오류 | 가능, 짧은 대기 후 재시도 |
upstream_error |
500+ 또는 0 | 대상이 서버 오류로 응답했거나, foura_proxy의 경우 foura_browser 및 foura_auto이(가) 응답하지 않음 |
가능, 지수 백오프 적용 |
upstream_client_error |
4xx | 기타 4xx | 대개 불가 |
upstream_unknown |
기타 | 요청이 실행되었으나 허용된 응답을 생성하지 못함: foura_single의 경우 대상이 응답하지 않았으며(타임아웃, 연결 거부), 모든 도구에서 validate이(가) 2xx 또는 3xx 응답을 거부함. status 및 error 참조 |
원인 조사 필요 |
no_eligible_proxy |
해당 없음 | 엄격한 exitCountries 범위와 일치하는 프록시가 없음 |
나중에 재시도; 명시적으로만 범위 변경 |
plan_limit_* |
403 또는 429 | 플랜 제한 중 하나로 인해 호출이 거부됨: plan_limit_ 뒤에 feature, premium, concurrency, rate, browser_daily, credits 또는 bandwidth이(가) 이어짐. MCP Server Errors 참조 |
retryAfter이(가) 있는 경우 대기; 그렇지 않다면 제한이 리셋되거나 플랜이 변경될 때까지 불가 |
LLM agent는 텍스트를 파싱할 필요 없이 재시도 로직을 위해 code 값을 직접 읽을 수 있습니다. 인증 가이드: Authentication.
제한 사항
- 기본적으로 body는 인라인으로 전달됩니다.
offload_large: true사용 시, 50 KB 이상의 response는 디스크 및resource_link에 저장됩니다 (테넌트별, 1시간 TTL). - 비공개 대상(RFC 5735, RFC 6598, IPv6 예약 블록)은 MCP 계층에서 거부됩니다. 공개 host만 전달됩니다.
- 수신되는
/mcprequest에 대한 request body 한도는 256 KB입니다 (실제 MCP 페이로드는 4 KB 미만). - Rate limit은 서비스별 FourA API에 의해 적용됩니다. Rate Limits를 참고하십시오.
자체 호스팅
전체 서버 소스는 @fouradata/mcp 라이선스 하에 GitHub에 공개되어 있습니다. 리포지토리를 클론하고 npm install, npm run build 후 node dist/http.js를 실행하여 자체 인스턴스를 구축할 수 있습니다. 로드 밸런서 뒤에서 단일 컨테이너로 상태 비저장(stateless) 방식으로 실행됩니다.
설정 가능한 환경 변수:
| 변수 | 기본값 | 용도 |
|---|---|---|
PORT |
3076 |
HTTP 수신 포트 |
FOURA_API_BASE |
https://api.foura.ai/api |
업스트림 FourA REST 기본 URL |
FOURA_MCP_PAYLOADS_DIR |
시스템 임시 디렉터리 내 foura-mcp-payloads 폴더 (번들된 Docker Compose 파일은 /data/payloads 설정) |
50 KB 이상의 response가 디스크에 캐시되는 경로 (offload_large: true 사용 시) |
FOURA_MCP_ALLOWED_HOSTS |
mcp.foura.ai,localhost,127.0.0.1,[::1] |
Host 헤더 허용 호스트명 목록 (DNS 리바인딩 방어) |
FOURA_MCP_ALLOWED_ORIGINS |
https://mcp.foura.ai,https://claude.ai,https://app.cursor.sh,https://app.cursor.com |
브라우저 호출자를 위한 Origin 허용 목록 |
공식 컨테이너는 uid 1001 (non-root)로 실행됩니다. 번들된 Docker Compose 파일은 /data/payloads를 지정된 볼륨에 유지합니다. 해당 경로의 호스트 바인드 마운트는 해당 uid가 쓸 수 있어야 합니다.
로드 밸런서 뒤에서 수평 확장이 가능합니다. 클라이언트는 모든 request마다 키를 제공하므로 sticky session이 필요하지 않습니다. offload_large 사용 시, 저장된 페이로드는 이를 작성한 인스턴스의 디스크에 상주하므로 모든 인스턴스가 공유하는 스토리지로 FOURA_MCP_PAYLOADS_DIR를 지정하십시오. GET /healthz는 ok, name 및 version로 응답하므로 로드 밸런서가 인스턴스를 프로브할 수 있습니다.