Cursor

在尝试 OAuth 前，请在 **`oauth_clients`** 登记 **`pairag_mcp_cursor`**（`audience=mcp`）并包含 Cursor 回调 URI。

在 Cursor 中一键添加

使用 Cursor 官方 **MCP 安装 deeplink**（见 Cursor 文档 *MCP install links*）。系统会唤起 Cursor，并写入 Pairag 的 **url** 与静态 **auth.CLIENT_ID**（公开客户端）。随后在 Cursor **设置 → MCP** 中对 Pairag 点 **Connect**：浏览器打开 **app.pairag.com** 完成登录与授权；完成后通过 **`cursor://anysphere.cursor-mcp/oauth/callback`** 回到 Cursor（该回调须在 **`oauth_clients`** 中精确登记）。

打开 Cursor 并添加 Pairag

前置条件

数据库 `oauth_clients`：`client_id=pairag_mcp_cursor`，`redirect_uris` 含 `cursor://anysphere.cursor-mcp/oauth/callback`，`audience=mcp`。
**Issuer 元数据**须可从 `https://app.pairag.com/.well-known/oauth-authorization-server` 访问。

mcp.json 模板

粘贴到 macOS/Linux 的 **~/.cursor/mcp.json**，或 Windows 的 **%USERPROFILE%\.cursor\mcp.json**，保存后**完全重启 Cursor**。

{
  "mcpServers": {
    "pairag": {
      "url": "https://api.pairag.com/mcp"
    }
  }
}

OAuth 流程

打开 Cursor **Settings → MCP**，在 Pairag 一行点击 **Connect**，在系统浏览器完成登录与授权；Cursor 使用 **PKCE** 换取令牌。

Bearer 兜底

若暂无法使用 OAuth，可在配置中为 MCP 请求添加 **静态 MCP access token 或 PAT**（务必高频轮换）。

{
  "mcpServers": {
    "pairag": {
      "url": "https://api.pairag.com/mcp",
      "headers": {
        "Authorization": "Bearer ${PAIRAG_MCP_TOKEN}"
      }
    }
  }
}

`${{PAIRAG_MCP_TOKEN}}` 仅为示意 —— 请在 shell 中导出变量或粘贴替换后再复制配置。

校验令牌

使用 MCP access token 执行 curl，应返回 HTTP 200 与 JSON：

curl -sS -H "Authorization: Bearer <MCP_ACCESS_TOKEN>" https://api.pairag.com/api/v1/mcp/v1/me

← 文档首页·首页