de en es ja ko ru zh

PipesHub MCP Server

Name: PipesHub MCP Server
Author: pipeshub-ai

Official

by pipeshub-ai

Overview Schema Related Servers Score Discussions

TypeScript

Hybrid

将 MCP 客户端连接到 PipesHub MCP 服务器

本指南介绍如何使用静态 OAuth 凭据或 Bearer 令牌，将 PipesHub 的远程 MCP 服务器连接到 Cursor、Claude Code、Gemini CLI、Codex CLI、Claude.ai（网页版） 和 LibreChat。

PipesHub 通过 Streamable HTTP 在 /mcp 端点暴露远程 MCP 服务。MCP 客户端直接连接到此端点——无需本地 npm 包或 stdio 进程。

正在使用编码代理？ 请从面向编码代理开始。使用 npx skills add pipeshub-ai/mcp-server 将技能安装到用户的仓库中（参见 skills/pipeshub）。在本仓库中工作的贡献者：请阅读 AGENTS.md。
正在查找工具参考？ 请参阅 TOOLS.md，了解 MCP 服务器暴露的每个工具（pipeshub_chat、pipeshub_search、pipeshub_get_record_content、pipeshub_download_record、pipeshub_directory、pipeshub_sources、pipeshub_agents）的描述、参数和决策指南。
正在使用 QM？ QM 无法挂载第三方 MCP 端点——它是其自身框架的 MCP 服务器，而非客户端。请按照将 PipesHub 与 QM 结合使用操作。qm/ 中的部署层捆绑包为代理在其沙箱内提供了 pipeshub 命令；此包将该命令作为第二个 bin 发布。

前置条件

一个正在运行的 PipesHub 实例（自托管或云端）
在 PipesHub 中创建的 OAuth 应用（参见步骤 1）

Related MCP server: Rocket.Chat MCP Server

步骤 1：在 PipesHub 中创建 OAuth 应用

以管理员身份登录你的 PipesHub 实例
导航到 设置 > 开发者设置 > OAuth 应用
点击 创建 OAuth 应用

填写应用详情：

名称：例如 MCP Integration

重定向 URI：添加你计划使用的所有客户端的重定向 URI：

客户端	重定向 URI
Cursor	`cursor://anysphere.cursor-mcp/oauth/callback`
Claude Code	`http://localhost:<PORT>/callback`（例如 `http://localhost:8080/callback`）
Claude.ai（网页版）	`https://claude.ai/api/mcp/auth_callback`
Gemini CLI	`http://localhost:7777/oauth/callback`
LibreChat	`http://localhost:3080/api/mcp/<server-identifier>/oauth/callback`

重要提示：MCP_SCOPES 中的作用域必须与你授予 OAuth 应用的作用域匹配——不匹配将导致授权错误。

保存应用并复制 客户端 ID 和 客户端密钥

自定义默认作用域

默认情况下，PipesHub 在其 /.well-known/oauth-protected-resource/mcp 发现端点中暴露一些默认作用域。你可以通过在你的 PipesHub 实例上设置 MCP_SCOPES 环境变量来自定义暴露哪些作用域。这对于像 Claude Code 这样会自动请求所有暴露作用域的客户端非常有用。

占位符

在以下所有配置中替换这些内容：

占位符	描述	示例
`PIPESHUB_INSTANCE_URL`	你的 PipesHub 实例 URL	`https://app.pipeshub.com`
`YOUR_CLIENT_ID`	OAuth 应用客户端 ID	`clid_abc123...`
`YOUR_CLIENT_SECRET`	OAuth 应用客户端密钥	`clsec_xyz789...`

远程 MCP 端点 URL 为：PIPESHUB_INSTANCE_URL/mcp

远程 MCP 设置

Cursor 通过 mcp.json 中的 auth 对象支持远程 MCP 服务器的静态 OAuth。

配置

打开 Cursor 设置 > 工具与集成 > 新建 MCP 服务器，或编辑你项目的 .cursor/mcp.json：

