Singular MCP

MCP(Model Context Protocol)는 Singular의 데이터를 ChatGPT, Claude와 같은 LLM 클라이언트로 전달할 수 있게 해주는 프레임워크입니다. 이를 통해 LLM이 기본적으로 갖춘 강력한 분석 및 시각화 기능을 Singular에서 가져온 데이터와 결합할 수 있습니다.

• LLM을 Singular MCP에 연결하세요(아래 안내 참조)
• 이제 LLM이 Singular 데이터와 상호작용할 수 있습니다. 과정은 다음과 같습니다:
  • LLM이 관련된 프롬프트를 받으면 해당 프롬프트를 Singular MCP로 전달합니다.
  • Singular MCP는 프롬프트를 Singular API 쿼리로 변환하여 결과를 생성합니다.
  • 반환된 결과는 LLM이 데이터를 이해하고 더 잘 분석할 수 있도록 돕는 추가 컨텍스트와 함께 사용자의 LLM으로 다시 전송됩니다.
  • LLM은 사용자가 요청한 프롬프트에 따라 데이터를 더 깊이 분석할 수 있습니다.

• ChatGPT
• Claude 및 Claude Code(유료 버전)
• Cursor
• Visual Studio Copilot
• 그 외 MCP 서버를 지원하는 모든 클라이언트(연동을 요청하려면 지원팀에 문의하세요)

• Singular MCP는 Singular 기본 리포트에서 확인할 수 있는 모든 데이터를 반환할 수 있습니다. 여기에는 SDK 또는 S2S에서 수집된 집계 트래커 데이터와 네트워크에서 가져온 비용 데이터가 모두 포함됩니다.
• SKAN 데이터는 곧 지원될 예정입니다

• 성과가 가장 좋은 캠페인은 무엇인가요?
• 지난 30일간 성과가 가장 좋은 캠페인을 막대 그래프로 보여주세요
• 지난 90일간 앱, 소스, 인스톨, D7 ROI를 표로 보여주세요

1. Singular의 GPT 페이지로 이동하세요 여기 - 다음 화면이 표시됩니다:
   
2. 아무 질문이나 시작해 보세요. ChatGPT가 자동으로 Singular MCP에 로그인하도록 요청합니다:
   
3. Singular 계정으로 로그인하세요:
   
4. 완료되면 ChatGPT로 돌아와 연결을 확인하게 됩니다. 이제 “Confirm”을 클릭하세요:
   
5. Singular MCP 쿼리를 항상 허용하려면 “Privacy settings”로 이동하여 MCP 도메인을 “Always allow”로 변경하세요:
   
6. 이제 마케팅 데이터에 대해 무엇이든 질문할 수 있습니다:
   

ChatGPT는 별도의 GPT 앱 대신 기본 인터페이스에서 MCP를 연결할 수 있는 베타 옵션인 개발자 모드를 제공합니다.

대부분의 사용자에게는 위에서 설명한 표준 설정을 권장합니다. 고급 사용자는 아래 단계를 따르세요.

1. 먼저 ChatGPT의 개발자 모드를 활성화해야 합니다. "+" 버튼, "Use connectors", "Add sources", "Connect more"를 차례로 클릭하세요:
   
2. Connectors 화면에서 아래로 스크롤하여 "Advanced settings"로 이동한 후 "Developer mode"를 활성화하세요:
   
3. 다시 Connectors 화면에서 "Create" 버튼을 클릭하고 다음 URL로 Singular MCP를 설정할 수 있습니다:
   https://mcp.singular.net/mcp-server/mcp
   
4. 저장하면 ChatGPT가 Singular 로그인 페이지로 이동시킵니다:
   
5. ChatGPT로 돌아오면 "Singular is now connected"라는 알림이 표시됩니다. 다음으로 여전히 개발자 모드에 있는지 확인한 후 "+" 버튼을 다시 클릭하고 "Developer Mode", "Add sources"를 선택한 다음 아래와 같이 Singular 커넥터를 활성화하세요:
6. 이제 사용해 볼 차례입니다. 마케팅 데이터에 대해 무엇이든 질문하고, ChatGPT가 Singular 도구를 사용하려고 할 때 "Confirm"을 클릭하세요:
   

1. Claude 인터페이스에서 왼쪽 내비게이션 창의 Customize [툴박스 아이콘]을 클릭하세요.
   
