Connect a remote HTTP MCP server

mcp, agents & hooks

// what it does

claude mcp add --transport http <name> <url> connects a hosted MCP server (the recommended transport for cloud services). Add --header "Authorization: Bearer $TOKEN" for authenticated endpoints. After adding, run /mcp and confirm the server shows connected; a server with bad credentials shows failed. The older --transport sse is deprecated in favor of http.

// shell

$ claude mcp add --transport http sentry https://mcp.sentry.dev/mcp
$ claude mcp add --transport http my-api https://api.example.com/mcp --header "Authorization: Bearer $TOKEN"

// gotcha

claude mcp add saves the configuration without validating credentials, so a placeholder token is accepted and the server only fails later when it tries to connect. Always verify with /mcp instead of assuming the add succeeded.

// resources