Claude Code

​

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. Claude Code CLI installed
2. Strata Cloud Manager account with workspace access
3. MCP server registered in the AI Gateway’s MCP Hub

​

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: Add Remote Server

claude mcp add --transport http portkey-mcp https://aigw.portkey.ai/m/:workspace-id/:server-id/mcp

​

Step 3: Verify Connection

claude mcp list

​

Step 4: Authentication

1. First Connection: Run the authentication command in Claude Code:
   /mcp
   
2. Browser Authentication:
   • Your browser will open for OAuth authorization (if required)
   • Complete the authentication flow
   • Tokens are stored securely and refreshed automatically
3. Team Access: Workspace members share the same authentication scope based on your AI Gateway settings

​

Configuration Examples

​

Single Server Setup

# Add Linear integration
claude mcp add --transport http linear https://aigw.portkey.ai/m/ws-abc123/linear-def456/mcp

​

Multiple Servers Setup

# Add Linear
claude mcp add --transport http linear https://aigw.portkey.ai/m/ws-abc123/linear-def456/mcp

# Add GitHub
claude mcp add --transport http github https://aigw.portkey.ai/m/ws-abc123/github-ghi789/mcp

# Add Slack
claude mcp add --transport http slack https://aigw.portkey.ai/m/ws-abc123/slack-jkl012/mcp

​

With Custom Headers (if needed)

claude mcp add --transport http secure-api https://aigw.portkey.ai/m/ws-abc123/api-xyz789/mcp \
  --header "X-Custom-Header: value"

​

Managing Servers

​

List All Servers

claude mcp list

​

Remove a Server

claude mcp remove portkey-mcp

​

Clear Authentication

/mcp
# Select "Clear authentication" from the menu

​

Tips

• Authentication tokens are stored securely and refreshed automatically
• If your browser doesn’t open automatically during auth, copy the provided URL
• OAuth authentication works with both SSE and HTTP transports
• Use descriptive names when adding servers for easier management

​

Support

• 📧 Email: support@portkey.ai