가이드
MCP 서버 연결
Claude Desktop, Cursor, Windsurf 등 AI 에이전트와 ApiFuse MCP 서버를 연동하는 방법을 안내합니다.
AI 에이전트와 즉시 연동
ApiFuse MCP 서버를 한 번 설정하면, AI 도구에서 자연어 한 마디로 409개 API를 사용할 수 있습니다.
MCP란?
Model Context Protocol — AI 에이전트가 외부 도구와 안전하게 통신하는 표준 프로토콜입니다. ApiFuse MCP 서버를 연결하면 Claude, GPT, Cursor 등이 공공·민간 API를 직접 호출할 수 있습니다.
지원 도구: Claude Desktop · Cursor · Windsurf · LangChain · CrewAI
설정 방법
~/Library/Application Support/Claude/claude_desktop_config.json 파일에 추가:
{
"mcpServers": {
"apifuse": {
"command": "npx",
"args": ["-y", "@apifuse/mcp"],
"env": {
"APIFUSE_API_KEY": "your_apifuse_key"
}
}
}
}Cursor Settings → MCP 탭에서 설정:
{
"mcpServers": {
"apifuse": {
"command": "npx",
"args": ["-y", "@apifuse/mcp"],
"env": {
"APIFUSE_API_KEY": "your_apifuse_key"
}
}
}
}Windsurf MCP 설정 파일에 추가:
{
"mcpServers": {
"apifuse": {
"command": "npx",
"args": ["-y", "@apifuse/mcp"],
"env": {
"APIFUSE_API_KEY": "your_apifuse_key"
}
}
}
}MCP 도구 3가지
ApiFuse MCP 서버는 3개의 도구를 제공합니다.
| 도구 | 설명 |
|---|---|
search_apis(query) | 자연어로 관련 API 검색. "날씨"라고 입력하면 기상청 관련 API 목록 반환 |
get_api_spec(id) | 특정 API의 OpenAPI 3.1 스펙 반환. 파라미터, 응답 스키마 확인 가능 |
list_categories() | 날씨, 금융, 지도 등 전체 카테고리 목록 반환 |
실제 사용 예시
이렇게 동작합니다
MCP 연결 후 Claude에게 "서울 날씨 알려줘" 라고 말하면:
search_apis("서울 날씨")→ 기상청 API 발견get_api_spec("kma-short-forecast")→ 파라미터 확인- API 호출 → "서울은 현재 12°C, 맑음입니다" 응답
사용자가 API를 직접 찾거나 파라미터를 지정할 필요 없이, AI가 전부 처리합니다.