Documentation Index
Fetch the complete documentation index at: https://docs.pipeshub.com/llms.txt
Use this file to discover all available pages before exploring further.
Cursor supports static OAuth for remote MCP servers via the auth object in mcp.json.
Before you start, create an OAuth app in PipesHub and note your Client ID and Client Secret. See MCP Server Overview. Configuration
Open Cursor Settings > Tools and Integrations > New MCP Server, or edit your project’s .cursor/mcp.json:
{
"mcpServers": {
"pipeshub": {
"url": "PIPESHUB_INSTANCE_URL/mcp",
"auth": {
"CLIENT_ID": "YOUR_CLIENT_ID",
"CLIENT_SECRET": "YOUR_CLIENT_SECRET",
"scopes": [
"openid", "profile", "email", "offline_access",
"semantic:write",
"conversation:write", "conversation:chat",
"kb:read", "team:read", "user:read", "config:read"
]
}
}
}
}
/.well-known/oauth-protected-resource/mcp metadata.
If the scopes field is omitted, Cursor fetches /.well-known/oauth-protected-resource/mcp and requests all scopes_supported listed there. To limit access, explicitly list only the scopes you need. You can also control which scopes are exposed server-side — see Customizing Default Scopes. Using Environment Variables
Use Cursor’s ${env:VAR} interpolation to keep secrets out of config files:
{
"mcpServers": {
"pipeshub": {
"url": "${env:PIPESHUB_INSTANCE_URL}/mcp",
"auth": {
"CLIENT_ID": "${env:PIPESHUB_CLIENT_ID}",
"CLIENT_SECRET": "${env:PIPESHUB_CLIENT_SECRET}",
"scopes": [
"openid", "profile", "email", "offline_access",
"semantic:write",
"conversation:write", "conversation:chat",
"kb:read", "team:read", "user:read", "config:read"
]
}
}
}
}
Redirect URI
Cursor uses a fixed redirect URI for all MCP servers:
cursor://anysphere.cursor-mcp/oauth/callback
OAuth Login Troubleshooting
If Cursor’s internal browser fails to load the OAuth login page, copy the authorization URL from the internal browser and paste it into your normal browser to complete the login flow.