{
  "mcpServers": {
    "pipeshub": {
      "url": "PIPESHUB_INSTANCE_URL/mcp",
      "auth": {
        "CLIENT_ID": "YOUR_CLIENT_ID",
        "CLIENT_SECRET": "YOUR_CLIENT_SECRET",
        "scopes": [
          "org:read", "org:write", "org:admin",
          "user:read", "user:write", "user:invite", "user:delete",
          "usergroup:read", "usergroup:write",
          "team:read", "team:write",
          "kb:read", "kb:write", "kb:delete", "kb:upload",
          "semantic:read", "semantic:write", "semantic:delete",
          "conversation:read", "conversation:write", "conversation:chat",
          "agent:read", "agent:write", "agent:execute",
          "connector:read", "connector:write", "connector:sync", "connector:delete",
          "config:read", "config:write",
          "document:read", "document:write", "document:delete",
          "crawl:read", "crawl:write", "crawl:delete"
        ]
      }
    }
  }
}

Cursor 将通过 PipesHub 的 /.well-known/oauth-protected-resource/mcp 元数据自动发现授权端点和令牌端点。

注意： 如果省略 scopes 字段，Cursor 会获取 /.well-known/oauth-protected-resource/mcp 并请求其中列出的所有 scopes_supported。要限制访问范围，请仅显式列出你需要的范围。你还可以在服务端控制暴露哪些作用域——参见自定义默认作用域。

使用环境变量

使用 Cursor 的 ${env:VAR} 插值将密钥保留在配置文件之外：

{
  "mcpServers": {
    "pipeshub": {
      "url": "${env:PIPESHUB_INSTANCE_URL}/mcp",
      "auth": {
        "CLIENT_ID": "${env:PIPESHUB_CLIENT_ID}",
        "CLIENT_SECRET": "${env:PIPESHUB_CLIENT_SECRET}",
        "scopes": [
          "kb:read", "kb:write",
          "semantic:read", "semantic:write",
          "conversation:read", "conversation:write", "conversation:chat",
          "agent:read", "agent:write", "agent:execute",
          "connector:read", "connector:write",
          "config:read", "user:read"
        ]
      }
    }
  }
}

重定向 URI

Cursor 对所有 MCP 服务器使用固定的重定向 URI：

cursor://anysphere.cursor-mcp/oauth/callback

在 PipesHub 中创建 OAuth 应用时，将此注册为允许的重定向 URI。

OAuth 登录故障排除

如果 Cursor 的内部浏览器无法加载 OAuth 登录页面，请从内部浏览器复制授权 URL，粘贴到你的常规浏览器中完成登录流程。

Claude Code 通过 --client-id、--client-secret 和 --callback-port 支持带有静态 OAuth 凭据的远程 HTTP MCP 服务器。

PipesHub 在 /.well-known/oauth-protected-resource/mcp 暴露发现端点，因此 Claude Code 会自动发现授权端点和令牌端点。

重要提示： Claude Code 不支持配置特定作用域。它会获取 /.well-known/oauth-protected-resource/mcp，读取 scopes_supported 列表，并请求所有作用域。你在 PipesHub 中的 OAuth 应用必须有权访问发现端点中列出的所有作用域，否则授权请求将失败。要限制暴露的作用域，请参见自定义默认作用域。

使用 CLI 添加

claude mcp add --transport http \
  --client-id YOUR_CLIENT_ID \
  --client-secret \
  --callback-port 8080 \
  pipeshub PIPESHUB_INSTANCE_URL/mcp

不带值的 --client-secret 会提示输入掩码。要跳过提示，请设置 MCP_CLIENT_SECRET 环境变量：
MCP_CLIENT_SECRET=YOUR_CLIENT_SECRET claude mcp add --transport http \
  --client-id YOUR_CLIENT_ID \
  --client-secret \
  --callback-port 8080 \
  pipeshub PIPESHUB_INSTANCE_URL/mcp

要使其在所有项目中可用：

