起きたこと
ある日突然、Claude Code から Atlassian MCP(Jira / Confluence 連携)に接続できなくなりました。
❯ /mcp
❯ atlassian · ✘ failed
再起動、再認証、Claude Code のバージョンダウンなど色々試しましたがダメでした。
結論
SSE 接続を HTTP(Streamable HTTP)に切り替えたら直りました。
やり方
1. 既存の設定を削除
claude mcp remove atlassian
2. HTTP で追加し直す
claude mcp add atlassian-http --transport http https://mcp.atlassian.com/v1/mcp
全プロジェクト共通にしたい場合は -s user をつけます。
claude mcp add atlassian-http -s user --transport http https://mcp.atlassian.com/v1/mcp
3. Claude Code を再起動
/exit
再度起動して /mcp で確認。
❯ atlassian-http · ✔ connected
何が変わったのか
| 変更前(SSE) | 変更後(HTTP) | |
|---|---|---|
type |
sse |
http |
url |
https://mcp.atlassian.com/v1/sse |
https://mcp.atlassian.com/v1/mcp |
~/.claude.json 上ではこうなります:
"mcpServers": {
"atlassian-http": {
"type": "http",
"url": "https://mcp.atlassian.com/v1/mcp"
}
}
なぜ HTTP だと動くのか
MCP には SSE(Server-Sent Events)と Streamable HTTP の2つのトランスポート方式があります。
Atlassian 側は両方のエンドポイントを提供していますが、SSE(/v1/sse)側が不安定になるタイミングがあるようです。HTTP(/v1/mcp)に切り替えることで接続が安定しました。
同様の報告は以下の Issue でも確認できます:
環境
- Claude Code: v2.x
- macOS
まとめ
Atlassian MCP が突然繋がらなくなったら、まず SSE → HTTP への切り替えを試してみてください。コマンド1行で済みます。