# 安装 Umami Compass

- 类型: MCP 工具
- 说明: Secure Umami Analytics MCP server for Cloud and self-hosted deployments
- 仓库: https://github.com/webcredo/umami-compass

## 方式一 · 一键代装（复制提示词让 AI 代劳）

### Claude Code
```
请帮我安装 askskill 上的 "Umami Compass" MCP 服务：
执行：claude mcp add 'io-github-webcredo-umami-compass' -- npx -y umami-compass
```

### Codex
```
请帮我安装 askskill 上的 "Umami Compass" MCP 服务：
在 ~/.codex/config.toml 中添加：
[mcp_servers.io-github-webcredo-umami-compass]
command = "npx"
args = ["-y","umami-compass"]
然后重启 Codex 生效
```

### Cursor
```
请帮我安装 askskill 上的 "Umami Compass" MCP 服务：
在 .cursor/mcp.json 的 "mcpServers" 中添加：
"io-github-webcredo-umami-compass": { "command": "npx", "args": ["-y","umami-compass"] }
然后在 Cursor 设置 > MCP 中启用
```

## 方式二 · 命令行安装（原生命令与配置）

### Claude Code
```bash
claude mcp add --env UMAMI_API_KEY=YOUR_VALUE --env UMAMI_ACCESS_TOKEN=YOUR_VALUE --env UMAMI_USERNAME=YOUR_VALUE --env UMAMI_PASSWORD=YOUR_VALUE --env UMAMI_URL=YOUR_VALUE --env UMAMI_API_URL=YOUR_VALUE --env UMAMI_WEBSITE_IDS=YOUR_VALUE --env UMAMI_TEAM_IDS=YOUR_VALUE --env UMAMI_TOOLSETS=YOUR_VALUE --env UMAMI_MAX_RESPONSE_BYTES=YOUR_VALUE --transport stdio io-github-webcredo-umami-compass -- npx -y umami-compass
```
需要环境变量：UMAMI_API_KEY, UMAMI_ACCESS_TOKEN, UMAMI_USERNAME, UMAMI_PASSWORD, UMAMI_URL, UMAMI_API_URL, UMAMI_WEBSITE_IDS, UMAMI_TEAM_IDS, UMAMI_TOOLSETS, UMAMI_MAX_RESPONSE_BYTES

### Codex
```bash
codex mcp add --env UMAMI_API_KEY=YOUR_VALUE --env UMAMI_ACCESS_TOKEN=YOUR_VALUE --env UMAMI_USERNAME=YOUR_VALUE --env UMAMI_PASSWORD=YOUR_VALUE --env UMAMI_URL=YOUR_VALUE --env UMAMI_API_URL=YOUR_VALUE --env UMAMI_WEBSITE_IDS=YOUR_VALUE --env UMAMI_TEAM_IDS=YOUR_VALUE --env UMAMI_TOOLSETS=YOUR_VALUE --env UMAMI_MAX_RESPONSE_BYTES=YOUR_VALUE io-github-webcredo-umami-compass -- npx -y umami-compass
```
配置文件 ~/.codex/config.toml：
```toml
[mcp_servers.io-github-webcredo-umami-compass]
command = "npx"
args = ["-y","umami-compass"]

[mcp_servers.io-github-webcredo-umami-compass.env]
UMAMI_API_KEY = "YOUR_VALUE"
UMAMI_ACCESS_TOKEN = "YOUR_VALUE"
UMAMI_USERNAME = "YOUR_VALUE"
UMAMI_PASSWORD = "YOUR_VALUE"
UMAMI_URL = "YOUR_VALUE"
UMAMI_API_URL = "YOUR_VALUE"
UMAMI_WEBSITE_IDS = "YOUR_VALUE"
UMAMI_TEAM_IDS = "YOUR_VALUE"
UMAMI_TOOLSETS = "YOUR_VALUE"
UMAMI_MAX_RESPONSE_BYTES = "YOUR_VALUE"
```
需要环境变量：UMAMI_API_KEY, UMAMI_ACCESS_TOKEN, UMAMI_USERNAME, UMAMI_PASSWORD, UMAMI_URL, UMAMI_API_URL, UMAMI_WEBSITE_IDS, UMAMI_TEAM_IDS, UMAMI_TOOLSETS, UMAMI_MAX_RESPONSE_BYTES

### Cursor
配置文件 .cursor/mcp.json：
```json
{
  "mcpServers": {
    "io-github-webcredo-umami-compass": {
      "command": "npx",
      "args": [
        "-y",
        "umami-compass"
      ],
      "env": {
        "UMAMI_API_KEY": "YOUR_VALUE",
        "UMAMI_ACCESS_TOKEN": "YOUR_VALUE",
        "UMAMI_USERNAME": "YOUR_VALUE",
        "UMAMI_PASSWORD": "YOUR_VALUE",
        "UMAMI_URL": "YOUR_VALUE",
        "UMAMI_API_URL": "YOUR_VALUE",
        "UMAMI_WEBSITE_IDS": "YOUR_VALUE",
        "UMAMI_TEAM_IDS": "YOUR_VALUE",
        "UMAMI_TOOLSETS": "YOUR_VALUE",
        "UMAMI_MAX_RESPONSE_BYTES": "YOUR_VALUE"
      }
    }
  }
}
```
一键安装：cursor://anysphere.cursor-deeplink/mcp/install?name=io-github-webcredo-umami-compass&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsInVtYW1pLWNvbXBhc3MiXSwiZW52Ijp7IlVNQU1JX0FQSV9LRVkiOiJZT1VSX1ZBTFVFIiwiVU1BTUlfQUNDRVNTX1RPS0VOIjoiWU9VUl9WQUxVRSIsIlVNQU1JX1VTRVJOQU1FIjoiWU9VUl9WQUxVRSIsIlVNQU1JX1BBU1NXT1JEIjoiWU9VUl9WQUxVRSIsIlVNQU1JX1VSTCI6IllPVVJfVkFMVUUiLCJVTUFNSV9BUElfVVJMIjoiWU9VUl9WQUxVRSIsIlVNQU1JX1dFQlNJVEVfSURTIjoiWU9VUl9WQUxVRSIsIlVNQU1JX1RFQU1fSURTIjoiWU9VUl9WQUxVRSIsIlVNQU1JX1RPT0xTRVRTIjoiWU9VUl9WQUxVRSIsIlVNQU1JX01BWF9SRVNQT05TRV9CWVRFUyI6IllPVVJfVkFMVUUifX0
需要环境变量：UMAMI_API_KEY, UMAMI_ACCESS_TOKEN, UMAMI_USERNAME, UMAMI_PASSWORD, UMAMI_URL, UMAMI_API_URL, UMAMI_WEBSITE_IDS, UMAMI_TEAM_IDS, UMAMI_TOOLSETS, UMAMI_MAX_RESPONSE_BYTES