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 还提供了一个 Beta 选项，可在其主界面的开发者模式中连接 MCP，而无需使用单独的 GPT 应用。

对于大多数用户，我们建议采用上文所述的标准设置方式。高级用户可按照以下步骤操作。

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 界面中）
   • 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 时，它会自动配置在界面中添加的 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 的那个用户完全相同的数据访问权限。

会。所有上下文数据在传输过程中和静态存储时均使用行业标准加密协议进行加密。