---
title: 로컬 MCP | RunAPI
description: Claude Code, Cursor, VS Code, Windsurf 또는 다른 stdio 클라이언트와 함께 RunAPI MCP
  서버를 로컬에서 실행합니다.
url: https://runapi.ai/ko/docs/resources/mcp/local.md
canonical: https://runapi.ai/ko/docs/resources/mcp/local
locale: ko
---

> HTML 버전: https://runapi.ai/ko/docs/resources/mcp/local
> 에이전트용 사이트 색인: https://runapi.ai/llms.txt

# 로컬 MCP

Local MCP를 사용하면 MCP 클라이언트가 사용자의 머신에서 RunAPI MCP Server를
시작할 수 있습니다. 클라이언트가 Remote MCP를 지원하지 않거나 로컬 프로세스가
명시적으로 필요한 경우 사용하십시오.

## 시작하기 전에

Node.js를 설치하고 `npx`를 사용할 수 있는지 확인하세요. MCP 클라이언트는
로컬 stdio 서버를 지원해야 합니다.

아래의 모든 클라이언트는 동일한 명령으로 시작합니다:

```shell
npx -y @runapi.ai/mcp
```

로그인하지 않고도 카탈로그 도구를 연결하고 사용할 수 있습니다.

## Claude Code

실행:

```shell
claude mcp add runapi -s user -- npx -y @runapi.ai/mcp
```

프로젝트 전반에서 RunAPI를 사용할 수 있도록 `-s user`를 사용하세요. 이미
Claude Code가 실행 중이었다면 재시작한 후 RunAPI가 MCP 서버 목록에
표시되는지 확인하세요.

## 커서

`.cursor/mcp.json` 또는 사용자 MCP 구성의 `mcpServers` 아래에 서버를 추가합니다:

```json
{
  "mcpServers": {
    "runapi": {
      "command": "npx",
      "args": ["-y", "@runapi.ai/mcp"]
    }
  }
}
```

Cursor 사이드바에서 **Customize**를 열고 RunAPI를 찾아 활성화하십시오.
프로세스가 시작되지 않으면 **Output** 패널을 열고 **MCP Logs**를 선택하십시오.

## VS Code

1.  명령 팔레트를 열고 **MCP: Add Server**를 실행합니다.
2.  **Command (stdio)**를 선택하고 `npx -y @runapi.ai/mcp`를 입력합니다.
3.  서버 이름을 **RunAPI**로 지정하고 구성 범위를 선택한 후 시작합니다.
4.  메시지가 표시되면 서버를 신뢰합니다. 오류가 발생하면 **MCP: List Servers**를 실행하고 RunAPI를 선택한 후 **출력 표시**를 선택합니다.

VS Code는 최상위 `servers` 키 아래에 수동 구성을 저장하며 `type: "stdio"`를 사용합니다.

## Windsurf

이 단계는 Cascade 에이전트에 적용됩니다. Devin Local은 Devin CLI 구성을 사용합니다.

1.  **Devin 설정 > Cascade > MCP 서버**를 엽니다.
2.  `~/.codeium/windsurf/mcp_config.json`에서 MCP 구성 파일을 직접 엽니다.
3.  위의 Cursor 예시에 표시된 `npx` 명령과 인수를 사용하여 RunAPI를 추가합니다.
4.  파일을 저장하고 MCP 서버를 새로 고친 후 RunAPI를 활성화합니다.

## 기타 MCP 클라이언트

이름이 **RunAPI**인 로컬 stdio 서버를 추가합니다. 명령을 `npx`로 설정하고 인수를 `-y` 및 `@runapi.ai/mcp`로 설정합니다. 구성을 저장한 후 클라이언트를 재시작하거나 새로 고칩니다.

## 연결 확인

클라이언트에게 문의하십시오:

> RunAPI에서 사용 가능한 이미지 모델은 무엇인가요?

클라이언트는 `list_models`를 호출하여 사용 가능한 이미지 모델을 반환해야 합니다. 이 공개 검색 도구는 인증이 필요하지 않습니다.

## 필요 시 로그인

로그인하지 않고 검색 도구를 계속 사용하세요. RunAPI에 처음으로 태스크 생성, 태스크 검색 또는 잔액 확인을 요청할 때 클라이언트가 `login` 도구를 호출하도록 하세요. 브라우저에서 RunAPI가 열리고 자격 증명이 공유 로컬 구성에 저장됩니다.

