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를 호출하도록 생성합니다.