PAIRAG

Claude Code

在 Claude Code **原生 OAuth** 对接 Pairag 之前，推荐使用 **Streamable HTTP + `Authorization` 请求头**（见 CLI 模板）。

请先确认：是 Claude Code，不是 Claude Desktop

本页「装进 MCP」指的是 **Anthropic Claude Code**（终端或官方提供的 Claude Code 桌面 / IDE 形态，用于写代码、可执行 `/mcp`）。日常聊天的 **Claude Desktop**（紫色图标、无 `/mcp`）使用另一份配置文件，**不会**读取本页命令写入的 `~/.claude.json`。若在 Desktop 里找 Pairag，是看不到的。

步骤一：在系统终端一键写入 Claude Code 的 MCP 配置

在 macOS「终端」或 Windows「命令提示符 / PowerShell」中执行（不是浏览器、也不是 Claude 里的聊天输入框）。需本机已安装 **Node.js** 以便 `npx` 下载并运行 **add-mcp**。成功后终端应出现类似「Installed to … Claude Code … ~/.claude.json」的提示。

npx -y add-mcp "https://api.pairag.com/mcp" -g -a claude-code -y

步骤二：配置写到了哪里

命令会向 **Claude Code** 的全局 MCP 清单写入名为 **pairag** 的远程服务器（Streamable HTTP，指向 Pairag 生产 MCP 根路径）。这与 Cursor 的 `~/.cursor/mcp.json` 无关；也不会写入 Claude Desktop 的配置。

用户级 MCP 在 Claude Code 中通常位于主目录下的 **~/.claude.json**（文件名即如此，**不是** `~/.claude/` 子目录里的文件）。macOS 上 Claude Desktop 使用的是 **~/Library/Application Support/Claude/claude_desktop_config.json**，请勿混用。

步骤三：在 Claude Code 里确认「已经装进 MCP」

  • 打开 **Claude Code**（与完成安装的终端在同一用户、同一台电脑上）。
  • **完全退出** Claude Code 再重新打开一次，确保重新读取 `~/.claude.json`（部分版本在热更新时不会立刻刷新 MCP 列表）。
  • 在 Claude Code 中输入命令 **`/mcp`**（以官方界面为准： slash 命令或 MCP 状态入口），应能看到 **pairag** 及连接状态。
  • 若列表为空：在本机终端执行 `grep pairag ~/.claude.json`，若无输出则说明未写入成功，请检查 Node / 网络后重跑步骤一的命令。

若你所在组织为 Claude Code 配置了 MCP 托管白名单（例如 allowedMcpServers），需管理员放行 **pairag** 后，客户端才会显示该服务器。

CLI 模板

每台开发机执行一次（若 Anthropic 更新 CLI 参数，请以官方文档为准）：

claude mcp add --transport http pairag https://api.pairag.com/mcp --header "Authorization: Bearer <YOUR_TOKEN>"

将 `YOUR_TOKEN` 替换为 OAuth 颁发的 MCP access JWT（`aud=mcp`），或通过 POST …/personal-access-tokens 拿到的 **`pgpat_`** PAT。

OAuth 规划

完成上文步骤三、在 **`/mcp`** 中看到 **pairag** 后，按 Claude Code 官方流程在浏览器中登录 Pairag 并完成授权（令牌由 Claude Code 保存）。若浏览器回跳未回到终端，请在 CLI 提示时粘贴地址栏中的回调 URL。亦可参见 Anthropic Claude Code MCP 文档。上文「步骤一」使用社区工具 **add-mcp** 写入全局配置，避免手改 JSON。

校验令牌

与 Cursor 相同的自检命令：

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

← 文档首页·首页