claude mcp add --transport http --scope user \
  --client-id YOUR_CLIENT_ID \
  --client-secret \
  --callback-port 8080 \
  pipeshub PIPESHUB_INSTANCE_URL/mcp

使用 JSON 添加

claude mcp add-json pipeshub '{
  "type": "http",
  "url": "PIPESHUB_INSTANCE_URL/mcp",
  "oauth": {
    "clientId": "YOUR_CLIENT_ID",
    "callbackPort": 8080
  }
}' --client-secret

项目级作用域（`.mcp.json`）

在项目根目录创建 .mcp.json 文件。此文件可以提交到版本控制（密钥通过环境变量保持在外）：

{
  "mcpServers": {
    "pipeshub": {
      "type": "http",
      "url": "${PIPESHUB_INSTANCE_URL}/mcp",
      "oauth": {
        "clientId": "${PIPESHUB_CLIENT_ID}",
        "callbackPort": 8080
      }
    }
  }
}

在启动 Claude Code 之前设置环境变量：

export PIPESHUB_INSTANCE_URL="https://app.pipeshub.com"
export PIPESHUB_CLIENT_ID="your-client-id"

注意： 客户端密钥存储在系统钥匙串中，而非配置文件中。首次通过 /mcp 进行身份验证时，系统会提示你输入。

身份验证

添加服务器后，在 Claude Code 中运行 /mcp 并按照浏览器登录流程操作。令牌会安全存储并自动刷新。

验证

claude mcp list
claude mcp get pipeshub

Gemini CLI 通过 dynamic_discovery（默认）支持带有 OAuth 的远程 MCP 服务器，该模式会从 PipesHub 的 /.well-known/oauth-protected-resource/mcp 自动发现授权端点和令牌端点。

选项 A：设置文件

编辑 ~/.gemini/settings.json：

{
  "mcpServers": {
    "pipeshub": {
      "url": "PIPESHUB_INSTANCE_URL/mcp",
      "oauth": {
        "clientId": "YOUR_CLIENT_ID",
        "clientSecret": "YOUR_CLIENT_SECRET",
        "scopes": [
          "org:read", "org:write", "org:admin",
          "user:read", "user:write", "user:invite", "user:delete",
          "usergroup:read", "usergroup:write",
          "team:read", "team:write",
          "kb:read", "kb:write", "kb:delete", "kb:upload",
          "semantic:read", "semantic:write", "semantic:delete",
          "conversation:read", "conversation:write", "conversation:chat",
          "agent:read", "agent:write", "agent:execute",
          "connector:read", "connector:write", "connector:sync", "connector:delete",
          "config:read", "config:write",
          "document:read", "document:write", "document:delete",
          "crawl:read", "crawl:write", "crawl:delete"
        ]
      }
    }
  }
}

注意： 调整 scopes 列表以匹配你的 OAuth 应用被授予的作用域。如果你只需要一部分工具，可以相应地限制作用域。

选项 B：CLI 命令

gemini mcp add --transport http pipeshub PIPESHUB_INSTANCE_URL/mcp

然后编辑 ~/.gemini/settings.json，按上述方式添加 oauth 块。

身份验证

在 Gemini CLI 内部，使用 /mcp auth 命令：

# List servers and their auth status
/mcp auth

# Authenticate with PipesHub (opens browser for login)
/mcp auth pipeshub

# Re-authenticate if tokens expire
/mcp auth pipeshub

首次连接时，Gemini 会自动检测 401 响应、发现 OAuth 端点并打开浏览器进行登录。令牌安全存储在 ~/.gemini/mcp-oauth-tokens.json 中并自动刷新。

管理服务器

# List all configured servers
gemini mcp list

# Remove the server
gemini mcp remove pipeshub

# Temporarily disable/enable
gemini mcp disable pipeshub
gemini mcp enable pipeshub

OAuth 配置属性