터미널에서 로그인하려면 [RunAPI
CLI](https://runapi.ai/ko/docs/resources/cli.md)를 설치하고 실행하세요:

```shell
runapi login
```

헤드리스 또는 CI 클라이언트의 경우 [인증 가이드](https://runapi.ai/ko/docs/guides/authentication.md)에 따라 전용 표준 API 키를 생성한 후 클라이언트의 환경 또는 시크릿 구성을 통해 `RUNAPI_API_KEY`로 제공하세요. 환경 키는 로컬 MCP 로그인으로 저장된 자격 증명보다 우선합니다.

## 문제 해결

* `npx`를 찾을 수 없는 경우: `node --version`과 `npx --version`이 정상적으로 실행되는지 확인한 후 MCP 클라이언트를 완전히 재시작하여 업데이트된 환경을 수신하도록 하십시오.
* 로컬 서버가 즉시 종료되는 경우: 터미널에서 `npx -y @runapi.ai/mcp`를 실행하고 보고된 Node.js 또는 패키지 오류를 수정한 후 클라이언트를 재시작하십시오.
* RunAPI 도구가 나타나지 않는 경우: 서버가 활성화되어 있고 명령이 stdio를 사용하는지 확인한 후 위에서 설명한 클라이언트 로그를 확인하십시오.
* 인증된 도구가 실패하는 경우: 클라이언트에서 `login` 도구를 호출하십시오. `RUNAPI_API_KEY`가 설정되어 있으면 Local MCP Login을 다시 시도하기 전에 업데이트하거나 제거하십시오.

로컬 Node.js 프로세스 없이 연결하고 싶으신가요? [Hosted MCP 설정하기](https://runapi.ai/ko/docs/resources/mcp/hosted.md).

---

## RunAPI의 더 많은 정보

- [홈](https://runapi.ai/ko/.md)
- [모델 카탈로그](https://runapi.ai/ko/models.md)
- [요금](https://runapi.ai/ko/pricing.md)
- [제공사](https://runapi.ai/ko/models)
- [문서](https://runapi.ai/ko/docs/guides)
- [SDK](https://runapi.ai/ko/sdk.md)
- [CLI](https://runapi.ai/ko/cli.md)
- [MCP Server](https://runapi.ai/ko/mcp.md)
- [Claude Code와 Cursor](https://runapi.ai/ko/claude-code-vs-cursor.md)
- [Cursor API 설정](https://runapi.ai/ko/cursor-api-setup.md)
- [RunAPI와 OpenRouter 비교](https://runapi.ai/ko/openrouter-alternative.md)
- [엔터프라이즈](https://runapi.ai/ko/contact.md)
- [문의](https://runapi.ai/ko/contact.md)
- [약관](https://runapi.ai/ko/terms.md)
- [개인정보](https://runapi.ai/ko/privacy.md)
- [에이전트용 사이트 색인](https://runapi.ai/llms.txt)

문의: contact@runapi.ai

## 구조화된 데이터

```json
[
  {
    "@context": "https://schema.org",
    "inLanguage": "ko",
    "@type": "WebSite",
    "name": "RunAPI",
    "url": "https://runapi.ai/ko",
    "potentialAction": {
      "@type": "SearchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "https://runapi.ai/ko/models?q={search_term_string}"
      },
      "query-input": "required name=search_term_string"
    }
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "ko",
    "@type": "Organization",
    "name": "RunAPI",
    "url": "https://runapi.ai/ko",
    "logo": {
      "@type": "ImageObject",
      "url": "https://runapi.ai/koicon.svg"
    },
    "sameAs": [
      "https://github.com/runapi-ai"
    ]
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "ko",
    "@type": "TechArticle",
    "headline": "로컬 MCP",
    "description": "Claude Code, Cursor, VS Code, Windsurf 또는 다른 stdio 클라이언트와 함께 RunAPI MCP 서버를 로컬에서 실행합니다.",
    "url": "https://runapi.ai/ko/docs/resources/mcp/local",
    "mainEntityOfPage": "https://runapi.ai/ko/docs/resources/mcp/local"
  }
]
```