内容
# Clics
隐私友好、无 Cookie 的网络分析工具 — 专为希望在 GDPR 合规的情况下进行测量的团队而设计，无需跟踪 Cookie。
- **网站：** [clics.dev](https://clics.dev)
- **仪表盘：** [platform.clics.dev](https://platform.clics.dev)
- **文档：** [clics.dev/docs](https://clics.dev/docs)
Clics 可以测量您网站的流量、目标和漏斗。该存储库分发面向代理的工具，以便 AI 助手可以查询分析数据并从终端、本地 MCP 客户端或基于 Web 的助手管理您的工作区。
## 您将获得
| 工具 | 包 / 端点 | 最适合 |
|------|-------------------|----------|
| **远程 MCP** | 托管端点（见下文） | ChatGPT、Claude.ai、n8n 和其他 HTTP MCP 客户端 |
| **本地 MCP** | [`@clicsdev/mcp`](https://www.npmjs.com/package/@clicsdev/mcp) | Cursor、Claude Code、VS Code、Windsurf 和其他 stdio MCP 客户端 |
| **命令行界面** | [`@clicsdev/cli`](https://www.npmjs.com/package/@clicsdev/cli) | 脚本、CI 和从终端进行手动验证 |
| **代理技能** | 此存储库 | 教授代理何时以及如何使用 Clics MCP + CLI |
在 [仪表盘](https://platform.clics.dev) 中创建 API 密钥。
---
## 远程 MCP
通过 HTTP 流式传输托管的 [模型上下文协议](https://modelcontextprotocol.io) 服务器。当您的助手在浏览器或工作流工具中运行且无法运行本地 `npx` 进程时，请使用此功能。
**端点**（用您的 Clics API 密钥替换 `YOUR_API_KEY`）：
```
https://api.clics.dev/YOUR_API_KEY/v1/mcp
```
API 密钥嵌入在 URL 中。在客户端将身份验证设置为 **无**；不需要额外的头部。
**工具：** 与本地 MCP 相同的 15 个工具（`list_projects`、`get_project`、`create_project`、`update_project`、`delete_project`、`list_goals`、`create_goal`、`update_goal`、`delete_goal`、`list_funnels`、`get_funnel`、`create_funnel`、`update_funnel`、`delete_funnel`、`query_stats`）。
### ChatGPT
1. 在 [仪表盘](https://platform.clics.dev) 中创建 API 密钥。
2. 在 ChatGPT 中，打开 **设置** → **高级设置** 并启用 **开发者模式**。
3. 打开 **应用和连接器** → **创建**。
4. 填写：
- **名称：** `Clics MCP`
- **MCP 服务器 URL：** `https://api.clics.dev/YOUR_API_KEY/v1/mcp`
- **身份验证：** `无`
5. 保存并在对话中启用连接器。
### Claude.ai
1. 在 [仪表盘](https://platform.clics.dev) 中创建 API 密钥。
2. 进入 **设置** → **连接器** → **添加自定义连接器**。
3. 将 **URL** 设置为 `https://api.clics.dev/YOUR_API_KEY/v1/mcp`（留空 OAuth 字段）。
4. 在对话中，从 **连接器** 启用连接器。
### n8n
1. 在 [仪表盘](https://platform.clics.dev) 中创建 API 密钥。
2. 在您的工作流中，添加一个 **AI 代理** 节点。
3. 添加一个工具 → **MCP 客户端工具**。
4. 配置：
- **端点：** `https://api.clics.dev/YOUR_API_KEY/v1/mcp`
- **服务器传输：** `HTTP 流式传输`
- **身份验证：** `无`
5. 选择要公开的工具（全部、已选择或全部除外）。
---
## 本地 MCP (`@clicsdev/mcp`)
用于无 Cookie 分析的本地 [模型上下文协议](https://modelcontextprotocol.io) 服务器（stdio）。当您的编辑器可以运行本地进程时，从中管理项目、目标、漏斗和查询统计。
**安装**
```bash
npm install -g @clicsdev/mcp
# 或：npx -y @clicsdev/mcp
```
**身份验证** — 在您的 MCP 客户端配置中设置 `CLICS_API_KEY`（永远不要将密钥作为工具参数传递）。
**Cursor**（`.cursor/mcp.json`）：
```json
{
"mcpServers": {
"clics": {
"command": "npx",
"args": ["-y", "@clicsdev/mcp"],
"env": {
"CLICS_API_KEY": "your_api_key"
}
}
}
}
```
**工具：** `list_projects`、`get_project`、`create_project`、`update_project`、`delete_project`、`list_goals`、`create_goal`、`update_goal`、`delete_goal`、`list_funnels`、`get_funnel`、`create_funnel`、`update_funnel`、`delete_funnel`、`query_stats`。
完整客户端设置：[npm/@clicsdev/mcp](https://www.npmjs.com/package/@clicsdev/mcp)
---
## 命令行界面 (`@clicsdev/cli`)
用于相同操作的命令行界面 — 输出 JSON，适用于自动化和快速检查。
**安装**
```bash
npm install -g @clicsdev/cli
# 或：npx @clicsdev/cli --help
```
**身份验证**
```bash
clics init --api-key "<your-api-key>"
```
**示例**
```bash
clics projects list
clics goals list <project-id>
clics query <project-id> --metrics visitors pageviews bounce_rate --date-range last30days
```
完整命令参考：[npm/@clicsdev/cli](https://www.npmjs.com/package/@clicsdev/cli)
---
## 代理技能
`clics` 技能教导代理在连接时优先使用 MCP，在不连接时使用 CLI，并遵循分析剧本（概览、热门页面/国家、目标/漏斗）。
**安装** 使用 [技能 CLI](https://github.com/vercel-labs/skills)：
```bash
npx skills add P-Essonam/clicsdev --skill clics
```
全局安装（所有项目）：
```bash
npx skills add P-Essonam/clicsdev --skill clics -g -y
```
列出技能而不安装：
```bash
npx skills add P-Essonam/clicsdev --list
```
技能来源：[`skills/clics/SKILL.md`](skills/clics/SKILL.md)
---
## 许可证
MIT