属性	必需	描述
`clientId`	是	来自 PipesHub 的 OAuth 2.0 客户端 ID
`clientSecret`	否	OAuth 2.0 客户端密钥（用于机密客户端）
`scopes`	否	要请求的 OAuth 作用域
`authorizationUrl`	否	覆盖授权端点（默认自动发现）
`tokenUrl`	否	覆盖令牌端点（默认自动发现）
`redirectUri`	否	覆盖重定向 URI（默认为 `http://localhost:7777/oauth/callback`）

注意： OAuth 需要本地浏览器。在无头环境、没有 X11 转发的远程 SSH 或没有浏览器访问权限的容器中无法工作。

Codex CLI（OpenAI Codex）通过 Streamable HTTP 连接远程 MCP 服务器，在 ~/.codex/config.toml（或项目根目录下的 .codex/config.toml 以限定项目范围）中配置 [mcp_servers.<name>] 表。Codex 的 HTTP 传输使用从环境变量读取的 bearer 令牌 进行身份验证，因此请传入 PipesHub JWT bearer 令牌。

[mcp_servers.pipeshub]
url = "PIPESHUB_INSTANCE_URL/mcp"
bearer_token_env_var = "PIPESHUB_BEARER_TOKEN"

bearer_token_env_var 是保存令牌的环境变量的名称——在启动 Codex 之前导出它：

export PIPESHUB_BEARER_TOKEN="YOUR_BEARER_TOKEN"

令牌是原始 JWT，不带 Bearer 关键字。

或者使用 CLI 添加：

codex mcp add pipeshub \
  --url PIPESHUB_INSTANCE_URL/mcp \
  --bearer-token-env-var PIPESHUB_BEARER_TOKEN

--bearer-token-env-var 接受保存令牌的环境变量的名称，而非令牌值本身。

验证

# List configured MCP servers
codex mcp list

# Inside the Codex TUI, view server status and available tools
/mcp

Claude.ai 通过远程 MCP 服务器支持自定义连接器。这让你无需任何本地设置即可直接在 Claude.ai 网页界面中使用 PipesHub 工具。

注意： 此功能目前处于测试阶段。免费计划用户仅限于一个自定义连接器。

Claude.ai 连接器设置

Claude.ai 添加自定义连接器对话框

对于个人用户（Pro / Max 计划）

前往 claude.ai 并导航到 设置 > 连接器
点击连接器部分底部的 添加自定义连接器
输入 MCP 服务器 URL：
```
PIPESHUB_INSTANCE_URL/mcp
```
点击 高级设置 并输入你的 OAuth 凭据：
- OAuth 客户端 ID：YOUR_CLIENT_ID
- OAuth 客户端密钥：YOUR_CLIENT_SECRET
点击添加
你将被重定向到 PipesHub 的登录页面进行身份验证并授予权限
身份验证完成后，连接器将处于活动状态，PipesHub 工具将在你的 Claude.ai 对话中可用

对于团队 / 企业计划

组织所有者必须首先添加连接器：

导航到 组织设置 > 连接器
点击 添加自定义连接器
输入 MCP 服务器 URL：PIPESHUB_INSTANCE_URL/mcp
点击 高级设置 并输入 OAuth 客户端 ID 和客户端密钥
点击添加

团队成员随后可以连接：

前往 设置 > 连接器
找到 PipesHub 连接器（标有"自定义"标签）
点击连接通过 PipesHub 的 OAuth 登录进行身份验证

重定向 URI

Claude.ai 使用以下重定向 URI 进行 OAuth：

https://claude.ai/api/mcp/auth_callback

在你的 PipesHub OAuth 应用中将其注册为允许的重定向 URI。

安全说明

仅连接到受信任的 MCP 服务器
在 OAuth 身份验证流程中审查请求的权限
Claude.ai 使用授予的 OAuth 令牌代表你与 PipesHub 交互——你的密码永远不会被共享

LibreChat 通过其自定义连接器 UI 支持带有 OAuth 身份验证的远程 MCP 服务器。这让你可以将 PipesHub 工具连接到 LibreChat 实例中可用的任何模型。

LibreChat MCP 配置

