SmartGate

SmartGate

AI 智能层——并非另一个助手或 LLM 代理。

适用于 Cursor、Claude Code、claude.ai 和 Cowork 的官方 SmartGate 插件。

SmartGate 是 AI 与世界之间的智能层——帮助你研究、理解、记忆并采取行动，避免失控的工具流量带来意外账单。

表层功能：Smart Research、决策、知识和监控——无需 MCP。底层则是一个原生支持 MCP 的算法网关，具备五种能力（Research、Context、Memory、Control、Pipeline），由七个 smart_* 基元提供支持。人类界面（Web）+ Agent 界面（MCP/API）。它不是聊天机器人、搜索应用或模型路由器。宿主模型仍在客户端运行。

Cursor Marketplace 的插件标志使用 1:1 比例的盾牌图标 assets/logo.png。横幅为官网的 OG 卡片。

什么是 SmartGate MCP

无需为每个 Agent 重建研究基础设施。通过 Streamable HTTP 连接一次；网关会在工具流量到达模型提供商之前，完成抓取、搜索、压缩、去重、记忆，并设置严格上限。

能力	Agent 的操作	产品
Research	查找来源，然后以 Markdown 形式读取页面	Traffic Customs
Context	对重复的搜索结果去重，然后压缩	Token Control
Memory	跨会话保存和调用团队事实	Features
Control	检查、计数并限制令牌预算	Token Control
Pipeline	将研究 / 阅读 / 记忆作为一个任务运行	Tools

• 产品：smartgate.network · 功能 · 定价
• 连接：快速入门 · 连接 · MCP 端点
• 参考：工具 · 安全 · llms.txt
• 合规：审计 · 隐私 · 条款

安装

在 Dashboard → API Keys 中创建密钥（sk_live_…）。切勿将密钥粘贴到聊天中或提交到代码库。

官方 MCP Registry 名称：network.smartgate/smartgate。相同端点：https://smartgate.network/api/mcp。该条目仅包含元数据——你仍需要 Dashboard Bearer 密钥。

Cursor

1. 从 Cursor Marketplace 安装 SmartGate，或在 Cursor Dashboard → Plugins → Team Marketplaces → Import from Repo 中导入此代码库：https://github.com/smartgate-network/smartgate-workflows
2. 打开 Plugins → SmartGate → Configure 并设置 SMARTGATE_API_KEY
3. 重启 Cursor（或重新加载窗口），以便再次进行 MCP 握手

Claude（claude.ai / Cowork / Claude Code）

1. 在 Anthropic 的目录中列出 SmartGate 后添加，或在本地加载此仓库：claude --plugin-dir .
2. Claude 提示配置插件时，设置 SMARTGATE_API_KEY。在 Claude Code 中，也可以运行 /plugin configure @smartgate
3. 确认连接器：在 claude.ai / Cowork 中使用插件的 连接器选项卡；在 Claude Code 中运行 /mcp，并查找 plugin:smartgate:smartgate

Gemini CLI

gemini extensions install https://github.com/smartgate-network/smartgate-workflows

CLI 提示时设置 SMARTGATE_API_KEY。清单：gemini-extension.json。

首次运行

MCP 服务显示为已连接后，尝试：

Check my SmartGate token allowance with smart_budget_guard action=check.

smart_fetch https://smartgate.network/docs/tools then summarize Token Control, Traffic Customs, and Audit.

Remember: our staging API rate limit is 100 req/min

实时的 tools/list 架构（用途、参数、返回值）来自托管服务，而非此仓库。名称为 smart_* —— 没有 smartgate_compress_context。完整参考：文档 → 工具。

工具（审核者速查表）

每个工具都会返回一个 JSON 字符串。综合处理前请先解析。不要编造页面内容。

工具	必需参数	可选参数	返回值
smart_search	query	max_results（1–50，默认值为 10）	搜索结果（results[].url、snippet）
smart_fetch	url（http/https）	timeout（默认值为 30s）	页面 markdown、title、url
smart_dedup	texts（string[]）	threshold（0–1，默认值为 0.9）	保留 / 移除的索引或去重后的文本
smart_context_gate	text	ratio（默认值为 0.5）、purpose	compressed、ratio、令牌数量
smart_budget_guard	action：check | count | record	根据操作使用 text / tokens	额度、用量或记录确认信息
smart_memory	action：add | search | get | delete	text（add）、query（search）、memory_id（get/delete）	结构取决于操作
smart_pipe	template 或 steps	query、url、text	每一步的结果。模板：research、read、remember。不适用于单步操作。

此插件附带的技能：

