# 安装 qURL

- 类型: MCP 工具
- 说明: 为 AI 代理生成、解析、审计和轮换具时效与权限范围的安全访问链接。
- 仓库: https://github.com/layervai/qurl-mcp

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

### Claude Code
```
请帮我安装 askskill 上的 "qURL" MCP 服务：
执行：claude mcp add 'io-github-layervai-qurl-mcp' -- npx -y @layervai/qurl-mcp
```

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

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

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

### Claude Code
```bash
claude mcp add --env QURL_API_KEY=YOUR_VALUE --env QURL_API_URL=YOUR_VALUE --env QURL_CONNECTOR_URL=YOUR_VALUE --env QURL_MCP_CONFIG=YOUR_VALUE --env MCP_MAX_UPLOAD_FILE_DATA_BYTES=YOUR_VALUE --env QURL_SMTP_HOST=YOUR_VALUE --env QURL_SMTP_PORT=YOUR_VALUE --env QURL_SMTP_SECURE=YOUR_VALUE --env QURL_SMTP_USERNAME=YOUR_VALUE --env QURL_SMTP_PASSWORD=YOUR_VALUE --env QURL_SMTP_FROM_EMAIL=YOUR_VALUE --env QURL_SMTP_FROM_NAME=YOUR_VALUE --env QURL_SMTP_ALLOWED_RECIPIENTS=YOUR_VALUE --env QURL_SMTP_ALLOWED_RECIPIENT_DOMAINS=YOUR_VALUE --env QURL_SMTP_MAX_RECIPIENTS_PER_MESSAGE=YOUR_VALUE --env QURL_SMTP_MAX_RECIPIENTS_PER_HOUR=YOUR_VALUE --transport stdio io-github-layervai-qurl-mcp -- npx -y @layervai/qurl-mcp
```
需要环境变量：QURL_API_KEY, QURL_API_URL, QURL_CONNECTOR_URL, QURL_MCP_CONFIG, MCP_MAX_UPLOAD_FILE_DATA_BYTES, QURL_SMTP_HOST, QURL_SMTP_PORT, QURL_SMTP_SECURE, QURL_SMTP_USERNAME, QURL_SMTP_PASSWORD, QURL_SMTP_FROM_EMAIL, QURL_SMTP_FROM_NAME, QURL_SMTP_ALLOWED_RECIPIENTS, QURL_SMTP_ALLOWED_RECIPIENT_DOMAINS, QURL_SMTP_MAX_RECIPIENTS_PER_MESSAGE, QURL_SMTP_MAX_RECIPIENTS_PER_HOUR

### Codex
```bash
codex mcp add --env QURL_API_KEY=YOUR_VALUE --env QURL_API_URL=YOUR_VALUE --env QURL_CONNECTOR_URL=YOUR_VALUE --env QURL_MCP_CONFIG=YOUR_VALUE --env MCP_MAX_UPLOAD_FILE_DATA_BYTES=YOUR_VALUE --env QURL_SMTP_HOST=YOUR_VALUE --env QURL_SMTP_PORT=YOUR_VALUE --env QURL_SMTP_SECURE=YOUR_VALUE --env QURL_SMTP_USERNAME=YOUR_VALUE --env QURL_SMTP_PASSWORD=YOUR_VALUE --env QURL_SMTP_FROM_EMAIL=YOUR_VALUE --env QURL_SMTP_FROM_NAME=YOUR_VALUE --env QURL_SMTP_ALLOWED_RECIPIENTS=YOUR_VALUE --env QURL_SMTP_ALLOWED_RECIPIENT_DOMAINS=YOUR_VALUE --env QURL_SMTP_MAX_RECIPIENTS_PER_MESSAGE=YOUR_VALUE --env QURL_SMTP_MAX_RECIPIENTS_PER_HOUR=YOUR_VALUE io-github-layervai-qurl-mcp -- npx -y @layervai/qurl-mcp
```
配置文件 ~/.codex/config.toml：
```toml
[mcp_servers.io-github-layervai-qurl-mcp]
command = "npx"
args = ["-y","@layervai/qurl-mcp"]

[mcp_servers.io-github-layervai-qurl-mcp.env]
QURL_API_KEY = "YOUR_VALUE"
QURL_API_URL = "YOUR_VALUE"
QURL_CONNECTOR_URL = "YOUR_VALUE"
QURL_MCP_CONFIG = "YOUR_VALUE"
MCP_MAX_UPLOAD_FILE_DATA_BYTES = "YOUR_VALUE"
QURL_SMTP_HOST = "YOUR_VALUE"
QURL_SMTP_PORT = "YOUR_VALUE"
QURL_SMTP_SECURE = "YOUR_VALUE"
QURL_SMTP_USERNAME = "YOUR_VALUE"
QURL_SMTP_PASSWORD = "YOUR_VALUE"
QURL_SMTP_FROM_EMAIL = "YOUR_VALUE"
QURL_SMTP_FROM_NAME = "YOUR_VALUE"
QURL_SMTP_ALLOWED_RECIPIENTS = "YOUR_VALUE"
QURL_SMTP_ALLOWED_RECIPIENT_DOMAINS = "YOUR_VALUE"
QURL_SMTP_MAX_RECIPIENTS_PER_MESSAGE = "YOUR_VALUE"
QURL_SMTP_MAX_RECIPIENTS_PER_HOUR = "YOUR_VALUE"
```
需要环境变量：QURL_API_KEY, QURL_API_URL, QURL_CONNECTOR_URL, QURL_MCP_CONFIG, MCP_MAX_UPLOAD_FILE_DATA_BYTES, QURL_SMTP_HOST, QURL_SMTP_PORT, QURL_SMTP_SECURE, QURL_SMTP_USERNAME, QURL_SMTP_PASSWORD, QURL_SMTP_FROM_EMAIL, QURL_SMTP_FROM_NAME, QURL_SMTP_ALLOWED_RECIPIENTS, QURL_SMTP_ALLOWED_RECIPIENT_DOMAINS, QURL_SMTP_MAX_RECIPIENTS_PER_MESSAGE, QURL_SMTP_MAX_RECIPIENTS_PER_HOUR