配置

将以下英文文本翻译成中文：

登录你的 LibreChat 实例
导航到 MCP 服务器 设置面板
点击添加创建新的自定义 MCP 连接器
填写连接器详细信息：
- 名称：PipesHub（或你喜欢的任何名称）
- MCP 服务器 URL：PIPESHUB_INSTANCE_URL/mcp
- 传输方式：选择 Streamable HTTP
- 认证方式：选择 OAuth
输入你的 OAuth 凭据：
- 客户端 ID：YOUR_CLIENT_ID
- 客户端密钥：YOUR_CLIENT_SECRET
- 授权 URL：PIPESHUB_INSTANCE_URL/api/v1/oauth2/authorize
- 令牌 URL：PIPESHUB_INSTANCE_URL/api/v1/oauth2/token
- 作用域：openid email（或根据需要添加其他作用域）
勾选 我信任此应用程序
点击添加保存连接器
添加后，LibreChat 会生成一个 重定向 URI，显示在连接器设置面板中（复制按钮旁边）。其格式如下：
```
http://localhost:3080/api/mcp/<server-identifier>/oauth/callback
```
复制重定向 URI，并在你的 PipesHub OAuth 应用中将其注册为允许的重定向 URI（参见第 1 步）
返回 LibreChat 连接器，点击更新启动 OAuth 流程——你将被重定向到 PipesHub 的登录页面进行身份验证并授予权限

重定向 URI

LibreChat 会在 连接器创建后 生成重定向 URI。其格式如下：

http://localhost:3080/api/mcp/<server-identifier>/oauth/callback

其中 <server-identifier> 是 LibreChat 分配的唯一标识符（显示在连接器设置顶部的"唯一服务器标识符"处）。你必须复制此 URI 并添加到 PipesHub OAuth 应用的允许重定向 URI 列表中，然后才能进行身份验证。

注意： 如果你的 LibreChat 实例运行在不同的主机或端口上，URI 会相应变化（例如 https://chat.example.com/api/mcp/pipeshub/oauth/callback）。

作用域

LibreChat 允许你在 作用域 字段中指定 OAuth 作用域。使用空格分隔的列表：

openid email

要请求 PipesHub 特定的作用域，请将其添加到作用域字段中：

openid email org:read kb:read kb:write semantic:read conversation:read conversation:write conversation:chat agent:read agent:execute

注意： 你请求的作用域必须与 PipesHub 中授予 OAuth 应用的作用域一致。详见自定义默认作用域。

本地 MCP 服务器（Stdio）

如果你不想连接 PipesHub 的远程 MCP 端点，也可以使用 @pipeshub-ai/mcp npm 包将 MCP 服务器作为本地 stdio 进程运行。当你更倾向于本地设置，或需要在无法直接通过 HTTP 连接远程 MCP 端点的环境中工作时，这种方式非常有用。

前提条件

已安装 Node.js 18+
PipesHub 实例 URL
认证凭据：Bearer 令牌（JWT）或 OAuth 客户端 ID + 客户端密钥

占位符

在以下所有配置中替换这些占位符：

占位符	描述	示例
`PIPESHUB_INSTANCE_URL`	你的 PipesHub 实例 URL	`https://app.pipeshub.com`
`YOUR_BEARER_TOKEN`	用于认证的 JWT Bearer 令牌	`eyJhbGci...`
`YOUR_CLIENT_ID`	OAuth 应用客户端 ID	`clid_abc123...`
`YOUR_CLIENT_SECRET`	OAuth 应用客户端密钥	`clsec_xyz789...`

在 Claude Desktop 设置中配置（claude_desktop_config.json）：

{
  "mcpServers": {
    "pipeshub": {
      "command": "npx",
      "args": [
        "@pipeshub-ai/mcp",
        "start",
        "--server-url",
        "PIPESHUB_INSTANCE_URL",
        "--bearer-auth",
        "YOUR_BEARER_TOKEN"
      ]
    }
  }
}

使用 OAuth 凭据：

