PipesHub

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 のすべてを要求します。アクセスを制限するには、必要なスコープのみを明示的に列挙してください。サーバー側で公開するスコープを制御することもできます。デフォルトのスコープをカスタマイズするを参照してください。

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 には MCP ツールが使用するスコープのみが一覧表示されます。OAuth アプリにはそのすべてを設定してください。サインイン時にはアプリで許可されているスコープが付与されます。不足しているスコープを必要とするツールは拒否され、アプリで許可されているスコープが一つもない場合は、サインインが invalid_scope で失敗します。リストの確認や制限については、デフォルトスコープのカスタマイズを参照してください。

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

次に、上記のとおり oauth ブロックを追加するため、~/.gemini/settings.json を編集します。

認証する

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

Codex CLI（OpenAI Codex）は、Streamable HTTP 経由でリモート MCP サーバーに接続します。~/.codex/config.toml（またはプロジェクト単位で設定する場合はプロジェクトルートの .codex/config.toml）にある [mcp_servers.<name>] テーブルで設定します。Codex の HTTP トランスポートは、環境変数から読み込んだベアラートークンで認証するため、PipesHub の JWT ベアラートークンを渡します。

[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 の Web インターフェースから PipesHub のツールを直接使用できます。

注： この機能は現在ベータ版です。無料プランでは、カスタムコネクターは 1 つまで利用できます。

個人ユーザー向け（Pro / Max プラン）

1. claude.ai にアクセスし、設定 > コネクター に移動します
2. コネクターセクションの下部にある カスタムコネクターを追加 をクリックします
3. MCP サーバーの URL を入力します。

   PIPESHUB_INSTANCE_URL/mcp
   

4. 詳細設定 をクリックし、OAuth 認証情報を入力します。
   • OAuth クライアント ID：YOUR_CLIENT_ID
   • OAuth クライアントシークレット：YOUR_CLIENT_SECRET
5. 追加 をクリックします
6. 認証して権限を付与するため、PipesHub のログインページにリダイレクトされます
7. 認証が完了するとコネクターが有効になり、Claude.ai の会話で PipesHub のツールを利用できるようになります

チーム／エンタープライズプラン向け

組織オーナーは、最初にコネクターを追加する必要があります。

1. 組織の設定 > コネクター に移動します
2. カスタムコネクターを追加 をクリックします
3. MCP サーバーの URL を入力します：PIPESHUB_INSTANCE_URL/mcp
4. 詳細設定 をクリックし、OAuth クライアント ID とクライアントシークレットを入力します
5. 追加 をクリックします

その後、チームメンバーが接続できます。

1. 設定 > コネクター に移動します
2. PipesHub コネクター（「カスタム」ラベル付き）を見つけます
3. 接続 をクリックし、PipesHub の OAuth ログインで認証します

リダイレクト URI

Claude.ai は OAuth に次のリダイレクト URI を使用します。

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

これを、PipesHub OAuth アプリで許可されるリダイレクト URI として登録してください。

セキュリティに関する注意事項

• 信頼できる MCP サーバーにのみ接続してください
• OAuth 認証フローで要求される権限を確認してください
• Claude.ai は付与された OAuth トークンを使用して、ユーザーに代わって PipesHub とやり取りします。パスワードが共有されることはありません

LibreChat は、カスタムコネクターの UI を介した OAuth 認証付きのリモート MCP サーバーに対応しています。これにより、PipesHub のツールを LibreChat インスタンスで利用可能な任意のモデルに接続できます。

設定

1. LibreChat インスタンスにログインします
2. MCP Servers 設定パネルに移動します
3. Add をクリックして、新しいカスタム MCP コネクターを作成します
4. コネクターの詳細を入力します：
   • Name：Pipeshub（または任意の名前）
   • MCP Server URL：PIPESHUB_INSTANCE_URL/mcp
   • Transport：Streamable HTTPS を選択します
   • Authentication：OAuth を選択します
5. OAuth 認証情報を入力します：
   • Client ID：YOUR_CLIENT_ID
   • Client Secret：YOUR_CLIENT_SECRET
   • Authorization URL：PIPESHUB_INSTANCE_URL/api/v1/oauth2/authorize
   • Token URL：PIPESHUB_INSTANCE_URL/api/v1/oauth2/token
   • Scope：openid email（または必要に応じて追加のスコープ）
6. I trust this application にチェックを入れます
7. Add をクリックしてコネクターを保存します
8. 追加後、LibreChat によって Redirect URI が生成され、コネクターの設定パネル（コピーボタンの横）に表示されます。形式は次のとおりです：

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

9. Redirect URI をコピーし、PipesHub OAuth アプリで許可されたリダイレクト URI として登録します（手順 1 を参照）。
10. LibreChat のコネクターに戻り、Update をクリックして OAuth フローを開始します。認証してアクセス許可を付与するため、PipesHub のログインページにリダイレクトされます。

リダイレクト URI

LibreChat は、コネクターの作成後にリダイレクト URI を生成します。URI の形式は次のとおりです：

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

<server-identifier> は、LibreChat によって割り当てられる一意の識別子です（コネクター設定の上部に「Unique Server Identifier」として表示されます）。認証する前に、この URI をコピーして PipesHub OAuth アプリの許可されたリダイレクト URI に追加する必要があります。

注： LibreChat インスタンスが別のホストまたはポートで実行されている場合、URI にはそのホストまたはポートが反映されます（例：https://chat.example.com/api/mcp/pipeshub/oauth/callback）。

スコープ

LibreChat では、Scope フィールドに 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 アプリで許可されたリクエスト済みのスコープのみです。そのため、アプリに付与されたスコープをリクエストしてください。詳しくは、デフォルトのスコープをカスタマイズするを参照してください。

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"
      ]
    }
  }
}

Cursor Settings > Tools and Integrations > New MCP Server を開くか、プロジェクトの .cursor/mcp.json を編集します。

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

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

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

個人用アクセストークンを使って、MCP サーバーをローカルの stdio プロセスとして実行します。~/.codex/config.toml（またはプロジェクトのルートにある .codex/config.toml）を編集します。

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

コマンドパレット > MCP: Open User Configuration を開き、次を追加します。

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

Windsurf Settings > Cascade > Manage MCPs > View raw config を開き、次を追加します。

{
  "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

1. PipesHub インスタンスの MCP_SCOPES 環境変数を更新し、クライアントに付与するスコープを含めます。検出では、MCP ツールが使用するスコープのみが一覧表示されます。
2. PipesHub で OAuth アプリのスコープを更新します：Settings > Developer Settings > OAuth Apps に移動し、OAuth アプリを選択して、必要に応じてスコープを追加または削除します。
3. クライアントを再認証します。既存のトークンには以前のスコープが含まれているため、更新後のスコープを含む新しいトークンを取得するには、再認証が必要です。例：
   • Cursor：MCP サーバーを削除して再追加するか、キャッシュされた OAuth トークンを消去して再接続します。
   • Claude Code：/mcp を実行し、ブラウザーのログインフローをもう一度完了します。
   • Gemini CLI：/mcp auth pipeshub を実行して再認証します。
   • Codex CLI：PIPESHUB_BEARER_TOKEN を新しいトークンに更新し、Codex を再起動します。
   • Claude.ai：Settings > Connectors でコネクターを切断し、再接続します。