개발자 리소스

호스팅 MCP

OAuth를 사용하여 Claude Desktop, Cursor, VS Code, Windsurf 또는 다른 MCP 클라이언트를 RunAPI에 연결합니다.

Hosted MCP는 RunAPI 도구를 사용하는 권장 방법입니다. MCP 클라이언트가 RunAPI에 직접 연결되므로 Node.js를 설치하거나 로컬 프로세스를 계속 실행할 필요가 없습니다.

이 엔드포인트를 사용하세요:

TEXT

https://mcp.runapi.ai/mcp

아래에서 MCP 클라이언트를 선택하십시오. 클라이언트가 브라우저에서 RunAPI를 열면 로그인하여 사용할 계정을 선택하고 액세스를 승인하십시오.

Claude Desktop

RunAPI가 대화에 나타나지 않으면 설정 > 커넥터로 돌아가서 다시 연결하고 해당 대화에서 활성화되어 있는지 확인하세요.

프로젝트 수준의 .cursor/mcp.json과 같은 Cursor mcp.json에 RunAPI를 추가합니다:

JSON

{
  "mcpServers": {
    "runapi": {
      "url": "https://mcp.runapi.ai/mcp"
    }
  }
}

Cursor 사이드바에서 Customize를 열고 RunAPI를 찾아 활성화한 후, 브라우저에서 인증을 완료하십시오.

RunAPI가 연결된 것으로 표시되고 도구를 노출해야 합니다. 연결 또는 인증 오류가 발생하면 출력 패널을 열고 MCP 로그를 선택하세요.

RunAPI 도구가 Chat에 표시되어야 합니다. 오류가 발생하면 MCP: 서버 목록을 실행하고 RunAPI를 선택한 후 출력 표시를 선택하세요.

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

Devin 설정 > Cascade > MCP 서버를 열고 ~/.codeium/windsurf/mcp_config.json 파일을 직접 편집합니다.
RunAPI를 원격 HTTP 서버로 추가합니다:

JSON

{
  "mcpServers": {
    "runapi": {
      "serverUrl": "https://mcp.runapi.ai/mcp"
    }
  }
}

도구가 나타나지 않으면 MCP 설정을 열고, RunAPI가 활성화되어 있는지 확인한 후 다시 연결하세요.

위의 엔드포인트를 Streamable HTTP 서버로 추가합니다. 클라이언트는 Remote MCP와 브라우저 기반 OAuth를 지원해야 합니다. 메시지가 표시되면 인증을 완료하고 클라이언트에서 RunAPI 도구를 활성화합니다.

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

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

클라이언트는 list_models를 호출하여 사용 가능한 이미지 모델을 반환해야 합니다. 이를 통해 연결 및 도구 디스패치가 정상 작동하는지 확인할 수 있습니다.

OAuth가 권장 경로입니다. 무인 클라이언트이거나 OAuth를 사용할 수 없는 경우에만 전용 표준 API 키를 사용하십시오. 키 생성 방법은 인증 가이드를 참조하십시오. 키를 엔드포인트 URL에 넣거나 저장소에 커밋하지 마십시오.

Claude Desktop: 사용자 정의 커넥터에 요청 헤더를 사용할 수 있는 경우, 값이 Bearer YOUR_API_KEY인 Authorization 헤더를 추가하세요.
Cursor: Cursor 애플리케이션에 표시되는 환경에 RUNAPI_API_KEY를 설정한 후, 서버 headers에 Authorization: Bearer ${env:RUNAPI_API_KEY}를 사용하세요. 원격 서버는 Cursor의 envFile 설정을 읽지 않습니다.
VS Code: mcp.json에 키를 직접 기록하는 대신, VS Code가 키를 묻고 저장하도록 서버 Authorization 헤더에서 password 유형의 ${input:...}을 참조하세요.
Windsurf: ~/.codeium/windsurf/mcp_config.json의 Authorization 헤더에서 ${env:RUNAPI_API_KEY} 또는 ${file:...}을 참조하세요.

클라이언트가 폐기되거나 키가 노출되었을 가능성이 있을 때 API Keys 페이지에서 키를 폐기하세요.

인증이 완료되지 않은 경우: 클라이언트에서 RunAPI를 다시 연결하고 브라우저 흐름을 처음부터 완료하십시오.
RunAPI는 연결되어 있지만 도구가 없는 경우: 서버가 활성화되어 있는지 확인하고, 정확한 엔드포인트를 제거한 후 다시 추가한 다음 새 대화를 시작하십시오.
확인 질문이 실패하는 경우: 위 해당 섹션에 설명된 클라이언트 로그를 확인한 후 재시도 전에 RunAPI를 다시 연결하십시오.

클라이언트가 사용자의 머신에서 RunAPI를 시작하도록 하려면 Local MCP 설정을 참조하십시오.