{
  "mcpServers": {
    "pipeshub": {
      "command": "npx",
      "args": [
        "@pipeshub-ai/mcp",
        "start",
        "--server-url",
        "PIPESHUB_INSTANCE_URL",
        "--client-id",
        "YOUR_CLIENT_ID",
        "--client-secret",
        "YOUR_CLIENT_SECRET",
        "--token-url",
        "/api/v1/oauth2/token"
      ]
    }
  }
}

打开 Cursor 设置 > 工具与集成 > 新建 MCP 服务器，或编辑项目中的 .cursor/mcp.json：

{
  "mcpServers": {
    "pipeshub": {
      "command": "npx",
      "args": [
        "@pipeshub-ai/mcp",
        "start",
        "--server-url",
        "PIPESHUB_INSTANCE_URL",
        "--bearer-auth",
        "YOUR_BEARER_TOKEN"
      ]
    }
  }
}

使用 OAuth 凭据：

{
  "mcpServers": {
    "pipeshub": {
      "command": "npx",
      "args": [
        "@pipeshub-ai/mcp",
        "start",
        "--server-url",
        "PIPESHUB_INSTANCE_URL",
        "--client-id",
        "YOUR_CLIENT_ID",
        "--client-secret",
        "YOUR_CLIENT_SECRET",
        "--token-url",
        "/api/v1/oauth2/token"
      ]
    }
  }
}

claude mcp add pipeshub -- npx -y @pipeshub-ai/mcp start \
  --server-url PIPESHUB_INSTANCE_URL \
  --bearer-auth YOUR_BEARER_TOKEN

使用 OAuth 凭据：

claude mcp add pipeshub -- npx -y @pipeshub-ai/mcp start \
  --server-url PIPESHUB_INSTANCE_URL \
  --client-id YOUR_CLIENT_ID \
  --client-secret YOUR_CLIENT_SECRET \
  --token-url /api/v1/oauth2/token

gemini mcp add pipeshub -- npx -y @pipeshub-ai/mcp start \
  --server-url PIPESHUB_INSTANCE_URL \
  --bearer-auth YOUR_BEARER_TOKEN

使用 OAuth 凭据：

gemini mcp add pipeshub -- npx -y @pipeshub-ai/mcp start \
  --server-url PIPESHUB_INSTANCE_URL \
  --client-id YOUR_CLIENT_ID \
  --client-secret YOUR_CLIENT_SECRET \
  --token-url /api/v1/oauth2/token

将 MCP 服务器作为本地 stdio 进程运行，使用 OAuth 应用的客户端 ID 和客户端密钥进行认证（client_credentials 授权方式）。编辑 ~/.codex/config.toml（或项目根目录下的 .codex/config.toml）：

[mcp_servers.pipeshub]
command = "npx"
args = [
  "-y",
  "@pipeshub-ai/mcp",
  "start",
  "--server-url",
  "PIPESHUB_INSTANCE_URL/api/v1",
  "--client-id",
  "YOUR_CLIENT_ID",
  "--client-secret",
  "YOUR_CLIENT_SECRET",
  "--token-url",
  "/api/v1/oauth2/token",
]

注意事项：

--server-url 必须包含 /api/v1。
--token-url /api/v1/oauth2/token 是必需的。

或者使用 JWT Bearer 令牌进行认证：

[mcp_servers.pipeshub]
command = "npx"
args = [
  "-y",
  "@pipeshub-ai/mcp",
  "start",
  "--server-url",
  "PIPESHUB_INSTANCE_URL/api/v1",
  "--bearer-auth",
  "YOUR_BEARER_TOKEN",
]

打开命令面板 > MCP: 打开用户配置，然后添加：

{
  "mcpServers": {
    "pipeshub": {
      "command": "npx",
      "args": [
        "@pipeshub-ai/mcp",
        "start",
        "--server-url",
        "PIPESHUB_INSTANCE_URL",
        "--bearer-auth",
        "YOUR_BEARER_TOKEN"
      ]
    }
  }
}

