Developer MCP endpoint
Coding agent가 ApiFuse provider catalog와 schema artifact를 읽는 hosted Developer MCP endpoint입니다.
Developer MCP endpoint
ApiFuse는 Platform https://apifuse.com/api/mcp를 통해 Gateway /mcp를 제공합니다. Platform route는 thin proxy이고, 실제 MCP 구현체는 Gateway 하나입니다. 이 surface는 runtime router tool과 함께 개발자와 coding agent가 API를 찾고 schema를 읽고 server-side integration 코드를 작성하도록 돕는 read-only apifuse_dev_* tool을 제공합니다.
Developer MCP는 실행용 MCP가 아닙니다
apifuse_dev_* tool은 provider operation을 직접 실행하지 않습니다. Operation 실행은 server-side ApiFuse Gateway API 또는 Gateway MCP의 runtime execution flow를 사용합니다. Developer schema tool은 discovery, schema bundle, connection guide, integration snippet만 제공합니다.
MCP client 설정 예시
HTTP transport를 지원하는 MCP client에서 다음 endpoint를 등록합니다.
{
"mcpServers": {
"apifuse-dev": {
"url": "https://apifuse.com/api/mcp",
"transport": "http"
}
}
}로컬 개발에서는 Platform app origin을 사용합니다. apps/platform/app/api/mcp/route.ts와 Playground는 모두 Gateway /mcp를 바라봅니다.
{
"mcpServers": {
"apifuse-dev-local": {
"url": "http://localhost:3000/api/mcp",
"transport": "http"
}
}
}Developer MCP 전환 범위
Gateway MCP surface는 coding-agent integration을 위해 canonical developer artifacts를 사용합니다. Developer schema 도구는 apifuse_dev_* prefix를 사용하며 discovery, schema bundle, generated artifact, integration guide 응답만 제공합니다. 같은 tools/list에는 runtime router 도구도 함께 있을 수 있습니다.
- 자세한 coding-agent 설정은 Developer MCP guide를 확인하세요.
- schema bundle hash와 conversion warning은 Schema bundles and conversion warnings를 확인하세요.
- provider operation 실행은
apifuse_dev_*가 아니라 서버 측 Gateway/API Reference 경로나 Gateway MCP runtime execution flow에서 수행합니다.
구현체는 Gateway MCP 하나
Platform /api/mcp와 Playground는 별도 MCP 구현체가 아니라 Gateway /mcp를 호출합니다. apifuse_dev_* tool call은 read-only artifact 조회만 수행하고 provider dispatch/proxy, credential RPC client, Connection mutation API를 호출하지 않습니다.
Public docs 도구
| 도구 | 설명 |
|---|---|
apifuse_dev_list_providers | public developer catalog provider 목록을 조회합니다. |
apifuse_dev_list_capabilities | provider/operation tag와 capability를 조회합니다. |
apifuse_dev_search_operations | 만들고 싶은 서비스 목표로 operation을 검색합니다. |
apifuse_dev_get_operation_spec | 특정 operation의 input/output schema, examples, auth metadata, hash를 조회합니다. |
apifuse_dev_get_schema_bundle | JSON Schema, OpenAPI, TypeScript, Zod, Pydantic artifact를 조회합니다. |
apifuse_dev_get_auth_setup_guide | 인증과 authorization 요구사항을 static guide로 조회합니다. |
apifuse_dev_get_integration_guide | Next.js, Node, FastAPI, Python script용 server-side integration snippet을 조회합니다. |
Coding-agent workflow
apifuse_dev_search_operations로 서비스 아이디어에 맞는 operation을 찾습니다.apifuse_dev_get_operation_spec으로 auth, input/output, examples를 확인합니다.apifuse_dev_get_schema_bundle로 TypeScript/Zod/Pydantic artifact를 가져옵니다.apifuse_dev_get_auth_setup_guide로 server-side 인증과externalRefboundary를 확인합니다.- 앱 코드는 server-side에서 ApiFuse Gateway API를 호출하도록 생성합니다.
Safety boundaries
apifuse_dev_*tool은execute,invoke,connect,revoke,update,delete성격의 동작을 수행하지 않습니다.- API key와 provider credential은 server-side 환경 변수로만 사용하세요.
- canonical ApiFuse authorization identifier를 browser, prompt, client state에 노출하지 마세요.
- Developer schema tools는 default-deny catalog만 사용하며 private/internal provider는 검색 결과, count, hash, error body에도 노출하지 않습니다.