KB-7778

GPT Analysis — Agent High-Concurrency Connector Bottleneck (2026-05-29)

3 min read Revision 1
gptagentconcurrencymcpconnectorclaude-codesshpostgresdiagnostic2026-05-29

GPT Analysis — Agent High-Concurrency Connector Bottleneck

Date: 2026-05-29 Reviewer: GPT Council via Web Connector fallback

Trigger

User observed repeated failures when Claude Code/Opus-style agent ran many parallel calls:

  • many Bash/SSH calls were cancelled after one parallel Bash error;
  • query_pg calls failed because required parameters such as database were omitted;
  • Agent Data/KB calls returned Invalid tool parameters;
  • a previous Claude session hit API 400 around thinking/redacted_thinking blocks;
  • Codex independently verified VPS/containers/health endpoints were healthy.

Initial verdict

This does not look like raw VPS capacity failure. It is more likely a connector/session/concurrency contract problem:

  1. Claude Code parallel tool execution can fan out multiple tool calls, but current operational lanes appear fragile when one parallel call errors; siblings get cancelled.
  2. MCP/Agent Data tools are strict about schemas; missing required params create tool errors that can cascade in a parallel batch.
  3. Long SSH/docker/psql calls without server-side timeout or transaction hygiene can leave stale/open sessions if client-side cancellation occurs.
  4. Some KB/Agent Data pathways may not be optimized for very high concurrent tool calls; write/upload/search calls should be throttled or queued.
  5. The thinking/redacted_thinking error is a Claude session-state/client issue, not a VPS issue.

Strategic implication

The user's suspicion is directionally valid: modern agents can attempt many concurrent tool calls, but the current interaction gateway may need a high-throughput agent work lane. The bottleneck is probably not CPU/RAM alone; it is the safety and orchestration layer around tools.

Run a dedicated diagnostic/design macro:

AGENT_HIGH_CONCURRENCY_CONNECTOR_LANE_DIAGNOSTIC_AND_UPGRADE_PLAN

Scope:

  • measure current MCP/Agent Data/SSH/DB/API concurrency limits;
  • inspect API schemas and required parameters;
  • identify cancellation behavior and timeout policy;
  • design a high-throughput but safe Agent Work Lane;
  • add connection pooling, queueing, rate limits, per-agent lanes, idempotency keys, server-side timeouts, and transaction cleanup policies;
  • produce no-production-mutation diagnostics first.

Guardrail

Do not simply increase server size before measuring connector limits. Upgrade hardware only after identifying whether the bottleneck is network, reverse proxy, MCP server, Agent Data, Postgres connections, Docker exec, SSH MaxSessions, or Claude client/session state.

Back to Knowledge Hub knowledge/dev/reports/architecture/agent-high-concurrency-connector-bottleneck-gpt-analysis-2026-05-29.md