Fastly API - OpenAPI 사양
이 저장소에는 공개적으로 사용 가능한 API 문서를 리버스 엔지니어링하여 생성된 Fastly API 에 대한 포괄적이고 비공식적인 OpenAPI 3.0 사양이 포함되어 있습니다. 공식 웹 문서에 비해 상당히 향상된 설명서를 제공하며, 자세한 설명, 예시, 그리고 인간 개발자와 AI 에이전트 모두에게 최적화된 구조화된 스키마를 제공합니다.
주요 구성 요소
이 프로젝트는 Fastly API 작업을 위한 세 가지 주요 리소스를 제공합니다.
- 완전한 OpenAPI 사양 (
fastly-openapi.yaml ) - 모든 Fastly API 엔드포인트에 대한 포괄적인 OpenAPI 3.0 스키마 - AI 최적화 사양 (
fastly-openapi-mcp.yaml ) - AI 에이전트 사용에 최적화된 간소화된 하위 세트 - 모델 컨텍스트 프로토콜 서버 (
fastly-mcp-server/ ) - AI 모델이 표준화된 프로토콜을 통해 Fastly와 상호 작용할 수 있도록 하는 MCP 서버 구현
AI 통합을 위한 MCP 서버
저장소에는 NPM에서 사용할 수 있는 Fastly용 전체 MCP(Model Context Protocol) 서버가 포함되어 있습니다.
지엑스피1
이 MCP 서버를 통해 AI 어시스턴트와 에이전트는 다음을 수행할 수 있습니다.
- 자연어를 통해 Fastly 서비스와 상호 작용하세요
- CDN 구성, 캐싱 설정 및 보안 기능 관리
- 콘텐츠 정리, 통계 수집 및 서비스 배포 수행
- 표준화된 인터페이스를 통해 모든 주요 Fastly 기능에 액세스하세요
자세한 사용 예와 구성 옵션은 fastly-mcp-server 디렉토리를 참조하세요.
부인 성명
본 사양은 비공식적인 사양이며 Fastly에서 보증, 지원 또는 보장하지 않습니다. 불완전하거나 부정확한 내용이 포함될 수 있습니다. 본 사양은 어떠한 종류의 보증 없이 "있는 그대로" 제공됩니다.
특징
- Fastly의 CDN API를 위한 포괄적인 OpenAPI 3.0 스키마
- 공식 웹 문서보다 명확성과 세부성이 뛰어난 향상된 문서
- 대규모 언어 모델 및 AI 에이전트의 사용을 위해 특별히 설계된 AI 최적화 스키마
- 운영 컨텍스트와 예시를 포함한 자세한 엔드포인트 설명
- 모든 요청 및 응답 개체에 대한 완전한 스키마 정의
- 모든 주요 Fastly API 기능 지원:
- 서비스 관리
- 도메인 구성
- 백엔드 관리
- VCL 조작
- 캐시 제어
- 정화 작업
- Edge 사전
- WAF 보안
- 로깅 엔드포인트
- 통계 및 지표
- 컴퓨트@엣지
명세서
이 저장소에는 두 가지 OpenAPI 사양이 포함되어 있습니다.
fastly-openapi.yaml
모든 엔드포인트, 매개변수 및 스키마를 포함하는 Fastly API의 전체 사양입니다. 이 사양은 다음과 같습니다.
- 공식 웹 문서보다 더 철저하고 체계적인 문서를 제공합니다.
- 매개변수뿐만 아니라 사용 컨텍스트를 설명하는 자세한 설명이 포함되어 있습니다.
- 모든 작업 및 데이터 스키마에 대한 일관된 예가 포함되어 있습니다.
- 포괄적인 API 문서화 및 클라이언트 생성에 유용합니다.
fastly-openapi-mcp.yaml
AI 에이전트 상호작용을 위해 특별히 최적화된 API의 간소화된 하위 집합입니다. 이 사양은 다음과 같습니다.
- 일반적인 Fastly 작업에 가장 자주 사용되는 엔드포인트만 포함합니다.
- 일상 관리에 필요한 핵심 운영에 집중합니다.
- AI 이해를 위해 최적화된 자세한 설명과 예시를 유지합니다.
- 대화형 인터페이스에서 가장 유용한 엔드포인트를 우선시합니다.
- 일반적인 사용자 워크플로에 맞춰 작업 기반 조직을 따릅니다.
- 유용성을 극대화하면서 AI 컨텍스트의 토큰 소비를 줄입니다.
MCP 버전은 자연어 인터페이스를 통해 Fastly와 상호 작용해야 하는 AI 어시스턴트 및 도구와의 통합에 이상적입니다.
용법
문서 보기
다음과 같은 도구를 사용하여 이러한 사양에서 대화형 문서를 생성할 수 있습니다.
예:
# For the complete API
npx @redocly/cli preview-docs fastly-openapi.yaml
# For the AI-optimized subset
npx @redocly/cli preview-docs fastly-openapi-mcp.yaml
확인
사양을 검증하려면:
# For the complete API
npx @stoplight/spectral-cli lint fastly-openapi.yaml
# Or use swagger-cli
npx swagger-cli validate fastly-openapi.yaml
# For the AI-optimized subset
npx @stoplight/spectral-cli lint fastly-openapi-mcp.yaml
코드 생성
이러한 사양은 OpenAPI 코드 생성기와 함께 사용하여 다양한 프로그래밍 언어로 클라이언트 라이브러리를 생성할 수 있습니다.
# For the complete API
npx @openapitools/openapi-generator-cli generate -i fastly-openapi.yaml -g javascript -o ./client
# For the AI-optimized subset
npx @openapitools/openapi-generator-cli generate -i fastly-openapi-mcp.yaml -g javascript -o ./client-mcp
에이전트 준비 상태
두 사양 모두 AI 에이전트 및 도구와 함께 사용하도록 최적화된 "에이전트 지원" 사양으로 설계되었습니다. 기계 가독성을 위한 모범 사례를 따릅니다.
- 공식 문서보다 정보 밀도가 높은 자세한 작업 설명
- 관련 엔드포인트에서 일관된 명명 패턴
- 철저한 속성 설명이 포함된 완전한 스키마 문서
- 모든 작업 및 스키마 구성 요소에 대한 예
- 구성 요소 간의 적절하게 구조화된 참조 및 관계
MCP 버전은 다음을 통해 에이전트 준비성을 한 단계 더 높였습니다.
- 일반적인 작업을 위한 고가치 엔드포인트의 큐레이트된 선택
- 사용자 의도에 맞춰 업무 중심 조직
- 대화 맥락에 초점을 맞춘 향상된 설명
- 일상 사용에서 거의 나타나지 않는 특수 엔드포인트 제거
- AI 컨텍스트에서 토큰 소비 감소를 위해 최적화됨
MCP 사양에 대한 구체적인 사용 사례는 일반적인 대화 작업과 해당 API 워크플로를 간략하게 설명하는 subset.md를 참조하세요.
MCP 서버 사용
AI 어시스턴트 구성으로 MCP 서버를 사용하려면:
번(추천)
{
"mcpServers": {
"fastly api": {
"command": "bunx",
"args": ["fastly-mcp-server@latest", "run"],
"env": {
"API_KEY_APIKEYAUTH": "your-fastly-api-key"
}
}
}
}
노드.js
{
"mcpServers": {
"fastly": {
"command": "npx",
"args": ["-y", "fastly-mcp-server@latest", "run"],
"env": {
"API_KEY_APIKEYAUTH": "your-fastly-api-key"
}
}
}
}
참고 : Bun은 뛰어난 성능과 시작 시간으로 인해 fastly-mcp-server에 권장되는 런타임입니다.
구성 및 사용에 대한 자세한 내용은 fastly-mcp-server 설명서를 참조하세요.
자원