> ## 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.

# OpenClaw MCP 설정

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

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

## 원격 MCP 연결하기

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

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

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

**1. 원격 MCP 지원 여부 확인**

```bash theme={null}
openclaw mcp --help
```

실제로 사용하는 Gateway 버전이 Streamable HTTP와 OAuth를 지원해야 합니다. 이 명령들이 없다면 해당 버전의 업그레이드 안내를 따르거나 [별도의 CLI 가이드](https://evolink.ai/docs/ko/cli/openclaw.md)를 이용하세요. 구버전 호스트에 맞춰 옵션을 지어내지 마세요.

**2. 서버를 추가하고 OAuth 설정**

```bash theme={null}
openclaw mcp add evolink --url https://mcp.evolink.ai/mcp --transport streamable-http
```

Gateway의 `~/.openclaw/openclaw.json` 또는 실제로 사용하는 설정 파일에서 `mcp.servers.evolink` 안의 `auth`를 `"oauth"`로 설정하고, 자동으로 생성된 다른 필드는 그대로 두세요. 지원되는 Control UI 버전에서는 Settings → MCP에서 추가하고 활성화할 수 있습니다.

**3. 인증, 연결 점검, 조회**

```bash theme={null}
openclaw mcp login evolink
openclaw mcp doctor evolink --probe
```

브라우저에서 승인한 뒤, 실제 Gateway에 속한 에이전트로 아래 프롬프트를 보내세요. 변경 사항이 반영되지 않으면 그 연결을 소유한 Gateway를 새로 고치세요. 노트북의 터미널을 새로 고친다고 원격 Gateway가 새로 고쳐지지는 않습니다.

OpenClaw의 도구 정책도 사용 가능 여부를 좌우합니다. 버전, 인증, 연결 소유권에 관해서는 [OpenClaw 문서](https://docs.openclaw.ai/tools/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.