Cursor / Claude Desktop

把 Textira MCP 挂到 Cursor 或 Claude Desktop，用任意对话模型（含 DeepSeek、Claude 等）检索与问答空间内资料。

接入前准备

项	说明
空间 slug	建库返回的 `knowledge_base.slug`，或控制台空间地址里的短名
MCP URL	推荐 `https://<公网主机>/{slug}/mcp`（已锁空间）
`sv_…`	Textira 设置页创建的 API 密钥

控制台也可：打开空间 →「复制 MCP」，或设置页复制锁定空间的 JSON（与下文 url + headers 格式一致）。

本机调试：http://localhost:8080/{slug}/mcp（MCP 服务须已启动）
远端 / 云端客户端：须公网 HTTPS；127.0.0.1 连不上

两种入口（/{slug}/mcp 与全局 /mcp）见 MCP 工具 · 入口。

流程图加载中…

Cursor

配置文件：~/.cursor/mcp.json（全局）或项目内 .cursor/mcp.json。

{
  "mcpServers": {
    "wenxian-bianyi": {
      "url": "https://<公网主机>/<slug>/mcp",
      "headers": {
        "Authorization": "Bearer sv_你的密钥"
      }
    }
  }
}

本地示例：

{
  "mcpServers": {
    "wenxian-bianyi": {
      "url": "http://localhost:8080/<slug>/mcp",
      "headers": {
        "Authorization": "Bearer sv_你的密钥"
      }
    }
  }
}

保存后完全重启 Cursor。在对话里启用该 MCP，先让模型 guide，再 search / read。

按学科检索时，在问题里写明科目，模型应调用 search(..., tags=[...])（见 MCP 工具 · tags）。

Claude Desktop

配置文件（macOS）：~/Library/Application Support/Claude/claude_desktop_config.json。

若客户端直接支持远程 url，写法与 Cursor 相同。若只支持 stdio，用 mcp-remote 桥接（见下一节）。改完后重启 Claude Desktop。

仅支持 stdio 时：`npx mcp-remote`

{
  "mcpServers": {
    "wenxian-bianyi": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://<公网主机>/<slug>/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer sv_你的密钥"
      }
    }
  }
}

说明：

需本机已安装 Node.js（提供 npx）。
部分客户端对 args 里带空格的参数处理有问题，故用 Authorization:${AUTH_HEADER} + env，避免在 args 里写 Bearer xxx。
本地调试把 URL 换成 http://localhost:8080/<slug>/mcp。

全局入口 `/mcp`

未使用 /{slug}/mcp 时：

"url": "https://<公网主机>/mcp"

须在对话中明确空间，并让模型传 knowledge_base=<slug>。更稳妥仍用锁定空间的 /{slug}/mcp。

鉴权对照

用途	凭证
连接 Textira MCP	`headers.Authorization: Bearer sv_…`
Cursor / Claude 所选模型	各产品自己的账号 / API Key（与 `sv_` 无关）

常见踩坑：把模型平台的 sk- 填进 MCP headers，或把 sv_ 当成模型密钥。