打开 Windsurf 设置 > Cascade > 管理 MCP > 查看原始配置，然后添加：

{
  "mcpServers": {
    "pipeshub": {
      "command": "npx",
      "args": [
        "@pipeshub-ai/mcp",
        "start",
        "--server-url",
        "PIPESHUB_INSTANCE_URL",
        "--bearer-auth",
        "YOUR_BEARER_TOKEN"
      ]
    }
  }
}

要从克隆的仓库而不是 npm 包运行本地 MCP 服务器：

git clone https://github.com/pipeshub-ai/pipeshub-ai.git
cd pipeshub-ai
npm install
npm run build
node ./bin/mcp-server.js start --server-url PIPESHUB_INSTANCE_URL --bearer-auth YOUR_BEARER_TOKEN

对于 MCP 客户端配置，将 npx @pipeshub-ai/mcp 替换为 node ./bin/mcp-server.js：

{
  "mcpServers": {
    "pipeshub": {
      "command": "node",
      "args": [
        "./bin/mcp-server.js",
        "start",
        "--server-url",
        "PIPESHUB_INSTANCE_URL",
        "--bearer-auth",
        "YOUR_BEARER_TOKEN"
      ]
    }
  }
}

使用 MCP Inspector 进行调试：

npx @modelcontextprotocol/inspector node ./bin/mcp-server.js start --server-url PIPESHUB_INSTANCE_URL --bearer-auth YOUR_BEARER_TOKEN

CLI 帮助

查看完整的服务器参数列表：

npx @pipeshub-ai/mcp --help

工作原理

架构

AI Client (Cursor / Claude Code / Gemini CLI / Codex CLI / Claude.ai / LibreChat)
        │
        │  HTTP POST (JSON-RPC)
        │  Authorization: Bearer <token>
        ▼
  PIPESHUB_INSTANCE_URL/mcp
        │
        │  StreamableHTTP Transport
        │  (stateless, per-request MCP server)
        ▼
  PipesHub API (curated tool set — see TOOLS.md)

OAuth 受保护资源发现

PipesHub 在以下地址暴露 OAuth 受保护资源发现：

PIPESHUB_INSTANCE_URL/.well-known/oauth-protected-resource/mcp

这将自动返回所有 OAuth 端点：

授权：PIPESHUB_INSTANCE_URL/api/v1/oauth2/authorize
令牌：PIPESHUB_INSTANCE_URL/api/v1/oauth2/token
撤销：PIPESHUB_INSTANCE_URL/api/v1/oauth2/revoke
JWKS：PIPESHUB_INSTANCE_URL/.well-known/jwks.json

故障排除

"不兼容的认证服务器：不支持动态客户端注册"

这意味着客户端正在尝试动态注册，而不是使用你预先配置的凭据。请确保你正确传递了 --client-id 和 --client-secret（Claude Code）或 auth 对象（Cursor）。

认证失败 / 重定向错误

确保 OAuth 应用中的 重定向 URI 与客户端使用的完全匹配：
- Cursor：cursor://anysphere.cursor-mcp/oauth/callback
- Claude Code：http://localhost:<callbackPort>/callback
- Claude.ai：https://claude.ai/api/mcp/auth_callback
- Gemini CLI：http://localhost:7777/oauth/callback
- LibreChat：http://localhost:3080/api/mcp/<server-identifier>/oauth/callback
确保 OAuth 应用在 PipesHub 中处于活跃状态（未被暂停）

无法访问 MCP 端点

验证端点是否可访问：curl -X POST PIPESHUB_INSTANCE_URL/mcp（应返回 401，而不是连接错误）
检查你的 PipesHub 实例是否已启用 MCP

使用 MCP Inspector 调试

npx @modelcontextprotocol/inspector

然后使用 Bearer 令牌连接到 PIPESHUB_INSTANCE_URL/mcp，直接测试端点。

常见问题

