> ## Documentation Index
> Fetch the complete documentation index at: https://syncly-a76215af.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude와 AI 클라이언트에 Syncly MCP 연결하기

> Syncly 워크스페이스의 MCP 연결 URL을 Claude, ChatGPT, Cursor 같은 AI 클라이언트에 등록하는 방법을 안내합니다.

# Claude와 AI 클라이언트에 Syncly MCP 연결하기

Syncly MCP 연결 URL을 AI 클라이언트에 등록하면, 해당 클라이언트에서 Syncly 워크스페이스의 데이터를 바탕으로 질문하고 분석할 수 있습니다.

이 문서는 먼저 Claude 연결을 기준으로 설명합니다. ChatGPT, Cursor, Claude Desktop처럼 MCP를 지원하는 다른 클라이언트는 제품별 화면과 지원 범위가 다를 수 있습니다.

## 사용 전 확인할 것

* Syncly에 로그인되어 있어야 합니다.
* 연결하려는 워크스페이스(Workspace)의 멤버여야 합니다.
* MCP 연결 URL은 워크스페이스별로 발급됩니다.
* 다른 워크스페이스를 연결하려면 해당 워크스페이스의 MCP 연결 URL을 다시 복사해야 합니다.
* MCP 연결 URL은 외부에 공유하지 마세요.

## 1. Syncly에서 MCP 연결 URL 복사하기

1. Syncly에 로그인합니다.
2. 연결할 워크스페이스를 선택합니다.
3. 워크스페이스 설정 화면으로 이동합니다.
4. General 영역에서 MCP URL 패널을 엽니다.
5. 표시된 MCP 연결 URL을 복사합니다.

## 2. Claude에 연결하기

Claude에서 Syncly를 외부 연동으로 추가합니다. Claude 계정 종류나 조직 설정에 따라 메뉴 이름이 조금 다를 수 있습니다.

1. Claude에서 **Settings**를 엽니다.
2. **Integrations**로 이동합니다.
3. **Add Integration**을 선택합니다.
4. 이름에는 `Syncly`를 입력합니다.
5. URL에는 Syncly에서 복사한 MCP 연결 URL을 붙여 넣습니다.
6. 저장한 뒤 새 Claude 채팅을 엽니다.
7. 도구 선택 영역에서 Syncly가 보이는지 확인합니다.

## 3. ChatGPT에 연결하기

ChatGPT는 계정 플랜, 조직 정책, 앱 환경에 따라 Connector 기능이 보이지 않을 수 있습니다. 화면에 Connector 설정이 보이는 경우에만 아래 절차를 진행하세요.

1. ChatGPT에서 **Settings**를 엽니다.
2. **Connectors**로 이동합니다.
3. 새 Connector를 추가합니다.
4. URL에 Syncly MCP 연결 URL을 입력합니다.
5. 저장 후 새 채팅을 시작합니다.
6. 질문을 보내기 전에 Syncly Connector가 활성화되어 있는지 확인합니다.

참고: 일부 클라이언트는 대화를 시작한 뒤에는 Connector를 새로 켤 수 없습니다. 연결 후 새 채팅을 열어 테스트하는 편이 안전합니다.

## 4. Cursor 또는 Claude Desktop에 연결하기

Cursor, Claude Desktop, 기타 MCP 클라이언트는 고급 사용자용 설정입니다. 회사나 팀에서 표준 클라이언트를 정했다면 그 기준을 따르세요.

일반적인 흐름은 다음과 같습니다.

1. 클라이언트의 MCP 설정 화면을 엽니다.
2. 새 MCP 서버를 추가합니다.
3. 서버 이름을 `Syncly`로 입력합니다.
4. Syncly MCP 연결 URL을 등록합니다.
5. 클라이언트를 다시 시작하거나 새 채팅을 엽니다.
6. Syncly 도구가 표시되는지 확인합니다.

클라이언트가 URL 직접 입력을 지원하지 않고 설정 파일을 요구할 수 있습니다. 이 경우 팀의 기술 담당자나 Syncly 담당자에게 설정 방식을 확인하세요.

## 5. 연결 확인하기

연결 후 새 채팅에서 짧은 질문으로 먼저 테스트하세요.

```text theme={null}
이 Syncly 워크스페이스에서 사용할 수 있는 데이터나 도구를 알려줘.
```

또는 다음처럼 물어볼 수 있습니다.

```text theme={null}
이 워크스페이스의 최근 분석 결과를 요약해줘.
```

처음에는 단순한 질문으로 연결 상태를 확인한 뒤, Query, 포스트, 대시보드, 리포트와 관련된 구체적인 질문을 이어가는 편이 좋습니다.

## 6. URL 관리와 보안

MCP 연결 URL은 워크스페이스 접근에 사용하는 연결 정보입니다.

* 공개 문서, 메신저, 코드 저장소에 붙여 넣지 마세요.
* 다른 사람에게 전달하지 마세요.
* 노출되었다고 판단되면 Syncly 담당자에게 문의하세요.
* 더 이상 사용하지 않는 클라이언트에서는 Syncly 연결을 삭제하세요.

## 문제가 생겼을 때

| 상황                          | 확인할 것                                              |
| --------------------------- | -------------------------------------------------- |
| Syncly에서 MCP URL이 보이지 않음    | 올바른 워크스페이스를 선택했는지, 워크스페이스 멤버인지 확인하세요.              |
| Claude에서 Syncly가 보이지 않음     | 새 채팅을 열었는지, Integrations에서 Syncly가 추가되어 있는지 확인하세요. |
| ChatGPT에서 Connector가 보이지 않음 | 계정 플랜, 조직 정책, 사용 중인 앱 환경에서 Connector를 지원하는지 확인하세요. |
| 연결은 되었지만 답변이 어색함            | 질문에 워크스페이스, Query, 기간, 보고 싶은 결과를 구체적으로 적어보세요.      |
| 다른 워크스페이스 데이터가 보임           | 등록한 MCP 연결 URL이 원하는 워크스페이스의 URL인지 확인하세요.           |
| MCP 연결 URL을 외부에 공유함         | Syncly 담당자에게 문의하세요.                                |

## 관련 기능

* [워크스페이스 시작하기](/ko/start/workspace-getting-started)
* [Query 만들기](/ko/start/create-query)
* [Query Dashboard에서 분석하기](/ko/analysis/analyze-query-dashboard)
* [Hey Syncly로 질문하기](/ko/ai/hey-syncly)