集成
面向 Claude、ChatGPT 和 n8n 的 MCP 服务器
一个远程 Model Context Protocol 端点,让 AI 助手可以列出链接、读取访问记录并创建追踪 URL。
Ultimate 工作区在 https://letl.ink/mcp 提供远程 Model Context Protocol 服务器。Claude、ChatGPT 和 n8n 的 MCP Client 通过 Streamable HTTP 使用 JSON-RPC 通信。令牌与 REST API 使用的 API 令牌相同。Free、Solo 或 Growth 工作区即使因其他原因已有令牌,访问 /mcp 也会收到 403。
协议与认证
- 协议版本
2025-03-26。 - 方法:
initialize、ping、tools/list、tools/call。resources/list和prompts/list返回空列表。 - 使用
Authorization: Bearer YOUR_TOKEN或X-API-KEY: YOUR_TOKEN进行身份验证。 - 所有者和管理员在集成 → MCP 下生成令牌。重新生成会立即断开所有 MCP 客户端。
连接 Claude
- 在 Claude 中,打开 Settings → Connectors → Add custom connector。
- URL:
https://letl.ink/mcp。 - 身份验证请求头:
Authorization: Bearer加上你的令牌。 - 连接后,可以让 Claude 汇总工作区、列出链接或创建追踪短网址。
连接 ChatGPT
- 在 ChatGPT 中,打开 Settings → Connectors → MCP。
- 使用相同的 URL 和 Bearer 令牌。
- 部分 ChatGPT 工作区需要先启用开发者模式,自定义 MCP 服务器才会显示。如果找不到连接器,请先检查该开关。
连接 n8n
MCP Client 节点 → 传输方式 Streamable HTTP → URL https://letl.ink/mcp → 请求头 Authorization: Bearer YOUR_TOKEN。详情及另外两种 n8n 接入方式请见 n8n 文章。
工具
| 工具 | 返回内容 / 作用 |
|---|---|
| workspace_summary | 工作区名称、套餐、已用/上限链接数、本自然月的点击数、域名、二维码、数据保留天数、地理位置和 API 是否开启,以及“拦截机器人”是否开启 |
| list_links | 活跃链接(可选 limit,默认 50,最大 200) |
| get_link | 按数字 id 或 short_code 获取单个链接 |
| get_recent_visits | 最近记录的点击(可选 limit,默认 25,最大 100),包含国家 |
| create_link | 创建一个追踪链接。type 可以是 direct、utm、appstore、instagram、mobile 或 device。智能类型受套餐限制;目标网址、UTM 和应用商店 URL 与 REST 创建请求体一致 |
{
"jsonrpc": "2.0",
"id": 1,
"method": "initialize",
"params": {
"protocolVersion": "2025-03-26",
"capabilities": {},
"clientInfo": { "name": "docs", "version": "1" }
}
}
模型会收到什么指示
在 initialize 时,服务器会将自己声明为 letlink,并指示客户端为此工作区查询和创建追踪短链接,包括地理位置字段。工具会同时以文本内容和 structuredContent 两种形式返回 JSON,以便理解结构化结果的客户端跳过解析。
安全
请把已连接的助手当作拥有 API 权限的队友:它可以读取访问记录(部分访问数据中包含 IP),也可以创建计入上限的链接。不要把 Bearer 令牌粘贴到聊天中。如果不再需要某个客户端,请停用连接器并轮换令牌。