> ## Documentation Index
> Fetch the complete documentation index at: https://evolink.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Cursor MCP 설정

> 네이티브 원격 MCP 설정, 브라우저 인증, 도구 검증, 문제 해결

이 페이지는 Cursor의 네이티브 MCP를 다룹니다. 원격 서비스는 Streamable HTTP와 브라우저 OAuth를 사용하며 EvoLink CLI가 필요 없습니다. 명령과 스킬로 실행하려면 별도의 [CLI 가이드](https://evolink.ai/docs/ko/cli/cursor.md)를 이용하세요.

## 원격 MCP 연결하기

네이티브 도구를 쓰려면 다음 서버 URL로 **Streamable HTTP + OAuth**를 사용하세요:

```text theme={null}
https://mcp.evolink.ai/mcp
```

CLI를 설치할 필요는 없습니다. 기존 설정을 백업하고, EvoLink 항목만 병합하고, 다른 서비스는 그대로 유지하세요. 명령으로 등록하는 방법과 수동으로 등록하는 방법 중 하나를 선택하세요.

**1. Cursor에 서버 추가**

[Cursor에 추가](https://cursor.com/install-mcp?name=evolink\&config=eyJ1cmwiOiJodHRwczovL21jcC5ldm9saW5rLmFpL21jcCJ9)를 선택하고, 브라우저가 Cursor를 열도록 허용한 뒤, 이름과 URL을 검토하고 확인하세요. 애플리케이션이 열리지 않으면 아래의 수동 설정을 사용하세요.

**2. 연결 활성화 및 인증**

Cursor의 MCP 설정을 열고 EvoLink를 활성화한 뒤 브라우저에서 로그인하고 승인하세요. Cursor로 돌아와 연결과 도구 목록을 확인하세요.

**3. Agent에서 무료로 검증**

도구 권한이 있는 Agent 대화를 열고 아래의 검증 프롬프트를 보내세요. 도구가 보이지 않으면 연결을 새로 고치거나 새 대화를 시작하세요. 프로젝트 설정이 전역 항목을 덮어쓰거나 비활성화하고 있지 않은지도 확인하세요.

수동 설정은 전역으로는 `~/.cursor/mcp.json`을, 프로젝트 하나에는 `.cursor/mcp.json`을 사용합니다. 기존 `mcpServers` 객체에 병합하세요:

```json theme={null}
{
  "mcpServers": {
    "evolink": {
      "url": "https://mcp.evolink.ai/mcp"
    }
  }
}
```

[Cursor 설정 문서](https://cursor.com/docs/mcp)를 참고하세요.

인증을 마친 뒤 에이전트 채팅에 다음을 보내세요:

```text theme={null}
EvoLink로 제 계정 잔액을 확인하고 사용할 수 있는 이미지 모델을 검색해 주세요. 아직 생성하지 마세요.
```

**성공 표시**: 실제 `check_balance`와 `search_models` 호출이 결과를 반환합니다. 이 도구들은 실제 MCP 연결에서 검증하세요.

## 업데이트, 연결 해제, 문제 해결

원격 MCP 서버는 EvoLink가 업데이트합니다. 설정을 변경한 뒤에는 실제 클라이언트 세션을 새로 고치세요. 필요하면 해당 클라이언트의 OAuth 인증 기능으로 다시 인증하세요. 연결을 해제하려면 호스트의 MCP 설정에서 EvoLink를 비활성화하거나, 로그아웃하거나, 제거하세요. 다른 서버는 그대로 두세요.

| 증상 | 조치 |
| - | - |
| URL은 추가했지만 도구가 없음 | 연결을 활성화하고, 인증을 완료하고, 새로 고친 뒤 조직 정책을 확인하세요 |
| 401 또는 인증 필요 | 이 MCP 연결을 다시 인증하고 원래 작업 ID를 보관하세요 |
| 403 또는 도구 거부 | 호스트 권한, 계정/키 상태, 네트워크 오류를 확인하세요 |
| 시간 초과 또는 응답 유실 | 다시 생성하지 말고 원래 요청을 조회해 복구하세요 |
| 링크만 표시되거나 미리보기가 회색임 | 자동으로 다시 만들지 말고 원본을 열어 전달하세요 |

[MCP 비용, 접근 권한, 문제 해결](https://evolink.ai/docs/ko/mcp/billing.md#faq)을 참고하세요. 제출하기 전에 [제작 작업 흐름](https://evolink.ai/docs/ko/mcp/overview.md#workflows)을 읽어 보세요. 호출 형식은 [MCP 도구 레퍼런스](https://evolink.ai/docs/ko/mcp/tools.md)에 있습니다.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.