LibreChat

​

Overview

​

Key Benefits

• Secure Authentication: The AI Gateway handles OAuth flows and token management
• Unified Authentication: Single OAuth token to rule them all
• Team Collaboration: Share MCP server configurations, manage access permissions, and ensure everyone on your team has the tools they need—configured correctly, every time
• Complete Observability: See every request, track latency, monitor errors, and understand usage patterns

​

Prerequisites

1. LibreChat installed and running
2. Strata Cloud Manager account with workspace access
3. MCP server registered in the AI Gateway’s MCP Hub
4. Access to your librechat.yaml configuration file

​

Quick Setup

​

Step 1: Get Your MCP Server URL

1. Log in to Strata Cloud Manager
2. Navigate to MCP Hub → Your Servers
3. Copy your server URL:
   https://aigw.portkey.ai/m/:workspace-id/:server-id/mcp
   

​

Step 2: Configure LibreChat

1. Open your librechat.yaml configuration file
2. Add your MCP server configuration under the mcpServers section:

mcpServers:
  portkey-mcp:
    type: "streamable-http"
    url: "https://aigw.portkey.ai/m/:workspace-id/:server-id/mcp"

​

Step 3: Restart LibreChat

# If using Docker
docker-compose restart

​

Step 4: Authentication

1. First Connection: When LibreChat first connects to an authenticated MCP server, the AI Gateway will:
   • Open your browser for OAuth authorization (if required)
   • Store credentials securely
   • Maintain session state
2. Subsequent Connections: Authentication tokens are refreshed automatically
3. Team Access: Workspace members share the same authentication scope based on your AI Gateway settings

​

Configuration Examples

​

Single Server Setup

mcpServers:
  linear-integration:
    type: "streamable-http"
    url: "https://aigw.portkey.ai/m/ws-abc123/linear-def456/mcp"

​

Multiple Servers Setup

mcpServers:
  linear:
    type: "streamable-http"
    url: "https://aigw.portkey.ai/m/ws-abc123/linear-def456/mcp"

  github:
    type: "streamable-http"
    url: "https://aigw.portkey.ai/m/ws-abc123/github-ghi789/mcp"

  slack:
    type: "streamable-http"
    url: "https://aigw.portkey.ai/m/ws-abc123/slack-jkl012/mcp"

​

Support

• 📧 Email: support@portkey.ai