Skip to content

fix(agents): Add type: http to MCP HTTP server configs#13

Merged
gricha merged 1 commit intomainfrom
fix/mcp-http-server-configs
Feb 17, 2026
Merged

fix(agents): Add type: http to MCP HTTP server configs#13
gricha merged 1 commit intomainfrom
fix/mcp-http-server-configs

Conversation

@gricha
Copy link
Member

@gricha gricha commented Feb 17, 2026

Claude Code requires type: "http" for remote MCP servers, but dotagents omitted this field — causing Claude to reject the config as malformed. Auditing all 5 agent serializers revealed additional issues:

  • Claude: missing type field entirely — config rejected as malformed
  • Cursor: inherited Claude's broken output (also missing type)
  • VS Code: emitted deprecated type: "sse" instead of type: "http"
  • Codex: inherited Claude's headers key instead of Codex's expected http_headers
  • OpenCode: already correct (type: "remote")

Fixes all three broken agents by adding type: "http" to Claude (inherited by Cursor), updating VS Code from "sse" to "http", and giving Codex its own serializer that maps headershttp_headers and omits type.

Also adds HTTP server e2e tests for every agent in mcp-writer.test.ts to catch this class of bug going forward.

Co-Authored-By: Claude noreply@anthropic.com

Agent transcript: https://claudescope.sentry.dev/share/sp-UeENVVXGpFReEmk6k7mczIHjWq3GcBaW3GKrWGeg

Claude Code requires `type: "http"` for remote MCP servers but we
omitted it, causing configs to be rejected as malformed. Also fix
VS Code emitting deprecated `type: "sse"` and Codex inheriting
Claude's `headers` key instead of its expected `http_headers`.

Changes per agent:
- Claude: add `type: "http"` to HTTP server output
- Cursor: inherits Claude, now also gets `type: "http"`
- VS Code: change `type: "sse"` to `type: "http"`
- Codex: custom serializer with `http_headers` and no `type`
- OpenCode: already correct, no change

Co-Authored-By: Claude <noreply@anthropic.com>

Agent transcript: https://claudescope.sentry.dev/share/2j5FKYpMaTzAMO17OdUbBZ4S1MTn7j43PbprXy0fgm8
@gricha gricha marked this pull request as ready for review February 17, 2026 22:39
@gricha gricha merged commit 94e0a4f into main Feb 17, 2026
13 checks passed
@gricha gricha deleted the fix/mcp-http-server-configs branch February 17, 2026 22:50
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant