[BUG] MCP `http` transport bypasses Authorization header, attempts OAuth2 registration

[saiya]

Environment

• Platform (select one):
  • Anthropic API
  • AWS Bedrock
  • Google Vertex AI
  • Other:
• Claude CLI version: 1.0.31 (Claude Code)
• Operating System: MacOS 15.5
• Terminal: Terminal App

Bug Description

Similar to #1763, Claude Code attempts OAuth2 Dynamic Client Registration despite the MCP being configured with an Authorization header.

Steps to Reproduce

1. Run a server on localhost:8098
2. claude mcp add --transport http my-mcp-local 'http://localhost:8098/ai/mcp' -H "Authorization: Bearer dummy"
3. Open claude and type /mcp to verify the configuration

Expected Behavior

• Claude Code should perform MCP initialization WITHOUT any OAuth2-related processes

Actual Behavior

• Claude /mcp returns the error: Error: Dynamic client registration failed: HTTP 404
• The server access logs show requests to GET /.well-known/oauth-authorization-server and POST /register

Additional Context

claude mcp get my-mcp-local displays the following output, which confirms the Authorization header is configured:

my-mcp-local:
  Scope: Local (private to you in this project)
  Type: http
  URL: http://localhost:8098/ai/mcp/observability
  Headers:
    Authorization: Bearer dummy

To remove this server, run: claude mcp remove "my-mcp-local" -s local

[ashwin-ant]

Hey, we released some fixes around MCP connections in recent versions. Can you see if this still happens on the current version (1.0.40)?

[saiya]

Thank you for rapid response. With the 1.0.40, http transport with Authorization header working well!

.mcp.json like this worked fine:

{
  "mcpServers": {
    "observability-local": {
      "type": "http",
      "url": "http://localhost:8098/ai/mcp/observability",
      "headers": {
        "Authorization": "Bearer dummy"
      }
    },

[github-actions]

This issue has been automatically locked since it was closed and has not had any activity for 7 days. If you're experiencing a similar issue, please file a new issue and reference this one if it's relevant.