2. 다음을 클릭하세요: Connectors
   
3. Connectors [가운데 내비게이션 창]에서 창 오른쪽 상단의 더하기 기호 아이콘 [+] 을 클릭하세요.
   
4. 다음을 클릭하세요: Add custom connector .
   그러면 커넥터 팝업 창으로 이동합니다.
5. 커넥터 팝업 창에서:
   • 이름을 입력하세요. 예: Singular (이후 Claude UI에 표시되는 이름입니다)
   • Integration URL은 다음과 같습니다: https://mcp.singular.net/mcp-server/mcp
   
6. 이제 목록에 Singular 연동이 표시됩니다.

   참고: 연동 항목에 "Connect" 버튼이 표시되지 않으면 30초 정도 기다리거나 Claude를 새로고침해 보세요.

7. Connect 버튼을 클릭하세요:
   
   참고 : Connect를 클릭한 후 Claude에서 "Invalid authorization" 오류가 발생했다면 브라우저에서 Claude에 로그인되어 있지 않을 수 있습니다. 먼저 다음 주소에 로그인한 후 https://claude.ai/ 다시 Connect를 클릭해 보세요.
8. Singular 계정으로 로그인하세요
   
9. 이제 연결되었습니다. 활성 연동 목록에서 Singular 연결을 확인할 수 있습니다
   
10. Singular 연동을 클릭하면 해당 연동이 연결된 API를 확인할 수 있습니다. get_report가 Singular API입니다
    
11. Claude 채팅 인터페이스에 프롬프트를 입력하세요.
12. Claude가 외부 연동을 사용할 수 있도록 허용하세요
    
13. Claude Code를 사용하는 경우 UI에 추가된 MCP가 자동으로 설정됩니다. 터미널에서 다음을 실행하여 확인하세요:

    claude mcp list

    그리고 터미널에서 claude를 실행한 후 데이터에 대해 무엇이든 질문하세요:

1. 원격 MCP를 지원하는 최신 버전의 Cursor를 사용하고 있는지 확인하세요. 다음에서 다운로드하거나 업데이트하세요: https://cursor.com/home
2. Cursor의 MCP 디렉터리에 있는 Singular 페이지로 이동하여 "Add to cursor"를 클릭하세요:
   https://cursor.directory/mcp/singular
   또는 Cursor 설정에서 "Tools & Integrations"로 이동하여 "New MCP Server"를 클릭하고 열린 mcp.json 파일을 다음과 같이 수정하여 직접 추가할 수 있습니다:
   

   {
     "mcpServers": {
       "singular-mcp": {
         "url": "https://mcp.singular.net/mcp-server/mcp",
         "transport": "http",
         "auth": {
           "type": "oauth",
           "loginUrl": "https://app2.singular.net/login"
         }
       }
     }
   }

3. Singular MCP가 추가되면 Tools & Integrations 섹션으로 돌아가 새 도구로 표시된 것을 확인할 수 있습니다. 다음으로 "Needs login" 링크를 클릭하여 인증 절차를 시작하세요:
   
4. Singular 계정으로 로그인하세요:
   
5. 완료되면 Claude IDE로 돌아가 Singular 도구가 활성화된 것을 확인할 수 있습니다:
6. 마지막으로 Cursor의 AI 창(채팅 인터페이스)을 열고 "Agent" 모드가 선택되어 있는지 확인한 후 마케팅 데이터에 대해 무엇이든 질문하세요:

1. 다음 안내에 따라 최신 버전의 Gemini-CLI가 설치되어 있는지 확인하세요: https://github.com/google-gemini/gemini-cli
2. Singular MCP를 추가하려면 ~/.gemini/settings.json 파일에 다음을 추가하세요:
   

   {
     "mcpServers": {
       "singular-mcp": {
         "httpUrl": "https://mcp.singular.net/mcp-server/mcp",
         "oauth": {
           "enabled": true,
           "authorizationUrl": "https://mcp.singular.net/oauth_server/authorize",
           "tokenUrl": "https://mcp.singular.net/oauth_server/token",
           "clientId": "Gemini",
           "clientSecret": null,
           "scopes": [
             "mcp:read"
           ]
         }
       }
     }
   }

3. Singular MCP를 추가한 후 터미널에서 "gemini"를 실행하여 gemini-cli를 시작하고 다음을 실행하세요: /mcp auth singular-mcp
   Singular에 로그인한 후 Gemini CLI로 돌아가 인증이 완료되었는지 확인하세요:
4. 완료되면 마케팅 데이터에 대해 무엇이든 질문하고 Gemini가 Singular 도구를 호출할 수 있도록 허용하세요:

1. VS Code 버전 1.101 이상을 사용하고 있는지 확인하세요. 다음에서 다운로드하거나 업데이트하세요:
   https://code.visualstudio.com/updates/
2. 활성 GitHub Copilot 구독이 있어야 합니다. GitHub 조직 관리자가 워크스페이스에서 "MCP servers" 기능을 활성화해야 합니다(GitHub Copilot 설정의 "Policies"에서 확인할 수 있습니다):
   
3. Visual Studio Code IDE 설정을 열고 Features 아래의 Chat 설정으로 이동하여 MCP가 활성화되어 있는지 확인하세요:
   
4. VS Code 명령 팔레트(Shift+Command+P)에서 "MCP: Add Server"를 선택하고 "HTTP" 옵션을 고른 후 다음 MCP URL을 입력하세요:
   https://mcp.singular.net/mcp-server/mcp
   
   완료되면 VS Code가 인증 절차를 시작합니다.
5. Singular 계정으로 로그인하세요:
   
6. 완료되면 VS Code IDE로 돌아가 Extensions 메뉴에 Singular MCP가 설치된 것을 확인할 수 있습니다:
7. 마지막으로 VS Code Copilot 채팅 인터페이스를 열고 "Agent" 모드가 켜져 있는지 확인한 후 마케팅 데이터에 대해 무엇이든 질문하세요:

• 각 LLM은 고유한 강점이 있습니다. 여러 옵션을 테스트해 보고 질문에 가장 적합한 것을 찾아보시기를 권장합니다.

• 예, LLM 클라이언트에는 MCP가 응답으로 반환할 수 있는 데이터 양에 제한이 있습니다.
• 예를 들어 ChatGPT는 문제를 방지하기 위해 쿼리당 최대 5만 자로 제한되며, Claude는 최대 10만 자를 지원합니다.

• 예. 기본적으로 Singular MCP는 계정에 관련된 가장 일반적인 메트릭과 기준을 반환합니다. 다만 경우에 따라 기본 목록에 없는 특정 필드가 누락될 수 있습니다.
• 이러한 경우를 위해 Singular MCP는 관련 필드를 확인하고 변경할 수 있는 유용한 도구를 제공합니다:
  • get_supported_fields - 현재 MCP에서 사용 가능한 모든 필드를 반환합니다
  • update_supported_fields - MCP에서 추가 필드를 추가하거나 제거합니다
• 예를 들어 반환된 데이터에서 "ABC"라는 필드를 찾을 수 없는 경우 다음을 시도해 보세요:
  • "내 지원 필드를 모두 보여주세요" - 전체 목록을 확인하고 ABC가 다른 이름으로 제공되는지 확인하세요
  • "'ABC'를 내 지원 필드에 추가해 주세요" - Singular에 해당 이름이 존재하면 관련 필드로 추가됩니다
  • "지난 30일간의 ABC를 보여주세요" - 이제 관련 결과를 받을 수 있습니다

• ChatGPT 워크스페이스를 사용하는 경우 계정에서 서드파티 GPT가 비활성화되어 있을 수 있습니다. Singular GPT를 사용하려면 관리자에게 아래 워크스페이스 GPT 설정에 접속하여 활성화되어 있는지 확인해 달라고 요청하세요:
  https://chatgpt.com/admin/gpts

  

아니요. 기본적으로 당사 MCP에 전달된 데이터는 Singular에 의해 모델 최적화나 학습에 사용되지 않습니다 . Singular는 고객의 컨텍스트 데이터가 고객 환경 내에 격리되어 유지되며 고객의 쿼리에만 사용되도록 보장합니다.

아니요. 현재 MCP는 Singular 기본 리포트 페이지에 표시되는 집계 데이터에만 접근할 수 있습니다.

예. MCP는 Singular MCP 연동을 LLM과 연결할 때 사용한 사용자와 동일한 데이터 접근 권한을 가집니다.

예. 모든 컨텍스트 데이터는 업계 표준 암호화 프로토콜을 사용하여 전송 중 및 저장 시 모두 암호화됩니다.