### Cursor
配置文件 .cursor/mcp.json：
```json
{
  "mcpServers": {
    "io-github-layervai-qurl-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@layervai/qurl-mcp"
      ],
      "env": {
        "QURL_API_KEY": "YOUR_VALUE",
        "QURL_API_URL": "YOUR_VALUE",
        "QURL_CONNECTOR_URL": "YOUR_VALUE",
        "QURL_MCP_CONFIG": "YOUR_VALUE",
        "MCP_MAX_UPLOAD_FILE_DATA_BYTES": "YOUR_VALUE",
        "QURL_SMTP_HOST": "YOUR_VALUE",
        "QURL_SMTP_PORT": "YOUR_VALUE",
        "QURL_SMTP_SECURE": "YOUR_VALUE",
        "QURL_SMTP_USERNAME": "YOUR_VALUE",
        "QURL_SMTP_PASSWORD": "YOUR_VALUE",
        "QURL_SMTP_FROM_EMAIL": "YOUR_VALUE",
        "QURL_SMTP_FROM_NAME": "YOUR_VALUE",
        "QURL_SMTP_ALLOWED_RECIPIENTS": "YOUR_VALUE",
        "QURL_SMTP_ALLOWED_RECIPIENT_DOMAINS": "YOUR_VALUE",
        "QURL_SMTP_MAX_RECIPIENTS_PER_MESSAGE": "YOUR_VALUE",
        "QURL_SMTP_MAX_RECIPIENTS_PER_HOUR": "YOUR_VALUE"
      }
    }
  }
}
```
一键安装：cursor://anysphere.cursor-deeplink/mcp/install?name=io-github-layervai-qurl-mcp&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBsYXllcnZhaS9xdXJsLW1jcCJdLCJlbnYiOnsiUVVSTF9BUElfS0VZIjoiWU9VUl9WQUxVRSIsIlFVUkxfQVBJX1VSTCI6IllPVVJfVkFMVUUiLCJRVVJMX0NPTk5FQ1RPUl9VUkwiOiJZT1VSX1ZBTFVFIiwiUVVSTF9NQ1BfQ09ORklHIjoiWU9VUl9WQUxVRSIsIk1DUF9NQVhfVVBMT0FEX0ZJTEVfREFUQV9CWVRFUyI6IllPVVJfVkFMVUUiLCJRVVJMX1NNVFBfSE9TVCI6IllPVVJfVkFMVUUiLCJRVVJMX1NNVFBfUE9SVCI6IllPVVJfVkFMVUUiLCJRVVJMX1NNVFBfU0VDVVJFIjoiWU9VUl9WQUxVRSIsIlFVUkxfU01UUF9VU0VSTkFNRSI6IllPVVJfVkFMVUUiLCJRVVJMX1NNVFBfUEFTU1dPUkQiOiJZT1VSX1ZBTFVFIiwiUVVSTF9TTVRQX0ZST01fRU1BSUwiOiJZT1VSX1ZBTFVFIiwiUVVSTF9TTVRQX0ZST01fTkFNRSI6IllPVVJfVkFMVUUiLCJRVVJMX1NNVFBfQUxMT1dFRF9SRUNJUElFTlRTIjoiWU9VUl9WQUxVRSIsIlFVUkxfU01UUF9BTExPV0VEX1JFQ0lQSUVOVF9ET01BSU5TIjoiWU9VUl9WQUxVRSIsIlFVUkxfU01UUF9NQVhfUkVDSVBJRU5UU19QRVJfTUVTU0FHRSI6IllPVVJfVkFMVUUiLCJRVVJMX1NNVFBfTUFYX1JFQ0lQSUVOVFNfUEVSX0hPVVIiOiJZT1VSX1ZBTFVFIn19
需要环境变量：QURL_API_KEY, QURL_API_URL, QURL_CONNECTOR_URL, QURL_MCP_CONFIG, MCP_MAX_UPLOAD_FILE_DATA_BYTES, QURL_SMTP_HOST, QURL_SMTP_PORT, QURL_SMTP_SECURE, QURL_SMTP_USERNAME, QURL_SMTP_PASSWORD, QURL_SMTP_FROM_EMAIL, QURL_SMTP_FROM_NAME, QURL_SMTP_ALLOWED_RECIPIENTS, QURL_SMTP_ALLOWED_RECIPIENT_DOMAINS, QURL_SMTP_MAX_RECIPIENTS_PER_MESSAGE, QURL_SMTP_MAX_RECIPIENTS_PER_HOUR