Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
28 commits
Select commit Hold shift + click to select a range
4598067
feat(mcp): OAuth 2.1 + PKCE for outbound MCP servers
waleedlatif1 May 5, 2026
f587e82
fix(mcp): address PR review for OAuth feature
waleedlatif1 May 5, 2026
78cbbec
fix(mcp): promote authType + clear OAuth tokens on credential change
waleedlatif1 May 5, 2026
87504d7
fix(mcp): compare decrypted plaintext for OAuth client secret change
waleedlatif1 May 5, 2026
fe7118d
fix(mcp): trigger OAuth auto-detection probe for empty headers object
waleedlatif1 May 5, 2026
e2de153
fix(mcp): catch redirect-required error in execute + always test on save
waleedlatif1 May 5, 2026
880a645
fix(mcp): treat UnauthorizedError as disconnected in service discover…
waleedlatif1 May 5, 2026
38ea9a4
fix(mcp): allow clearing OAuth credentials in edit + filter deleted s…
waleedlatif1 May 5, 2026
2224f93
fix(mcp): pass workspaceId to OAuth start + preserve client secret on…
waleedlatif1 May 5, 2026
f39abd9
fix(mcp): pass workspaceId on auto-start OAuth after server create
waleedlatif1 May 5, 2026
9671131
fix(mcp): normalize empty/null when detecting OAuth client id change
waleedlatif1 May 5, 2026
0968598
fix(mcp): tighten 401 detection, hash OAuth state at rest
waleedlatif1 May 5, 2026
e37f10a
fix(mcp): allow OAuth flow for DCR-only servers; detect secret-only e…
waleedlatif1 May 5, 2026
23266fe
fix(mcp): clear OAuth tokens on POST upsert; validate https; OAuthCli…
waleedlatif1 May 5, 2026
311827c
fix(mcp): clear execution timeout to avoid timer leak; redact callbac…
waleedlatif1 May 5, 2026
20fb108
fix(mcp): keep OAuth spinner until popup closes; remove dead comments
waleedlatif1 May 5, 2026
7f1c651
fix(mcp): clear OAuth tokens on server revival; clear popup intervals…
waleedlatif1 May 5, 2026
b879189
chore(mcp): drop redundant useCallback from startOauthForServer
waleedlatif1 May 5, 2026
6417e7a
chore(mcp): align with React Query and design-token best practices
waleedlatif1 May 5, 2026
81f8440
chore(mcp): drop unobserved useCallback/useMemo, simplify state
waleedlatif1 May 5, 2026
4b4096b
fix(mcp): preserve custom headers for OAuth servers; atomic PATCH + t…
waleedlatif1 May 5, 2026
6ce79af
fix(mcp): wrap POST upsert delete+update in transaction
waleedlatif1 May 5, 2026
66161e5
fix(mcp): preserve oauthClientSecret on POST upsert when not provided
waleedlatif1 May 5, 2026
3ea52c9
fix(mcp): include serverId in OAuth postMessage; honor stored secret …
waleedlatif1 May 5, 2026
09e5cf2
fix(mcp): preserve authType on URL-unchanged upserts; fallback server…
waleedlatif1 May 5, 2026
470b02d
fix(mcp): mark OAuth-pending servers disconnected so reauth UI surfaces
waleedlatif1 May 5, 2026
d3461d2
chore(mcp): cleanup pass; unique OAuth popup name per server
waleedlatif1 May 5, 2026
3f840d6
fix(mcp): forward serverId on callback failure; allow loopback http
waleedlatif1 May 5, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
118 changes: 118 additions & 0 deletions apps/sim/app/api/mcp/oauth/callback/route.ts
Original file line number Diff line number Diff line change
@@ -0,0 +1,118 @@
import { auth as mcpAuth } from '@modelcontextprotocol/sdk/client/auth.js'
import { db } from '@sim/db'
import { mcpServers } from '@sim/db/schema'
import { createLogger } from '@sim/logger'
import { toError } from '@sim/utils/errors'
import { and, eq, isNull } from 'drizzle-orm'
import type { NextRequest } from 'next/server'
import { NextResponse } from 'next/server'
import { getSession } from '@/lib/auth'
import { withRouteHandler } from '@/lib/core/utils/with-route-handler'
import {
clearState,
clearVerifier,
loadOauthRowByState,
loadPreregisteredClient,
SimMcpOauthProvider,
} from '@/lib/mcp/oauth'
import { mcpService } from '@/lib/mcp/service'

const logger = createLogger('McpOauthCallbackAPI')

export const dynamic = 'force-dynamic'

function escapeHtml(value: string): string {
return value
.replace(/&/g, '&')
.replace(/</g, '&lt;')
.replace(/>/g, '&gt;')
.replace(/"/g, '&quot;')
.replace(/'/g, '&#39;')
}

function htmlClose(message: string, ok: boolean, serverId?: string): NextResponse {
const safeMessage = escapeHtml(message)
const title = ok ? 'Connected' : 'Connection failed'
const serverIdLiteral = serverId ? JSON.stringify(serverId) : 'undefined'
const body = `<!doctype html><html><head><meta charset="utf-8"><title>${title}</title></head><body style="font-family: system-ui; padding: 24px"><p>${safeMessage}</p><script>
try { window.opener && window.opener.postMessage({ type: 'mcp-oauth', ok: ${ok ? 'true' : 'false'}, serverId: ${serverIdLiteral} }, window.location.origin) } catch (e) {}
setTimeout(function () { window.close() }, 800)
</script></body></html>`
Comment thread
waleedlatif1 marked this conversation as resolved.
return new NextResponse(body, {
headers: { 'Content-Type': 'text/html; charset=utf-8' },
})
}

export const GET = withRouteHandler(async (request: NextRequest) => {
const url = new URL(request.url)
const state = url.searchParams.get('state')
const code = url.searchParams.get('code')
const errorParam = url.searchParams.get('error')

if (errorParam) {
logger.warn(`MCP OAuth callback received error: ${errorParam}`)
return htmlClose(`Authorization failed: ${errorParam}`, false)
}
if (!state || !code) {
return htmlClose('Missing state or code in callback URL.', false)
}

let serverId: string | undefined
try {
const session = await getSession()
if (!session?.user?.id) {
return htmlClose('You must be signed in to complete authorization.', false)
}

const row = await loadOauthRowByState(state)
if (!row) {
return htmlClose('Invalid or expired authorization state.', false)
}
serverId = row.mcpServerId

if (session.user.id !== row.userId) {
return htmlClose(
'You must be signed in as the same user that initiated the flow.',
false,
serverId
)
}

const [server] = await db
.select({ id: mcpServers.id, url: mcpServers.url, workspaceId: mcpServers.workspaceId })
.from(mcpServers)
.where(and(eq(mcpServers.id, row.mcpServerId), isNull(mcpServers.deletedAt)))
.limit(1)
if (!server || !server.url) {
return htmlClose('Server no longer exists.', false, serverId)
}
Comment thread
waleedlatif1 marked this conversation as resolved.

// Burn state before token exchange so a replayed callback cannot reuse it.
await clearState(row.id)

const preregistered = await loadPreregisteredClient(server.id)
const provider = new SimMcpOauthProvider({ row, preregistered })
const result = await mcpAuth(provider, {
serverUrl: server.url,
authorizationCode: code,
})

await clearVerifier(row.id)

if (result !== 'AUTHORIZED') {
return htmlClose('Authorization did not complete.', false, server.id)
}

try {
await mcpService.clearCache(server.workspaceId)
await mcpService.discoverServerTools(row.userId, server.id, server.workspaceId)
} catch (e) {
logger.warn('Post-auth tools refresh failed', toError(e).message)
}

return htmlClose('Connected. You can close this window.', true, server.id)
} catch (error) {
logger.error('MCP OAuth callback failed', error)
return htmlClose('Authorization failed. Please try again.', false, serverId)
}
Comment thread
waleedlatif1 marked this conversation as resolved.
})
95 changes: 95 additions & 0 deletions apps/sim/app/api/mcp/oauth/start/route.ts
Original file line number Diff line number Diff line change
@@ -0,0 +1,95 @@
import { auth as mcpAuth } from '@modelcontextprotocol/sdk/client/auth.js'
import { db } from '@sim/db'
import { mcpServers } from '@sim/db/schema'
import { createLogger } from '@sim/logger'
import { toError } from '@sim/utils/errors'
import { and, eq, isNull } from 'drizzle-orm'
import type { NextRequest } from 'next/server'
import { NextResponse } from 'next/server'
import { startMcpOauthQuerySchema } from '@/lib/api/contracts/mcp'
import { validationErrorResponse } from '@/lib/api/server'
import { withRouteHandler } from '@/lib/core/utils/with-route-handler'
import { withMcpAuth } from '@/lib/mcp/middleware'
import {
getOrCreateOauthRow,
loadPreregisteredClient,
McpOauthRedirectRequired,
SimMcpOauthProvider,
} from '@/lib/mcp/oauth'
import { createMcpErrorResponse } from '@/lib/mcp/utils'

const logger = createLogger('McpOauthStartAPI')

export const dynamic = 'force-dynamic'

export const GET = withRouteHandler(
withMcpAuth('write')(async (request: NextRequest, { userId, workspaceId, requestId }) => {
try {
const queryResult = startMcpOauthQuerySchema.safeParse(
Object.fromEntries(new URL(request.url).searchParams)
)
if (!queryResult.success) {
return validationErrorResponse(queryResult.error)
}
const { serverId } = queryResult.data

const [server] = await db
.select()
.from(mcpServers)
.where(
and(
eq(mcpServers.id, serverId),
eq(mcpServers.workspaceId, workspaceId),
isNull(mcpServers.deletedAt)
)
)
.limit(1)

if (!server) {
return createMcpErrorResponse(new Error('Server not found'), 'Server not found', 404)
}
if (server.authType !== 'oauth') {
return createMcpErrorResponse(
new Error(`Server authType is "${server.authType}", not oauth`),
'Server is not configured for OAuth',
400
)
}
if (!server.url) {
return createMcpErrorResponse(new Error('Server has no URL'), 'Missing server URL', 400)
}

const row = await getOrCreateOauthRow({
mcpServerId: server.id,
userId,
workspaceId,
})
const preregistered = await loadPreregisteredClient(server.id)
const provider = new SimMcpOauthProvider({ row, preregistered })

try {
const result = await mcpAuth(provider, { serverUrl: server.url })
if (result === 'AUTHORIZED') {
return NextResponse.json({ status: 'already_authorized' })
}
return createMcpErrorResponse(
new Error('Provider did not capture redirect URL'),
'Failed to start OAuth flow',
500
)
} catch (e) {
if (e instanceof McpOauthRedirectRequired) {
logger.info(`[${requestId}] OAuth redirect for server ${serverId}`)
return NextResponse.json({
status: 'redirect',
authorizationUrl: e.authorizationUrl,
})
}
throw e
}
} catch (error) {
logger.error(`[${requestId}] Error starting MCP OAuth flow:`, error)
return createMcpErrorResponse(toError(error), 'Failed to start OAuth flow', 500)
}
})
)
101 changes: 81 additions & 20 deletions apps/sim/app/api/mcp/servers/[id]/route.ts
Original file line number Diff line number Diff line change
@@ -1,11 +1,12 @@
import { AuditAction, AuditResourceType, recordAudit } from '@sim/audit'
import { db } from '@sim/db'
import { mcpServers } from '@sim/db/schema'
import { mcpServerOauth, mcpServers } from '@sim/db/schema'
import { createLogger } from '@sim/logger'
import { toError } from '@sim/utils/errors'
import { and, eq, isNull } from 'drizzle-orm'
import type { NextRequest } from 'next/server'
import { updateMcpServerBodySchema } from '@/lib/api/contracts/mcp'
import { decryptSecret, encryptSecret } from '@/lib/core/security/encryption'
import { withRouteHandler } from '@/lib/core/utils/with-route-handler'
import {
McpDnsResolutionError,
Expand Down Expand Up @@ -52,8 +53,16 @@ export const PATCH = withRouteHandler(
}
)

// Remove workspaceId from body to prevent it from being updated
const { workspaceId: _, ...updateData } = body
const { workspaceId: _, oauthClientSecret, ...updateData } = body
const finalUpdateData: Record<string, unknown> = { ...updateData }
if (oauthClientSecret !== undefined) {
finalUpdateData.oauthClientSecret = oauthClientSecret
? (await encryptSecret(oauthClientSecret)).encrypted
: null
}
Comment thread
waleedlatif1 marked this conversation as resolved.
if (updateData.oauthClientId !== undefined) {
finalUpdateData.oauthClientId = updateData.oauthClientId || null
}

if (updateData.url) {
try {
Expand All @@ -78,9 +87,13 @@ export const PATCH = withRouteHandler(
}
}

// Get the current server to check if URL is changing
const [currentServer] = await db
.select({ url: mcpServers.url })
.select({
url: mcpServers.url,
authType: mcpServers.authType,
oauthClientId: mcpServers.oauthClientId,
oauthClientSecret: mcpServers.oauthClientSecret,
})
.from(mcpServers)
.where(
and(
Expand All @@ -91,20 +104,60 @@ export const PATCH = withRouteHandler(
)
.limit(1)

const [updatedServer] = await db
.update(mcpServers)
.set({
...updateData,
updatedAt: new Date(),
})
.where(
and(
eq(mcpServers.id, serverId),
eq(mcpServers.workspaceId, workspaceId),
isNull(mcpServers.deletedAt)
// Adding OAuth client credentials to a non-OAuth server promotes it
// to OAuth so the connect-with-OAuth UI becomes reachable.
if (
body.oauthClientId &&
currentServer &&
currentServer.authType !== 'oauth' &&
finalUpdateData.authType === undefined
) {
finalUpdateData.authType = 'oauth'
}

const urlChanged = body.url !== undefined && currentServer?.url !== body.url
const clientIdChanged =
body.oauthClientId !== undefined &&
(body.oauthClientId || null) !== (currentServer?.oauthClientId ?? null)
let clientSecretChanged = false
if (oauthClientSecret !== undefined) {
if (!oauthClientSecret) {
clientSecretChanged = currentServer?.oauthClientSecret != null
} else if (!currentServer?.oauthClientSecret) {
clientSecretChanged = true
} else {
const currentPlaintext = (await decryptSecret(currentServer.oauthClientSecret))
.decrypted
clientSecretChanged = currentPlaintext !== oauthClientSecret
}
}
const oauthCredsChanged = clientIdChanged || clientSecretChanged
const shouldClearOauth = urlChanged || oauthCredsChanged

const updatedServer = await db.transaction(async (tx) => {
const [updated] = await tx
.update(mcpServers)
.set({
...finalUpdateData,
updatedAt: new Date(),
})
.where(
and(
eq(mcpServers.id, serverId),
eq(mcpServers.workspaceId, workspaceId),
isNull(mcpServers.deletedAt)
)
)
)
.returning()
.returning()

if (!updated) return null

if (shouldClearOauth) {
await tx.delete(mcpServerOauth).where(eq(mcpServerOauth.mcpServerId, serverId))
}

return updated
})

if (!updatedServer) {
return createMcpErrorResponse(
Expand All @@ -114,8 +167,15 @@ export const PATCH = withRouteHandler(
)
}

if (shouldClearOauth) {
logger.info(
`[${requestId}] Cleared OAuth credentials for server ${serverId} due to ${urlChanged ? 'URL' : 'OAuth credential'} change`
)
}
Comment thread
waleedlatif1 marked this conversation as resolved.
Comment thread
waleedlatif1 marked this conversation as resolved.

const shouldClearCache =
(body.url !== undefined && currentServer?.url !== body.url) ||
urlChanged ||
oauthCredsChanged ||
body.enabled !== undefined ||
body.headers !== undefined ||
body.timeout !== undefined ||
Expand Down Expand Up @@ -149,7 +209,8 @@ export const PATCH = withRouteHandler(
request,
})

return createMcpSuccessResponse({ server: updatedServer })
const { oauthClientSecret: _secret, ...safeServer } = updatedServer
return createMcpSuccessResponse({ server: safeServer })
} catch (error) {
logger.error(`[${requestId}] Error updating MCP server:`, error)
return createMcpErrorResponse(toError(error), 'Failed to update MCP server', 500)
Expand Down
Loading
Loading