paperclipai/paperclip · error · ToolGatewayHttpError

mcp_remote_connection_disabled

mcp_remote_connection_disabled

Error message

Connection is disabled.

What it means

Remote MCP connection guard: the tool catalog entry resolved to a connection, but that connection is not enabled or its status is not active, so calls through it are refused with 403 before dispatch. Re-enable the connection (or wait for its health to recover) rather than retrying the tool call.

Source

Thrown at server/src/services/tool-gateway.ts:2627

      summary.staticHeaderNames.push(name);
    }

    const metadataHeaders = metadataHeadersForSession(input.session, policy);
    for (const [name, value] of Object.entries(metadataHeaders)) {
      if (reservedHeaders.has(name)) continue;
      if (managedCredentialHeaders.has(name)) {
        summary.collisionRules.push({ header: name, source: "metadata", action: "kept_managed_credential" });
        continue;
      }
      if (headers[name] !== undefined) {
        summary.collisionRules.push({ header: name, source: "metadata", action: "overrode_previous_header" });
      }
      headers[name] = value;
      summary.metadataHeaderNames.push(name);
    }

    for (const [name, value] of Object.entries(credentialHeaders)) {
      if (headers[name] !== undefined) {
        summary.collisionRules.push({ header: name, source: "credential", action: "overrode_previous_header" });
      }
      headers[name] = value;
    }

    summary.staticHeaderNames.sort();
    summary.passthroughHeaderNames.sort();
    summary.droppedPassthroughHeaderNames = [...new Set(summary.droppedPassthroughHeaderNames)].sort();
    summary.metadataHeaderNames.sort();
    return { headers, summary };
  }

  async function markRemoteConnectionHealth(
    connection: typeof toolConnections.$inferSelect,
    status: "ok" | "error" | "missing_secret" | "degraded",
    message: string | null,
  ) {
    const now = new Date();

View on GitHub (pinned to 01ad858492)

Solutions

1. Enable the connection in connection settings before invoking its tools.

When it happens

Trigger: Thrown at server/src/services/tool-gateway.ts:2531 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of paperclipai/paperclip@01ad858492 (2026-08-18). Data as JSON: /api/errors/8eae9d090229c267. Report an issue: GitHub.