技能	适用场景
smartgate-workflows	选择合适的工作流
smartgate-research-agent	多来源研究
smartgate-deep-reading	已知 URL 的深入阅读
smartgate-remember-and-recall	团队记忆
smartgate-usage-report	配额 / 用量（不含内容）

配置

Cursor Marketplace： 插件 → SmartGate → 配置 → SMARTGATE_API_KEY。Cursor 会读取 mcp.json（${SMARTGATE_API_KEY}）。

Claude 目录 / Claude Code： /plugin configure @smartgate → SMARTGATE_API_KEY。Claude 会读取 .mcp.json（${user_config.SMARTGATE_API_KEY}）。不要提交真实密钥。

手动配置 / 审核者备用方案（仅适用于未使用插件的情况）：将以下内容合并到 ~/.cursor/mcp.json（用户级）或 <project>/.cursor/mcp.json（项目级），然后重启 Cursor。替换占位符。如果也安装了插件，请删除此代码块，以免工具重复。

{
  "mcpServers": {
    "smartgate": {
      "type": "streamable-http",
      "url": "https://smartgate.network/api/mcp",
      "headers": {
        "Authorization": "Bearer sk_live_REPLACE_WITH_YOUR_KEY",
        "X-SmartGate-Agent-Platform": "cursor"
      }
    }
  }
}

Claude Code / claude.ai 备用方案（仅在未安装插件时使用）。使用相同的端点、Claude 的 http 类型，以及插件版 .mcp.json 中的 ${user_config.SMARTGATE_API_KEY}：

{
  "mcpServers": {
    "smartgate": {
      "type": "http",
      "url": "https://smartgate.network/api/mcp",
      "headers": {
        "Authorization": "Bearer sk_live_REPLACE_WITH_YOUR_KEY",
        "X-SmartGate-Agent-Platform": "claude"
      }
    }
  }
}

托管端点：POST https://smartgate.network/api/mcp（Streamable HTTP）。在控制面板 → API 密钥创建密钥。如果还从目录添加独立的 SmartGate MCP 连接器，请使用相同的 URL，以免工具重复。

数据处理

此插件不会在 Cursor 或 Claude 中执行 fetch、search、compression 或 memory。这些步骤由托管式网关 https://smartgate.network/api/mcp 执行。宿主模型（Cursor 或 Claude）仍在客户端运行。

• **传输中：**使用 HTTPS + Authorization: Bearer。插件不携带任何密钥。你需要在宿主的插件配置对话框中设置 SMARTGATE_API_KEY（Cursor variables，或 Claude userConfig）。
• 静态存储：我们存储的是 API 密钥的哈希值，而非原始密钥。各团队通过密钥对应的租户相互隔离。请勿传入其他团队的 team_id。
• 记录内容：工具名称、时间戳、令牌计数，以及 fetch 请求的目标 URL。保留期限：Free 7 天 · Pro 30 天 · Teams 90 天 · Enterprise 180 天。请参阅安全和日志。
• 压缩 / 去重：smart_context_gate（LLMLingua）和 smart_dedup（SemHash）在 SmartGate 服务器上运行，不会在本地运行。它们会缩减或删除重叠文本；它们不是个人身份信息（PII）脱敏产品。请勿在工具参数或 memory 中放入密钥或凭据。
• **我们不会做的事：**我们不是大模型代理，也不会把你的提示词用于训练面向消费者的公共聊天机器人。账单卡数据由 Paddle 处理，我们不会存储。

隐私政策 · 条款 · SECURITY.md · [email protected]

故障排查

症状	检查项
401 Unauthorized	确认已在宿主的插件配置对话框中设置 SMARTGATE_API_KEY；密钥格式为 sk_live_…
工具列表为空	重启 Cursor，或在 Claude Code 中运行 /mcp 并重新连接 plugin:smartgate:smartgate
GET 返回 405	端点是 POST /api/mcp，不是 GET SSE
工具重复	从 ~/.cursor/mcp.json 或 ~/.claude.json 中删除手动编写的 smartgate 配置块

工作流源文件

workflows/ 是场景源文件（YAML + Markdown）。skills/ 是已提交的插件包，由以下命令生成：

pip install jsonschema pyyaml
python scripts/install-skills.py --client cursor --target skills --force
python tests/validate.py

工作流	描述
research-agent	search → fetch → dedup → compress
deep-reading	fetch → compress
remember-and-recall	团队记忆
usage-report	预算检查 / 计数

手动安装技能（无需 Marketplace）：请参阅 clients/README.md。

维护者

SmartGate · [email protected]

许可证

MIT