Guides
Connect Claude, Cursor, and ChatGPT
Step-by-step setup for adding your UCL gateway to Claude Desktop, Cursor, ChatGPT, and headless agents via OAuth, bearer token, or config file.
Any MCP client connects to the same gateway URL. Choose the auth method the client supports: one-time OAuth sign-in, a scoped bearer token, or a config-file snippet.
Claude Desktop & Cursor (config file)
{
"mcpServers": {
"ucl": {
"url": "https://your-company.ucl.dev/mcp",
"headers": { "Authorization": "Bearer ucl_<your-token>" }
}
}
}Headless agents (LangChain, OpenAI, TypeScript)
For agents serving many end users, create one client per user and bind the org + end-user headers at connect time. The same agent key serves every tenant; per-user connectors act as the X-User-Id you pass.
from langchain_mcp_adapters.client import MultiServerMCPClient
client = MultiServerMCPClient({
"ucl": {
"transport": "streamable_http",
"url": "https://your-company.ucl.dev/mcp",
"headers": {
"Authorization": "Bearer ucl_<agent-key>",
"X-User-Id": "user@example.com",
},
}
})FAQ
Which clients are supported?
Any MCP client over Streamable HTTP or SSE, including Claude Desktop, Cursor, ChatGPT, Windsurf, Cline, and Zed, plus frameworks like LangChain and the OpenAI Agents SDK.
Last updated 2026-06-09
