Create an OAuth connect URL for a Claude Managed custom MCP server

POST/agents/{id}/claude/managed-mcp/oauth-connect-url

Authorization

AuthorizationOAuth2 access token · headerrequired

Scopes:api:write

AuthorizationBearer token (JWT) · headerrequired

Path parameters

idstringrequired

Request body

requiredapplication/json

serverClaudeManagedMcpServerDtorequired

Show properties

authModestring

Authentication mode for this MCP server.

Allowed:nonebeareroauth

bearerTokenstring | null

Bearer token to store for bearer-token MCP servers.

credentialConfiguredboolean

Whether Leadtime already has a stored credential for this MCP server.

idstring

Stable local id for an existing MCP row.

namestring

Display name for the MCP server. If omitted, Leadtime derives one from the URL.

oauthCredentialobject | null

OAuth credential details for an OAuth MCP server.

Show properties

accessTokenstring | null

clientIdstring | null

clientSecretstring | null

expiresAtstring | null

refreshTokenstring | null

scopestring | null

tokenEndpointstring | null

tokenEndpointAuthTypestring | null

Allowed:noneclient_secret_basicclient_secret_post

urlstringrequired

Hosted MCP server URL.

Responses

201

401

Unauthorized - Invalid or missing authentication token

403

Forbidden - Insufficient API scopes or permissions

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

OAuth2 access tokenRemember on this deviceInclude my values in samples

Parameters

idpath*

Bodyapplication/json

Request body

Request

curl -X POST "https://leadtime.app/api/public/agents/string/claude/managed-mcp/oauth-connect-url" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "server": {
    "authMode": "none",
    "bearerToken": "string",
    "credentialConfigured": true,
    "id": "string",
    "name": "string",
    "oauthCredential": {
      "accessToken": "string",
      "clientId": "string",
      "clientSecret": "string",
      "expiresAt": "string",
      "refreshToken": "string",
      "scope": "string",
      "tokenEndpoint": "string",
      "tokenEndpointAuthType": "none"
    },
    "url": "string"
  }
}'

const response = await fetch("https://leadtime.app/api/public/agents/string/claude/managed-mcp/oauth-connect-url", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN",
    "Content-Type": "application/json"
  },
  body: "{\n  \"server\": {\n    \"authMode\": \"none\",\n    \"bearerToken\": \"string\",\n    \"credentialConfigured\": true,\n    \"id\": \"string\",\n    \"name\": \"string\",\n    \"oauthCredential\": {\n      \"accessToken\": \"string\",\n      \"clientId\": \"string\",\n      \"clientSecret\": \"string\",\n      \"expiresAt\": \"string\",\n      \"refreshToken\": \"string\",\n      \"scope\": \"string\",\n      \"tokenEndpoint\": \"string\",\n      \"tokenEndpointAuthType\": \"none\"\n    },\n    \"url\": \"string\"\n  }\n}"
});

import requests

response = requests.post(
    "https://leadtime.app/api/public/agents/string/claude/managed-mcp/oauth-connect-url",
    headers={
        "Authorization": "Bearer YOUR_ACCESS_TOKEN",
        "Content-Type": "application/json"
    },
    data="{\n  \"server\": {\n    \"authMode\": \"none\",\n    \"bearerToken\": \"string\",\n    \"credentialConfigured\": true,\n    \"id\": \"string\",\n    \"name\": \"string\",\n    \"oauthCredential\": {\n      \"accessToken\": \"string\",\n      \"clientId\": \"string\",\n      \"clientSecret\": \"string\",\n      \"expiresAt\": \"string\",\n      \"refreshToken\": \"string\",\n      \"scope\": \"string\",\n      \"tokenEndpoint\": \"string\",\n      \"tokenEndpointAuthType\": \"none\"\n    },\n    \"url\": \"string\"\n  }\n}",
)

Response

No example response.