MCP 엔드포인트
APIFuse의 단일 외부 MCP 엔드포인트와 런타임/개발자 도구 구성을 설명합니다.
MCP 엔드포인트
APIFuse의 외부 MCP 엔드포인트는 https://api.apifuse.com/mcp 하나입니다. 이 엔드포인트는 operation 조회/실행용 런타임 도구와 코딩 에이전트가 API를 찾고 스키마를 읽고 서버 사이드 연동 코드를 작성하도록 돕는 apifuse_dev_* 도구를 함께 제공합니다.
보호된 도구 인증
보호된 도구를 API 키 없이 호출하면 api_key_required 오류와 함께 인증 설정 방법이 반환됩니다. API 키는 Authorization: Bearer <APIFUSE_API_KEY> 헤더로 전달하세요.
MCP 클라이언트 설정 예시
Streamable HTTP 전송을 지원하는 MCP 클라이언트에서 다음 엔드포인트를 등록합니다. operation 검색, 스키마 조회, apifuse_dev_* 개발자 도구는 API 키 없이 사용할 수 있습니다. apifuse_execute_tool, apifuse_manage_connection처럼 실제 실행/연결 상태를 다루는 보호된 도구는 APIFuse API 키 Authorization이 필요합니다. 클라이언트는 같은 /mcp URL로 JSON-RPC POST 요청을 보냅니다.
{
"mcpServers": {
"apifuse": {
"url": "https://api.apifuse.com/mcp",
"transport": "http"
}
}
}런타임 도구
| 도구 | 설명 |
|---|---|
apifuse_search_tools | 사용자 목표에 맞는 provider operation 도구를 검색합니다. |
apifuse_get_tool_schema | 검색된 operation 도구들의 정확한 입력 스키마와 실행 메타데이터를 toolNames 배열로 조회합니다. |
apifuse_execute_tool | 선택한 operation 도구를 실행합니다. |
apifuse_manage_connection | operation 실행 전 계정 connection 필요 여부와 연결 흐름을 확인합니다. |
개발자 도구
개발자 도구는 apifuse_dev_* 접두어를 사용하며, 탐색·스키마 번들·생성된 아티팩트·연동 가이드만 제공합니다. 실제 provider operation 실행은 같은 엔드포인트의 런타임 실행 도구나 서버 측 게이트웨이/API 레퍼런스 경로에서 수행합니다.
- 자세한 코딩 에이전트 설정은 개발자 MCP 가이드를 확인하세요.
- 스키마 번들과 변환 경고는 스키마 번들과 변환 경고를 확인하세요.
| 도구 | 설명 |
|---|---|
apifuse_dev_list_providers | 공개 개발자 카탈로그의 provider 목록을 조회합니다. |
apifuse_dev_list_capabilities | provider·operation 태그와 기능을 조회합니다. |
apifuse_dev_search_operations | 만들고 싶은 서비스 목표로 operation을 검색합니다. |
apifuse_dev_get_operation_spec | 특정 operation의 입출력 스키마, 예시, 인증 메타데이터, 해시를 조회합니다. |
apifuse_dev_get_schema_bundle | JSON Schema, OpenAPI, TypeScript, Zod, Pydantic 아티팩트를 조회합니다. |
apifuse_dev_get_auth_setup_guide | 인증과 인가 요구사항을 정적 가이드로 조회합니다. |
apifuse_dev_get_integration_guide | Next.js, Node, FastAPI, Python 스크립트용 서버 사이드 연동 스니펫을 조회합니다. |
코딩 에이전트 워크플로
apifuse_dev_search_operations로 서비스 아이디어에 맞는 operation을 찾습니다.apifuse_dev_get_operation_spec으로 인증, 입출력, 예시를 확인합니다.apifuse_dev_get_schema_bundle로 TypeScript·Zod·Pydantic 아티팩트를 가져옵니다.apifuse_dev_get_auth_setup_guide로 서버 사이드 인증 요구사항을 확인합니다.- 앱 코드는 서버 사이드에서 APIFuse 게이트웨이 API를 호출하도록 생성합니다.