# 🔧 将你的 AI 连接至 Taskr

## 2.8 其他 AI 工具

如果你使用的是其他支持 MCP 的工具，以下是通用的设置方式。

### 交互式工具（带浏览器）

多数现代 AI 工具都可以通过网络连接到一个**远程 MCP 服务器**。把你的工具指向 Taskr 的网址即可 —— 无需安装，也无需密钥。首次连接时，你会通过浏览器登录：

```json
{
  "taskr": {
    "url": "https://www.taskr.one/api/mcp"
  }
}
```

有些工具会用稍微不同的键名来表示这个地址（例如 `serverUrl`），或者需要一个 `"type": "http"` 字段 —— 请查阅你工具的 MCP 文档。当工具连接时，它会打开你的浏览器让你登录并批准。

### 无头工具（服务器、CI、无浏览器）

如果你的工具运行在一台没有浏览器的服务器上，请改用 **API 密钥**，把它作为一个请求标头 (request header) 发送，而不是进行浏览器登录：

```
x-user-api-key: YOUR_API_KEY_HERE
```

从 Taskr 获取你的 API 密钥（个人资料 → **API Keys**）。把工具指向 `https://www.taskr.one/api/mcp` 并加上上面这个标头。若要固定某个项目，再发送 `x-project-id: PR_...`（可选）。

### 旧方案：本地 `npx` 桥接器

如果你的工具只支持本地 (stdio) MCP 服务器，无法访问网址，你仍然可以运行本地连接器（需要 Node.js）：

```json
{
  "taskr": {
    "command": "npx",
    "args": ["-y", "taskr-mcp-client@latest"]
  }
}
```

它会在首次运行时通过你的浏览器帮你登录（或运行一次 `npx taskr-mcp-client@latest auth`）。若要用于无头环境，请加入一个带 `MCP_USER_API_KEY` 的 `env` 区块。

### 该把它放在哪里

寻找：
- 文件名包含 "mcp" 并以 `.json` 结尾的文件
- 提及 "MCP" 或 "Model Context Protocol" 的设置或首选项
- 关于 "external tools (外部工具)" 或 "integrations (集成)" 的文档说明

---