第 2 课

接入 MCP：Claude Code / Cursor + API Key

按官方 MCP Docs：先索引文档，再配置 https://api.pageindex.ai/mcp，用 Bearer API Key 在 Claude Code / Cursor 验证。

图文23 分钟

课程目录第 2 / 2 课

学习位置仅保存在当前浏览器，有效期 180 天。

来源：PageIndex · MCP for Developers、pageindex.ai/mcp。开发者 MCP 端点：https://api.pageindex.ai/mcp；鉴权为 Bearer API Key（与 REST / Python SDK 同一套 Developer 工作区）。它不与 PageIndex Chat 的个人文件空间共用。

你将得到什么

Claude Code 或 Cursor 中名为 pageindex 的远程 MCP
确认：Agent 能调用 PageIndex 检索类工具，针对课 1 已索引的文档提问

开始前准备

必须先完成课 1：MCP 是检索 / 对话层，官方明确要求文档已在 PageIndex Cloud 建好索引后再接 MCP。
同一把 Developer Dashboard API Key（与 PAGEINDEX_API_KEY 相同）。
已安装 Claude Code 或 Cursor。

核心事实

项	官方值
开发者 MCP URL	`https://api.pageindex.ai/mcp`
鉴权	`Authorization: Bearer <API_Key>`
配置键名建议	`pageindex`
文件空间	与 REST / SDK 同一 Developer 工作区
Chat 用户 OAuth 端点（本课不主讲）	`https://chat.pageindex.ai/mcp`
本地可上传 PDF 的 npx（可选）	`npx -y pageindex-mcp` 或 `@pageindex/mcp`（以官方 landing / npm 为准）

步骤 1：确认文档已在 Cloud

在课 1 的 Python 环境：

from pageindex import PageIndexClient
client = PageIndexClient(index="cloud", chat="gpt-5.6-sol")
print(client.list_documents())

对照结果：列表中能看到课 1 的 doc_id / 文件名。若为空，先回到课 1 submit_document。

步骤 2：Cursor 注册（HTTP + API Key）

按官方 MCP Docs，编辑用户级 ~/.cursor/mcp.json（或 Settings → MCP → Add）：

{
  "mcpServers": {
    "pageindex": {
      "type": "http",
      "url": "https://api.pageindex.ai/mcp",
      "headers": {
        "Authorization": "Bearer your_api_key"
      }
    }
  }
}

把 your_api_key 换成真实 Key；不要把该文件提交到公开仓库。

保存后重载 MCP。对照结果：MCPs 列表中 pageindex 为 Connected / 带工具数量（文案以 Cursor 版本为准）。

步骤 3：Claude Code 注册

若客户端支持 HTTP MCP 与 header，等价配置为同一 URL + Bearer。也可用官方推荐的 Agent 引导：

Read https://docs.pageindex.ai/SKILL.md and follow it to set up PageIndex in this project.

或在支持 claude mcp add 的版本中，按你本机 Claude Code 文档为远程 HTTP 服务添加 pageindex，并带上：

Authorization: Bearer <YOUR_API_KEY>

对照结果：claude mcp list（或客户端 MCP 面板）显示 pageindex 已连接。

步骤 4：用一句提示词验证

在已挂载 MCP 的对话里发送（把文件名换成你的）：

Using PageIndex MCP, list my indexed documents and summarize the key findings in 2023-annual-report.pdf with citations if available.

对照结果：Agent 调用 PageIndex 相关工具后，返回与课 1 文档一致的摘要；若提示无权 / 空库，检查 Bearer Key 是否为 Developer Key，以及文档是否在同一工作区。

步骤 5：（可选）本地 MCP 与 Chat OAuth

本地上传 PDF：官方 / npm 提供 npx -y pageindex-mcp（Node ≥ 18）一类本地 STDIO 服务，适合需要本机选文件的场景；配置形态为 command + args，见 pageindex.ai/mcp。
PageIndex Chat 用户：端点 https://chat.pageindex.ai/mcp，走 OAuth；文件在 Chat 空间，与本课 Developer API Key 工作区分离——不要混用后以为「课 1 的 doc_id 不见了」。

本课检查清单

list_documents 能看到课 1 文档
Cursor 或 Claude Code 中 pageindex MCP Connected
验证提示词能基于已索引 PDF 作答