更新 PipesHub 实例上的 MCP_SCOPES 环境变量，以包含你希望通过发现端点暴露的新作用域。
更新 PipesHub 中的 OAuth 应用作用域：前往 设置 > 开发者设置 > OAuth 应用，选择你的 OAuth 应用，根据需要添加或删除作用域。
重新认证客户端——现有令牌携带的是旧作用域，因此你需要重新认证才能获得具有更新作用域的新令牌。例如：
- Cursor：移除并重新添加 MCP 服务器，或清除缓存的 OAuth 令牌后重新连接。
- Claude Code：运行 /mcp 并再次完成浏览器登录流程。
- Gemini CLI：运行 /mcp auth pipeshub 重新认证。
- Codex CLI：使用新令牌更新 PIPESHUB_BEARER_TOKEN 并重启 Codex。
- Claude.ai：在 设置 > 连接器 中断开并重新连接连接器。

This server cannot be installed

license - not found

Not graded

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

4wRelease cycle

7Releases (12mo)

Commit activity

Issues opened vs closed

Resources

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

PrivateGPT MCP Server
RAG Systems Knowledge & Memory Agent Orchestration
pgpt-dev
F
license
Not graded
quality
D
maintenance
Facilitates integration of PrivateGPT with MCP-compatible applications, enabling chat functionalities and secure management of knowledge sources and user access.
Updated a year ago (2025-03-07 09:05 UTC)
Rocket.Chat MCP Server
Communication App Automation
elieworkspace
F
license
Not graded
quality
F
maintenance
Enables interaction with Rocket.Chat instances through MCP protocol. Allows users to manage chat operations and integrate with Rocket.Chat servers using natural language commands.
Updated a year ago (2025-08-07 17:35 UTC)
6
Apollo Universal MCP Server
CRM Customer Data Platforms
universal-mcp
A
license
Not graded
quality
D
maintenance
Enables access to Apollo's tools and services through a standardized MCP interface, compatible with MCP-compliant clients.
Updated a year ago (2025-06-14 05:35 UTC)
1
MIT
AnythingLLM MCP Server
AI & Machine Learning RAG Systems
andreperez
A
license
A
quality
C
maintenance
Enables MCP-compatible clients to interact with AnythingLLM, providing tools for workspace management, chat and thread operations, document operations, vector search, and system inspection.
Updated 24 days ago (2026-07-30 17:14 UTC)
34
5
MIT

View all related MCP servers

Related MCP Connectors

SRG+
Manage SRG+ hubs, channels, content, assets, users, and workspaces from any MCP-aware AI agent.
Frenchie
OCR, transcription, file extraction, and image generation for AI agents via MCP.
Kody
Personal assistant MCP server with search, execute, packages, jobs, secrets, and integrations.

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/pipeshub-ai/mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server

将 MCP 客户端连接到 PipesHub MCP 服务器

前置条件

步骤 1：在 PipesHub 中创建 OAuth 应用

自定义默认作用域

占位符

远程 MCP 设置

配置

使用环境变量

重定向 URI

OAuth 登录故障排除

使用 CLI 添加

使用 JSON 添加

项目级作用域（.mcp.json）

身份验证

验证

选项 A：设置文件

选项 B：CLI 命令

身份验证

管理服务器

OAuth 配置属性

验证

对于个人用户（Pro / Max 计划）

对于团队 / 企业计划

重定向 URI

安全说明

配置

重定向 URI

作用域

本地 MCP 服务器（Stdio）

前提条件

占位符

CLI 帮助

工作原理

架构

OAuth 受保护资源发现

故障排除

"不兼容的认证服务器：不支持动态客户端注册"

认证失败 / 重定向错误

无法访问 MCP 端点

使用 MCP Inspector 调试

常见问题

Maintenance

Resources

Looking for Admin?

Related MCP Servers

PrivateGPT MCP Server

Rocket.Chat MCP Server

Apollo Universal MCP Server

AnythingLLM MCP Server

Related MCP Connectors

Latest Blog Posts

MCP directory API

项目级作用域（`.mcp.json`）