Glympt

Glympt MCP

Glympt MCP 通过官方 TypeScript SDK v2 提供付费技术信息补充、筛选潜在客户搜索、已保存列表和 CSV 快照。它支持无状态的 2026-07-28 协议，以及 SDK 的 2025-11-25 兼容模式。

两种连接方式均已实现：供开发者客户端使用的 API 密钥 stdio，以及需要明确同意 Glympt 工作区授权的托管 OAuth。生产环境中的 API 密钥工作流、托管 OAuth 发现／刷新／断开连接，以及 ChatGPT、Claude 网页版和 Codex 的实际使用调用均已验证。修复循环回环注册问题后，Cursor 桌面版 3.23.12 也已通过 OAuth、14 个工具的发现和实际使用调用验证。Claude Code 尚未验证。

托管 OAuth

将此 Streamable HTTP URL 添加到支持 OAuth 的客户端：

https://mcp.glympt.com/mcp

登录 Glympt，选择已启用 API 的付费工作区，并同意所请求的范围。每个客户端都会获得独立的工作区授权。前往 账户设置 → MCP 连接 断开客户端，以撤销其访问令牌和刷新令牌。

托管 OAuth 无需本地安装或客户 API 密钥。请从“显示我的 Glympt 查询余额和工作区限额”开始。有关各客户端的具体步骤和当前验证限制，请参阅公开设置指南。

本地 stdio 适配器

需要 Node.js 22 或更高版本。在 Glympt API 密钥设置中为已启用 API 的付费工作区创建一个限定范围的 API 密钥。Pro、Business 和符合条件的自定义套餐支持 API 访问。免费 CSV 试用额度不提供 API 或 MCP 访问权限。

使用客户端的私密凭据设置，将 GLYMPT_API_KEY 放入服务进程环境中，然后运行：

npx --yes @glympt/[email protected]

可执行文件为 glympt-mcp。如需明确的持久安装：

npm install --global @glympt/[email protected]
glympt-mcp

典型的 stdio 客户端配置如下：

{
  "mcpServers": {
    "glympt": {
      "command": "npx",
      "args": ["--yes", "@glympt/[email protected]"],
      "env": {
        "GLYMPT_API_KEY": "tk_live_replace_with_your_key"
      }
    }
  }
}

此占位符不是可用凭据。请仅将真实密钥存储在本地私密配置中，切勿放入共享仓库或聊天提示词中。此软件包不会自动读取 .env 文件。撤销控制面板中的密钥即可断开此适配器。

变量	必填	默认值	用途
GLYMPT_API_KEY	是	无	限定范围的付费工作区 API 密钥
GLYMPT_API_BASE_URL	否	https://api.glympt.com	HTTPS API 来源；开发环境允许使用 HTTP 循环回环

缺少配置时，会在 stderr 输出实用错误信息后退出。运行时诊断信息使用 stderr；stdout 仅传输 MCP 协议消息。运行 npm 软件包无需 tsx、源代码检出或开发依赖。详细的 stdio 设置说明。

从源代码构建和验证

需要 Node.js 22+ 和 pnpm 10.28.2。

pnpm install --frozen-lockfile
pnpm check
pnpm lint
pnpm test
pnpm build
pnpm test:package

测试使用模拟的付费 API 和真实 SDK 客户端。在受限环境中，套接字测试需要循环回环访问权限。软件包验证会检查实际的 tarball，在干净的临时目录中仅安装生产依赖，并在现代和旧版协议下检查已安装的可执行文件和 npx 命令。这些测试不会消耗生产额度。

npm 文件允许列表包含编译后的 stdio 适配器、公开设置文档、许可证和注册表元数据。托管网关运行器和部署配置仅在此源代码仓库中提供。Dockerfile 仍使用 node dist/hosted.js 构建托管服务；请参阅部署说明。

工具和额度

