Hacktoberfest 2026 : les issues que les mainteneurs ont marquées pour octobre, ouvertes et accessibles aux débutants. Parcourir les issues Hacktoberfest

Streamable HTTP client: a 401 or 403 with a JSON-RPC error body and no WWW-Authenticate loses its HTTP status

Fermée Adaptée aux débutants
#1,339 0 commentaires 0 réactions 0 personnes assignées Voir sur GitHub

Les mainteneurs répondent en général sous 3 jours

Une pull request liée a déjà été fusionnée.

  • #1341 par @aton-of-data — fusionnée

Évaluation

Difficulté
2/5
Temps estimé
1-3 heures
Accessibilité débutants
68/100
Type d'issue
Bug
Clarté
Clairement spécifiée
Activité
Active
Stack technique
rust

Piste de recherche

Lis crates/rmcp/src/transport/common/reqwest/streamable_http_client.rs, en particulier la branche de réponse non réussie autour des lignes 276–306 et les vérifications antérieures des statuts 401/403. Compare son traitement avec legacy_discover_response et le chemin d’erreur en texte brut. Le travail est terminé lorsqu’une réponse 401 ou 403 contenant un corps d’erreur JSON-RPC préserve le statut HTTP pour les appelants ; exécute les tests pertinents du client HTTP Streamable.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Description

bug P2 ready for work T-security T-transport

When a Streamable HTTP server answers a POST with 401 Unauthorized (or 403 Forbidden) without a WWW-Authenticate header and with a JSON-RPC error body, the reqwest client returns Ok(StreamableHttpPostResponse::Json(..)). The caller then gets an ordinary JSON-RPC error, ClientInitializeError::JsonRpcError during initialize or ServiceError::McpError after it, and cannot tell that the server rejected the credentials.

Where

The non-success branch parses the body with parse_json_rpc_error before it looks at the status:

https://github.com/modelcontextprotocol/rust-sdk/blob/c1a8eea312613519b93f53b89a1dc74dc993f5b0/crates/rmcp/src/transport/common/reqwest/streamable_http_client.rs#L276-L306

AuthRequired and InsufficientScope come only from the checks above it, which require WWW-Authenticate. The same 401 with a plain-text body becomes UnexpectedServerResponse("HTTP 401 Unauthorized: …"), so the status survives on that path but not on the JSON one.

Reproduce

rmcp 3.5.1 (main has the same code). The server answers initialize with:

HTTP/1.1 401 Unauthorized
Content-Type: application/json

{"jsonrpc":"2.0","id":0,"error":{"code":-32001,"message":"Unauthorized"}}

serve_client over StreamableHttpClientTransport::with_client(reqwest::Client, config) fails with ClientInitializeError::JsonRpcError (code -32001, message "Unauthorized"). Nothing in the error says HTTP 401.

Why it matters

A client that sends a static token through custom_headers wants to tell the user that the token was rejected. An OAuth client wants to start or refresh authorization. Both need the status. The MCP authorization spec asks servers that implement authorization to send WWW-Authenticate with a 401, but a server that only takes a static token is not bound by that and may answer with a JSON-RPC error body instead.

Possible fixes
  • Handle 401 and 403 before the JSON-RPC branch, as legacy_discover_response already does ("Keep authentication failures and server errors on their original paths"). For example, return AuthRequired or InsufficientScope for every 401 or 403, with the challenge optional, or return UnexpectedServerResponse("HTTP 401 …") as the plain-text path does.
  • Or keep the JSON-RPC error and carry the HTTP status with it.
Langage dominant
Rust
Étoiles
4.1k
Forks
680
Merge moyen
3 j 20 h
PR mergées (30 j)
32

Préparer son environnement

Ouvrir dans Codespaces

Lance le conteneur de développement du projet dans votre navigateur, avec votre propre compte GitHub.

Par où commencer

  1. Lisez l'issue en entier, puis le guide de contribution du projet.
  2. Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
  3. Forkez le dépôt et travaillez sur une branche.
  4. Ouvrez une pull request qui référence le numéro de l'issue.

Autres issues de modelcontextprotocol/rust-sdk

Toutes les issues de modelcontextprotocol/rust-sdk

Issues similaires

Plus d'issues Rust

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.