개발자 리소스

로컬 MCP

Claude Code, Cursor, VS Code, Windsurf 또는 다른 stdio 클라이언트와 함께 RunAPI MCP 서버를 로컬에서 실행합니다.

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

시작하기 전에

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

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

SHELL

npx -y @runapi.ai/mcp

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

실행:

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를 선택하십시오.

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

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

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

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

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

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

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

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

터미널에서 로그인하려면 RunAPI CLI를 설치하고 실행하세요:

SHELL

runapi login

헤드리스 또는 CI 클라이언트의 경우 인증 가이드에 따라 전용 표준 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 설정하기.