工具	用途	所需权限范围	查询点数
enrich_domain	缓存或排队的域名增强	lookup:read	每个标准化域名 1 点
enrich_domains	增强自有域名数组	bulk:write	每个唯一标准化域名 1 点
get_lookup_job	获取现有任务/结果	lookup:read	无
get_enrichment_batch	获取现有批次进度	bulk:write	无
get_batch_results	获取筛选后的批次结果页	bulk:write	无
search_domains	获取筛选后的共享数据库页面	lookup:read	无
get_usage	获取套餐、余额、周期和限额	lookup:read	无
list_saved_lists	获取工作区列表页	lists:read	无
get_saved_list	获取自有列表及项目页面	lists:read	无
create_saved_list	创建列表	lists:write	无
add_domain_to_list	保存域名和备注；不会扫描	lists:write	无
create_csv_export	对已完成的上传、搜索或保存列表创建快照	exports:read；列表还需 lists:read	无
get_csv_export	获取自有导出的状态	exports:read	无
get_csv_export_chunk	获取已就绪且未过期的 CSV 的确切字节	exports:read	无

所有请求（包括读取和轮询）都会计入工作区 API 速率限额。查询点数扣除、退款和所有权均以 API 为准。MCP 不维护独立余额。

增强及列表/导出变更操作都需要 8–200 个字符的 idempotencyKey。请为每项预期操作选择稳定且唯一的键。响应丢失后，使用相同的键和完全相同的输入重试。新键代表一项新操作，可能会再次扣费。适配器绝不会自动重试可能产生费用的请求。超时或传输取消并不意味着工作已取消或点数已退还。

轮询返回的任务或批次标识时，请采用退避间隔：1s、2s、4s，之后至少间隔 5s。状态进入终止状态后停止轮询。检测到技术问题之前发生的硬性技术故障会根据 API 的账本政策退款；成功获取但未检测到技术的请求以及缓存的 API 增强则会收费。

导出快照在七天后过期。失败或过期的快照会重放其原始操作；只有在有意请求新导出时才使用新键。CSV 公式单元格会进行转义。下载分块包含 base64 字节，而非文本片段；请解码并按 nextOffsetBytes 顺序追加，直到 eof。默认分块大小为 48 KiB，最大为 64 KiB。目前没有公开的 CSV 下载链接；客户端需从经过身份验证的分块重建文件。 技术筛选器使用 shopify、wordpress 和 cloudflare 等 slug。页面默认显示 25 条，最多 100 条；API 响应上限为 256 KiB。若超出字节数限制，请请求更小的页面。国家/地区为估算值，观测结果带有扫描日期，网站证据均视为不可信数据。

验证状态

• 本地 SDK 测试覆盖全部 14 个工具，测试范围包括现代和旧版协议、可执行的 stdio、逐请求托管身份隔离、权限范围、有界响应和凭据脱敏。
• 全新隔离环境中的迁移（至 0041）、230 项后端单元测试、15 项 OAuth/API 工作流测试、112 项现有后端回归测试和 27 项积分恢复检查均已通过。
• 前端生产构建以及本地浏览器登录、工作区授权、PKCE 交换和断开连接验证均已通过。
• 生产环境 API 密钥 stdio 验证已通过：在 SDK 协议 2026-07-28 和旧版 2025-11-25 连接下调用了全部 14 个工具，并验证了真实工作进程扫描、重复请求/重放计费、已保存列表、CSV 分块重建和 DNS 失败退款。测试消耗了 2 个净查询积分。
• Docker/Coolify 部署已上线。托管 OAuth 在两个协议版本下均可发现 14 个工具，刷新令牌轮换验证已通过，已断开连接的 Codex 访问令牌/刷新令牌会被拒绝。ChatGPT、Claude 网页版和 Codex 客户端于 2026-10-04 完成了只读使用检查，未产生查询费用。部署回环注册修复后，Cursor desktop 3.23.12 也通过了 OAuth、14 个工具发现和实际使用调用验证。Claude Code 仍未验证。

请在实施计划中跟踪验收情况。客户端 UI、实验性 Tasks、自动后台轮询、任意 HTTP 抓取和直接数据库访问均不在本次发布范围内。

协议参考

• 7 月 28 日协议发布
• 8 月 22 日路线图更新
• SDK HTTP 处理程序
• SDK 旧版兼容性
• SDK 授权

分发

版本 0.1.0 已在 npm 和官方 MCP Registry上线。注册表元数据位于 server.json。有关已验证的公开条目和目录提交，请参阅分发状态。

许可证

MCP 适配器采用 MIT 许可证；详见 LICENSE。访问 Glympt 服务仍受工作区订阅、权限范围和服务条款约束。