The open-source agent harness - the runtime layer that turns an LLM into a working agent.
AGE-1612: add delete route for disconnecting OAuth from configured MCP servers (#54)
Sujai Kumar Gupta453792180167
diff --git a/fern/openapi/openapi.json b/fern/openapi/openapi.jsonindex 6af772fa1..c9d5ff617 100644--- a/fern/openapi/openapi.json+++ b/fern/openapi/openapi.json@@ -4356,6 +4356,53 @@}},"/api/v1/settings/mcp-servers/{name}/authorize": {+ "delete": {+ "description": "For auth.type dcr, deletes the stored OAuth token and returns the server with auth_status auth_required, keeping the dynamically registered OAuth client so the next authorize can reuse it. No-op for header or no-auth servers (returns the server unchanged).",+ "parameters": [+ {+ "description": "Configured MCP server name.",+ "in": "path",+ "name": "name",+ "required": true,+ "schema": {+ "description": "Configured MCP server name.",+ "minLength": 1,+ "type": "string"+ }+ }+ ],+ "responses": {+ "200": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/PutMcpServerResponse"+ }+ }+ },+ "description": "The MCP server after disconnect (auth_required for dcr)."+ },+ "404": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/RequestErrorResponse"+ }+ }+ },+ "description": "MCP server not found."+ }+ },+ "summary": "Disconnect OAuth for a configured MCP server",+ "tags": [+ "MCP Servers"+ ],+ "x-fern-sdk-group-name": [+ "settings",+ "mcpServers"+ ],+ "x-fern-sdk-method-name": "delete_authorize"+ },"get": {"description": "For servers without auth returns not_required, and for header credentials returns authenticated (no browser flow). For auth.type dcr, returns authenticated when a usable (or refreshable) token exists; otherwise runs DCR if needed and returns auth_required with an authorization URL. Optional redirect_url is where the OAuth callback then redirects the browser; without it the callback returns JSON.","parameters": [diff --git a/packages/sdk/.fern/metadata.json b/packages/sdk/.fern/metadata.jsonindex ebd88aaa1..a23ff9d6f 100644--- a/packages/sdk/.fern/metadata.json+++ b/packages/sdk/.fern/metadata.json@@ -27,7 +27,7 @@"streamType": "web","useDefaultRequestParameterValues": true},- "originGitCommit": "7867a963653c80bce32ed8148adf74c3bfbc2314",+ "originGitCommit": "c499a2b97a1791a40e2ced533b26065c809d364b","originGitCommitIsDirty": true,"invokedBy": "ci","requestedVersion": "0.0.0",diff --git a/packages/sdk/reference.md b/packages/sdk/reference.mdindex 9e401b6a4..4cdf4d58f 100644--- a/packages/sdk/reference.md+++ b/packages/sdk/reference.md@@ -1317,6 +1317,69 @@ await client.settings.mcpServers.authorize("name");</dl>+</dd>+</dl>+</details>++<details><summary><code>client.settings.mcpServers.<a href="/src/api/resources/settings/resources/mcpServers/client/Client.ts">deleteAuthorize</a>(name) -> TrueHarness.PutMcpServerResponse</code></summary>+<dl>+<dd>++#### π Description++<dl>+<dd>++<dl>+<dd>++For auth.type dcr, deletes the stored OAuth token and returns the server with auth_status auth_required, keeping the dynamically registered OAuth client so the next authorize can reuse it. No-op for header or no-auth servers (returns the server unchanged).+</dd>+</dl>+</dd>+</dl>++#### π Usage++<dl>+<dd>++<dl>+<dd>++```typescript+await client.settings.mcpServers.deleteAuthorize("name");++```+</dd>+</dl>+</dd>+</dl>++#### βοΈ Parameters++<dl>+<dd>++<dl>+<dd>++**name:** `string` β Configured MCP server name.++</dd>+</dl>++<dl>+<dd>++**requestOptions:** `McpServersClient.RequestOptions`++</dd>+</dl>+</dd>+</dl>++</dd></dl></details>diff --git a/packages/sdk/src/api/resources/settings/resources/mcpServers/client/Client.ts b/packages/sdk/src/api/resources/settings/resources/mcpServers/client/Client.tsindex 6e34def90..a8bfe7e9e 100644--- a/packages/sdk/src/api/resources/settings/resources/mcpServers/client/Client.ts+++ b/packages/sdk/src/api/resources/settings/resources/mcpServers/client/Client.ts@@ -361,6 +361,89 @@ export class McpServersClient {);}+ /**+ * For auth.type dcr, deletes the stored OAuth token and returns the server with auth_status auth_required, keeping the dynamically registered OAuth client so the next authorize can reuse it. No-op for header or no-auth servers (returns the server unchanged).+ *+ * @param {string} name - Configured MCP server name.+ * @param {McpServersClient.RequestOptions} requestOptions - Request-specific configuration.+ *+ * @throws {@link TrueHarness.NotFoundError}+ * @throws {@link errors.TrueHarnessError}+ * @throws {@link errors.TrueHarnessTimeoutError}+ *+ * @example+ * await client.settings.mcpServers.deleteAuthorize("name")+ */+ public deleteAuthorize(+ name: string,+ requestOptions?: McpServersClient.RequestOptions,+ ): core.HttpResponsePromise<TrueHarness.PutMcpServerResponse> {+ return core.HttpResponsePromise.fromPromise(this.__deleteAuthorize(name, requestOptions));+ }++ private async __deleteAuthorize(+ name: string,+ requestOptions?: McpServersClient.RequestOptions,+ ): Promise<core.WithRawResponse<TrueHarness.PutMcpServerResponse>> {+ const _headers: core.Fetcher.Args["headers"] = mergeHeaders(this._options?.headers, requestOptions?.headers);+ const _response = await (this._options.fetcher ?? core.fetcher)({+ url: core.url.join(+ (await core.Supplier.get(this._options.baseUrl)) ??+ (await core.Supplier.get(this._options.environment)),+ `api/v1/settings/mcp-servers/${core.url.encodePathParam(name)}/authorize`,+ ),+ method: "DELETE",+ headers: _headers,+ queryString: core.url.queryBuilder().mergeAdditional(requestOptions?.queryParams).build(),+ timeoutMs: (requestOptions?.timeoutInSeconds ?? this._options?.timeoutInSeconds ?? 60) * 1000,+ maxRetries: requestOptions?.maxRetries ?? this._options?.maxRetries,+ abortSignal: requestOptions?.abortSignal,+ fetchFn: this._options?.fetch,+ logging: this._options.logging,+ });+ if (_response.ok) {+ return {+ data: serializers.PutMcpServerResponse.parseOrThrow(_response.body, {+ unrecognizedObjectKeys: "passthrough",+ allowUnrecognizedUnionMembers: true,+ allowUnrecognizedEnumValues: true,+ skipValidation: true,+ breadcrumbsPrefix: ["response"],+ }),+ rawResponse: _response.rawResponse,+ };+ }++ if (_response.error.reason === "status-code") {+ switch (_response.error.statusCode) {+ case 404:+ throw new TrueHarness.NotFoundError(+ serializers.RequestErrorResponse.parseOrThrow(_response.error.body, {+ unrecognizedObjectKeys: "passthrough",+ allowUnrecognizedUnionMembers: true,+ allowUnrecognizedEnumValues: true,+ skipValidation: true,+ breadcrumbsPrefix: ["response"],+ }),+ _response.rawResponse,+ );+ default:+ throw new errors.TrueHarnessError({+ statusCode: _response.error.statusCode,+ body: _response.error.body,+ rawResponse: _response.rawResponse,+ });+ }+ }++ return handleNonStatusCodeError(+ _response.error,+ _response.rawResponse,+ "DELETE",+ "/api/v1/settings/mcp-servers/{name}/authorize",+ );+ }+/*** All tools exposed by the given configured MCP server (non-paginated), as returned by the MCP `tools/list` call.*diff --git a/packages/sdk/tests/wire/settings/mcpServers.test.ts b/packages/sdk/tests/wire/settings/mcpServers.test.tsindex 9a00f0981..9676d15c0 100644--- a/packages/sdk/tests/wire/settings/mcpServers.test.ts+++ b/packages/sdk/tests/wire/settings/mcpServers.test.ts@@ -223,6 +223,64 @@ describe("McpServersClient", () => {}).rejects.toThrow(TrueHarnessTypes.InternalServerError);});+ test("delete_authorize (1)", async () => {+ const server = mockServerPool.createServer();+ const client = new TrueHarness({ maxRetries: 0, baseUrl: server.baseUrl });++ const rawResponseBody = {+ data: {+ auth: { type: "dcr" },+ auth_status: { authorization_url: "authorization_url", status: "authenticated" },+ name: "name",+ type: "remote",+ url: "url",+ },+ };++ server+ .mockEndpoint()+ .delete("/api/v1/settings/mcp-servers/name/authorize")+ .respondWith()+ .statusCode(200)+ .jsonBody(rawResponseBody)+ .build();++ const response = await client.settings.mcpServers.deleteAuthorize("name");+ expect(response).toEqual({+ data: {+ auth: {+ type: "dcr",+ },+ authStatus: {+ authorizationUrl: "authorization_url",+ status: "authenticated",+ },+ name: "name",+ type: "remote",+ url: "url",+ },+ });+ });++ test("delete_authorize (2)", async () => {+ const server = mockServerPool.createServer();+ const client = new TrueHarness({ maxRetries: 0, baseUrl: server.baseUrl });++ const rawResponseBody = { error: { message: "message" } };++ server+ .mockEndpoint()+ .delete("/api/v1/settings/mcp-servers/name/authorize")+ .respondWith()+ .statusCode(404)+ .jsonBody(rawResponseBody)+ .build();++ await expect(async () => {+ return await client.settings.mcpServers.deleteAuthorize("name");+ }).rejects.toThrow(TrueHarnessTypes.NotFoundError);+ });+test("list_tools (1)", async () => {const server = mockServerPool.createServer();const client = new TrueHarness({ maxRetries: 0, baseUrl: server.baseUrl });diff --git a/packages/server/src/apis/mcpServers.ts b/packages/server/src/apis/mcpServers.tsindex 1835f3392..b61a18e75 100644--- a/packages/server/src/apis/mcpServers.ts+++ b/packages/server/src/apis/mcpServers.ts@@ -20,6 +20,7 @@ import configuration from '../config';import type { IMcpServerStore, McpServerRecord } from '../db/mcpServerStore';import {authorizeConfiguredMcpServerRoute,+ deleteConfiguredMcpServerAuthRoute,getMcpServerCatalogRoute,listAvailableMcpServersRoute,listConfiguredMcpServersRoute,@@ -241,6 +242,20 @@ export function createMcpServersRouter(deps: McpServersRouterDeps) {}};+ const deleteAuthHandler: RouteHandler<typeof deleteConfiguredMcpServerAuthRoute> = async c => {+ const { name } = c.req.valid('param');+ const record = await deps.mcpServerStore.getServer({ tenant_id: TENANT_ID, name });+ if (!record) {+ return c.json({ error: { message: `MCP server not found: ${name}` } }, 404);+ }+ // DCR: drop the user token only β keep oauth_server / oauth_client so re-authorize can skip DCR.+ // Header / no-auth: no-op.+ if (record.manifest.auth?.type === 'dcr') {+ await deps.tokenStore.deleteToken({ id: record.id });+ }+ return c.json({ data: toConfiguredMcpServer({ record, token: undefined }) }, 200);+ };+const router = new OpenAPIHono();// Static `/catalog` before `/{name}/β¦` so "catalog" is not captured as a name.router.openapi(getMcpServerCatalogRoute, catalogHandler);@@ -248,6 +263,7 @@ export function createMcpServersRouter(deps: McpServersRouterDeps) {router.openapi(putMcpServerRoute, putHandler);router.openapi(listMcpServerToolsRoute, listToolsHandler);router.openapi(authorizeConfiguredMcpServerRoute, authorizeHandler);+ router.openapi(deleteConfiguredMcpServerAuthRoute, deleteAuthHandler);return router;}diff --git a/packages/server/src/routes/mcpServerRoutes.ts b/packages/server/src/routes/mcpServerRoutes.tsindex 203a0e9b3..90d20d876 100644--- a/packages/server/src/routes/mcpServerRoutes.ts+++ b/packages/server/src/routes/mcpServerRoutes.ts@@ -181,3 +181,29 @@ export const authorizeConfiguredMcpServerRoute = createRoute({},},});++export const deleteConfiguredMcpServerAuthRoute = createRoute({+ method: 'delete',+ path: '/{name}/authorize',+ tags: [MCP_SERVERS_TAG],+ summary: 'Disconnect OAuth for a configured MCP server',+ 'x-fern-sdk-group-name': ['settings', 'mcpServers'],+ 'x-fern-sdk-method-name': 'delete_authorize',+ description:+ 'For auth.type dcr, deletes the stored OAuth token and returns the server with auth_status ' ++ 'auth_required, keeping the dynamically registered OAuth client so the next authorize can reuse it. ' ++ 'No-op for header or no-auth servers (returns the server unchanged).',+ request: {+ params: McpServerNameParamsSchema,+ },+ responses: {+ 200: {+ content: { 'application/json': { schema: PutMcpServerResponseSchema } },+ description: 'The MCP server after disconnect (auth_required for dcr).',+ },+ 404: {+ content: { 'application/json': { schema: RequestErrorResponseSchema } },+ description: 'MCP server not found.',+ },+ },+});diff --git a/packages/server/tests/unit/apis/mcpServers.test.ts b/packages/server/tests/unit/apis/mcpServers.test.tsindex 5efdee288..1d58fdb6f 100644--- a/packages/server/tests/unit/apis/mcpServers.test.ts+++ b/packages/server/tests/unit/apis/mcpServers.test.ts@@ -285,4 +285,71 @@ describe('mcp-servers routers', () => {globalThis.fetch = realFetch;}});++ it('DELETE /{name}/authorize removes the DCR token, keeps the client, and reports auth_required', async () => {+ await settingsRouter.request('/', putInit(putBodyWithDcr));+ const record = await mcpServerStore.getServer({ tenant_id: TENANT_ID, name: putBodyWithDcr.name });+ if (!record) {+ throw new Error('expected DCR server to exist');+ }++ await mcpServerStore.saveClient({+ id: record.id,+ record: {+ server: {+ authorizationEndpoint: 'https://auth.example.com/authorize',+ tokenEndpoint: 'https://auth.example.com/token',+ codeChallengeMethodsSupported: ['S256'],+ },+ client: {+ clientId: 'keep-me',+ clientSecret: 'keep-secret',+ },+ },+ });+ await tokenStore.saveToken({+ id: record.id,+ token: {+ accessToken: 'access-1',+ refreshToken: 'refresh-1',+ expiresAt: '2099-01-01T00:00:00.000Z',+ scope: null,+ },+ });++ const response = await settingsRouter.request(`/${putBodyWithDcr.name}/authorize`, { method: 'DELETE' });+ expect(response.status).toBe(200);+ expect(await response.json()).toEqual({+ data: { ...putBodyWithDcr, auth_status: { status: 'auth_required' } },+ });+ expect(await tokenStore.getToken({ id: record.id })).toBeUndefined();+ expect(await mcpServerStore.getClient({ id: record.id })).toEqual({+ server: {+ authorizationEndpoint: 'https://auth.example.com/authorize',+ tokenEndpoint: 'https://auth.example.com/token',+ codeChallengeMethodsSupported: ['S256'],+ },+ client: {+ clientId: 'keep-me',+ clientSecret: 'keep-secret',+ },+ });+ });++ it('DELETE /{name}/authorize is a no-op for non-DCR servers and 404s unknowns', async () => {+ const noAuth = await settingsRouter.request('/deepwiki/authorize', { method: 'DELETE' });+ expect(noAuth.status).toBe(200);+ expect(await noAuth.json()).toEqual({+ data: { ...putBody, auth_status: { status: 'not_required' } },+ });++ const headerAuth = await settingsRouter.request('/private-mcp/authorize', { method: 'DELETE' });+ expect(headerAuth.status).toBe(200);+ expect(await headerAuth.json()).toEqual({+ data: { ...putBodyWithHeaderAuth, auth_status: { status: 'authenticated' } },+ });++ const missing = await settingsRouter.request('/missing/authorize', { method: 'DELETE' });+ expect(missing.status).toBe(404);+ });});