Tolt MCP Server

什么是 Tolt MCP Server？

Tolt MCP Server 是 Tolt 官方托管的 MCP 端点。Tolt 是面向 SaaS 初创公司的联盟营销软件，借助该端点，Claude、ChatGPT 和其他 MCP 客户端可以基于 Tolt 的实时数据回答关于你联盟计划的问题。

Tolt 为 SaaS 公司运营联盟和合作伙伴计划：品牌化的联盟门户、推荐追踪、佣金和付款。Tolt MCP 将这些数据接入 AI 助手，你无需登录后台、翻找报表或导出 CSV，只要问一句"本月按收入排名前 10 的合作伙伴是谁？"，就能得到从你账户中拉取的答案。Tolt 将当前版本称为 v1；其公布的 v2 功能（在聊天中邀请合作伙伴、批准或拒绝佣金、自动生成合作伙伴报告）目前尚未上线。

如何使用 Tolt MCP Server？

你需要一个已开通联盟计划的 Tolt 账户。服务器 URL 为：

https://mcp.tolt.com/

该服务器使用 Streamable HTTP 和 OAuth。无需复制 API 密钥：客户端连接时会打开浏览器窗口，你登录 Tolt 并点击 Allow 即可授权访问你的账户。

Claude Code

claude mcp add --transport http tolt https://mcp.tolt.com/

然后在 Claude Code 中运行 /mcp 并选择认证，Tolt 登录页面会在浏览器中打开。

Claude Desktop 和 claude.ai

按照 Tolt 的指南：打开 Settings > Connectors，点击 Add custom connector，填写名称和 URL https://mcp.tolt.com/。保留默认设置（Authentication：Sign in now；OAuth client：Use Claude's published identity；不填请求头；Transport：Streamable HTTP），然后点击 Add。在浏览器窗口中继续，查看授权请求并点击 Allow。开始新对话前，请确认 Tolt 连接器的开关已打开。

Cursor

将服务器添加到 ~/.cursor/mcp.json（或项目中的 .cursor/mcp.json），然后在 Cursor 的 MCP 设置中完成认证：

{
  "mcpServers": {
    "tolt": {
      "url": "https://mcp.tolt.com/"
    }
  }
}

VS Code

添加到 .vscode/mcp.json；首次使用该服务器时 VS Code 会启动 OAuth 流程：

{
  "servers": {
    "tolt": {
      "type": "http",
      "url": "https://mcp.tolt.com/"
    }
  }
}

ChatGPT

Tolt 也提供了 ChatGPT 的接入说明：添加一个 MCP 服务器，选择 Streamable HTTP，URL 填 https://mcp.tolt.com/，bearer token 和请求头留空并保存，然后点击 Authenticate 和 Allow。

Tolt MCP Server 的主要功能

• 官方出品、由 Tolt 托管：无需在本地安装或运行任何东西。
• 使用 Tolt 账户通过 OAuth 登录，配置文件中不出现 API 密钥。
• 基于你自己的计划回答关于合作伙伴、推荐收入、点击、客户、佣金和交易的问题。
• 服务端聚合工具：Tolt 的工程文章提到了 top_partners、partner_performance_snapshot、commission_reconciliation 和 get_program_summary，它们在服务端计算汇总，而不是让智能体逐条翻页读取记录。
• 面向大批量数据的异步导出（export_job_start、export_job_status、export_job_result），一整年的佣金数据无需塞进一次工具响应。
• schema_introspect 工具会在查询数据前告诉智能体有哪些字段可用。
• 适用于 Claude、ChatGPT 和其他 MCP 客户端；在 Claude 中可以将每个工具设为自动运行、需要批准或禁用。

Tolt MCP Server 的使用场景

• 合作伙伴排名："本月按收入排名前 10 的合作伙伴是谁？与上月相比如何？"
• 转化问题："有没有点击量高但转化率低的合作伙伴？"
• 佣金审核："列出所有超过 500 美元的待处理佣金，并标记异常情况。"
• 不活跃的合作伙伴："哪些合作伙伴 90 天内没有带来任何推荐？"
• 合作伙伴深度分析：在沟通前，查看某个合作伙伴的客户、交易和佣金全貌。
• 定期汇总：结合其他连接器，每周拉取头部合作伙伴表现并发布到 Slack，或在某个合作伙伴的收入超过阈值时创建任务。

Tolt MCP Server 常见问题排查

• 对话中看不到 Tolt 工具：在 Claude 中，开始对话前检查 Tolt 连接器开关是否已启用。
• 连接时要求填写 token：不需要。将 bearer token 和请求头留空，改为完成 OAuth 登录。
• 数字看起来不对：AI 助手可能出错。Tolt 建议在 Tolt 后台核对重要数据。
• 想要执行写操作：邀请合作伙伴和批准佣金是已公布的 v2 功能，v1 尚不支持。