{"record":{"id":"43a22c4ace74bfd3","repo":"deepseek-ai/deepseek-harness","slug":"mcp-client-config-servername-initial-connecti","errorCode":null,"errorMessage":"mcp-client(${config.serverName}): initial connection or tool synchronization failed","messagePattern":"mcp-client\\((.+?)\\): initial connection or tool synchronization failed","errorType":"exception","errorClass":null,"httpStatus":null,"severity":"error","filePath":"packages/mcp/mcp-client/src/index.ts","lineNumber":179,"sourceCode":"  }, 'mcp-client.serverName')\n\n  // The supervisor owns the client/transport generations, the reconnect\n  // loop, and the live tool registrations; disposal stops reconnection,\n  // quiesces in-flight work, and unregisters the current generation.\n  const connection = startConnection(ctx, config, reconnect)\n\n  ctx.effect(() => {\n    return () => connection.dispose()\n  }, 'mcp-client.connection')\n\n  // Block plugin activation on the initial connection + tool discovery so\n  // Cordis consumers observe the tools immediately after the fiber activates.\n  // When failOnStartupError is true, a failed initial attempt rejects the\n  // fiber (Cordis rolls it back); otherwise the error is logged and the\n  // supervisor enters its reconnect loop.\n  const outcome = await connection.ready\n  if (outcome.error !== undefined && config.failOnStartupError) {\n    throw new Error(`mcp-client(${config.serverName}): initial connection or tool synchronization failed`, { cause: outcome.error })\n  }\n}\n","sourceCodeStart":161,"sourceCodeEnd":182,"githubUrl":"https://github.com/deepseek-ai/deepseek-harness/blob/b150a551b8d465e31e418e1b2eaf5e79bbb7d28e/packages/mcp/mcp-client/src/index.ts#L161-L182","documentation":"Error \"mcp-client(${config.serverName}): initial connection or tool synchronization failed\" thrown in deepseek-ai/deepseek-harness.","triggerScenarios":"Thrown at packages/mcp/mcp-client/src/index.ts:179 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Check the server command/URL, credentials, and the wrapped cause; fix and reload."],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"b150a551b8d465e31e418e1b2eaf5e79bbb7d28e","analyzedAt":"2026-08-24T18:12:29.105Z","schemaVersion":2},"datasetVersion":"2026-08-24T22:17:12.610Z"}