메인 콘텐츠로 건너뛰기

​
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. 연결 확인하기

연결 후 새 채팅에서 짧은 질문으로 먼저 테스트하세요. 
이 Syncly 워크스페이스에서 사용할 수 있는 데이터나 도구를 알려줘.
또는 다음처럼 물어볼 수 있습니다. 
이 워크스페이스의 최근 분석 결과를 요약해줘.
처음에는 단순한 질문으로 연결 상태를 확인한 뒤, Query, 포스트, 대시보드, 리포트와 관련된 구체적인 질문을 이어가는 편이 좋습니다.

​
6. URL 관리와 보안

MCP 연결 URL은 워크스페이스 접근에 사용하는 연결 정보입니다.
  • 공개 문서, 메신저, 코드 저장소에 붙여 넣지 마세요.
  • 다른 사람에게 전달하지 마세요.
  • 노출되었다고 판단되면 Syncly 담당자에게 문의하세요.
  • 더 이상 사용하지 않는 클라이언트에서는 Syncly 연결을 삭제하세요.

​
문제가 생겼을 때

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

​
관련 기능