Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

stdio + Internal Integration token hangs on init in Claude Code MCP client

Aperta
  • Qualcosa non va?
#1,023 3 commenti 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
4/5
Tempo stimato
3-5 giorni
Idoneità per principianti
38/100
Tipo di issue
Bug
Chiarezza
Da chiarire
Stato di attività
Tranquilla
Stack tecnologico
typescript
Ambito
api, backend

Direzione di ricerca

Riprodurre il blocco dell'inizializzazione con @sentry/[email protected], il trasporto stdio e un token Custom (Internal) Integration in Claude Code. Confrontare questo comportamento con lo stesso server e lo stesso token avviati direttamente, quindi tracciare l'handshake di inizializzazione MCP e il ciclo di vita del processo. Il lavoro è completato quando l'inizializzazione termina, viene segnalato esplicitamente un errore di autenticazione quando appropriato e vengono registrati gli strumenti previsti.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

bug question

Problem

When using @sentry/mcp-server via the stdio transport with a Custom (Internal) Integration token, the MCP server initialization hangs indefinitely in a "pending" state inside Claude Code's MCP stdio client. No tools are registered and no explicit auth error is returned — the handshake never completes.

This is distinct from getsentry/sentry-mcp#833, which tracks the remote HTTP endpoint (mcp.sentry.dev) not supporting API token auth. The stdio transport with a bound token is the documented workaround for headless environments, but it fails in this specific client.

Symptom

  • MCP server stays in "pending" / initializing state indefinitely
  • No tools registered in the client
  • No explicit error or timeout surfaced

Reproduction Context

  • Client: Claude Code MCP stdio client (desktop/local, not web IDE)
  • Server: @sentry/[email protected] (confirmed across multiple versions)
  • Token type: Custom (Internal) Integration token — a single org-level bot token, not a per-developer user auth token
  • Transport: stdio

What was ruled out

  • Token is valid — GET https://sentry.io/api/0/ returns HTTP 200 with the same token, scopes look correct
  • @sentry/[email protected] spawned directly with the same token initializes cleanly and exposes 22 tools
  • Per-developer OAuth flow through the same MCP works fine for individual devs
  • The Claude Code stdio client is not at fault for the token itself — CLI tools work with it without issue

Diagnosis

The failure sits somewhere in the initialization handshake between Claude Code's MCP stdio client and the server when using an Internal Integration token. The same server + token combination works when spawned outside of Claude Code's client, so this is likely either:

  • A difference in how Claude Code's stdio client drives the MCP init sequence (e.g. environment, process lifecycle, or handshake timing)
  • A code path in the server that behaves differently for Internal Integration tokens vs. user auth tokens during initialization

Use Case

Headless bot pattern: a single shared Internal Integration token bound to a bot account, used by an internal Claude agent running inside Claude Code. OAuth per-developer is not viable here — the agent needs a single stable identity.

Workaround in place: using the Sentry CLI directly with the same token instead of the MCP path.

Related

  • getsentry/sentry-mcp#833 — request for token auth on the remote HTTP endpoint (different surface, same underlying headless-agent pattern)
  • anthropics/claude-code#40835 — Claude Code remote environments issue where tools don't register initially (may be related on the client side)

Action taken on behalf of Wassim Melakhessou.

Lingua principale
TypeScript
Stelle
938
Fork
166
Merge medio
1g 7h
PR unite (30g)
156

Preparare l'ambiente

Questo progetto non fornisce container di sviluppo, Dockerfile né guida per i contributori, quindi l'ambiente è a tuo carico: parti dal suo README e consulta la nostra guida al primo contributo per i passaggi generali.

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di getsentry/toolkit

Tutte le issue di getsentry/toolkit

Issue simili

Altre issue su TypeScript

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.