claude-code - 💡(How to fix) Fix [BUG] `claude mcp add --transport streamable-http` fails with "Invalid transport type" error [3 comments, 2 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
anthropics/claude-code#46835Fetched 2026-04-12 13:31:49
View on GitHub
Comments
3
Participants
2
Timeline
9
Reactions
0
Author
Timeline (top)
labeled ×4commented ×3closed ×1cross-referenced ×1

Error Message

claude mcp add --transport streamable-http asana https://mcp.asana.com/v2/mcp (from https://code.claude.com/docs/en/mcp) shouldn't error.

Code Example

$ claude mcp add --transport streamable-http asana https://mcp.asana.com/v2/mcp
Invalid transport type: streamable-http. Must be one of: stdio, sse, http
RAW_BUFFERClick to expand / collapse

Preflight Checklist

  • I have searched existing issues and this hasn't been reported yet
  • This is a single bug report (please file separate reports for different bugs)
  • I am using the latest version of Claude Code

What's Wrong?

claude mcp add does not accept streamable-http as a transport type, despite it being documented in the official Claude Code docs and referenced by third-party MCP integrations.

What Should Happen?

claude mcp add --transport streamable-http asana https://mcp.asana.com/v2/mcp (from https://code.claude.com/docs/en/mcp) shouldn't error.

Steps to Reproduce

$ claude mcp add --transport streamable-http asana https://mcp.asana.com/v2/mcp
Invalid transport type: streamable-http. Must be one of: stdio, sse, http

Claude Model

None

Is this a regression?

I don't know

Claude Code Version

2.1.101

Platform

Anthropic API

Operating System

macOS

Terminal/Shell

Terminal.app (macOS)

extent analysis

TL;DR

The claude mcp add command may not be recognizing streamable-http as a valid transport type due to a potential discrepancy between the documentation and the actual implementation.

Guidance

  • Verify the documentation for claude mcp add to ensure that streamable-http is indeed a supported transport type and that the syntax is correct.
  • Check the version history of Claude Code to see if streamable-http was supported in previous versions and if it was removed or deprecated.
  • Try using a different transport type, such as http, to see if the command works as expected.
  • Review the error message to see if it provides any additional information about the supported transport types.

Example

No code snippet is provided as the issue is related to a command-line interface and not a programming language.

Notes

The issue may be due to a documentation error or a bug in the claude mcp add command. Further investigation is needed to determine the root cause.

Recommendation

Apply workaround: Try using a different transport type, such as http, to see if the command works as expected. This may help to identify if the issue is specific to the streamable-http transport type.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING