Claude Code ガイド

Appearance

原文（日本語に翻訳） ​

claude.ai MCPコネクターの接続失敗時に、ツールリストから静かに消えるのではなく通知を表示するように変更

原文（英語） ​

Changed claude.ai MCP connector failures to show a notification instead of silently disappearing from the tool list

概要 ​

claude.aiのMCPコネクターがサーバーへの接続に失敗した際、これまではツールリストから静かに消えるだけで、ユーザーは問題が起きていることに気づきにくい状態でした。この変更により、接続失敗時には明示的な通知が表示されるようになり、問題をすぐに把握して対処できます。

変更前後の比較 ​

変更前 - 静かに消える：

# MCPサーバーが接続できなくなっても気づかない
# ツールリストからそのサーバーのツールが消えるだけ

変更後 - 通知で知らせる：

[通知] MCP コネクター "my-database" の接続が失敗しました
       サーバーが起動しているか確認してください

基本的な使い方 ​

通知が表示されたら、以下を確認してください：

  1. MCPサーバーが起動していること
  2. ネットワーク接続が問題ないこと
  3. 認証設定（APIキー、OAuthトークン）が有効なこと

実践例 ​

MCPサーバーの状態確認 ​

通知を受け取ったら：

bash
# MCPサーバーのプロセスを確認
ps aux | grep mcp-server

# MCPサーバーのログを確認
cat ~/.claude/mcp-logs/my-server.log

MCPサーバーを再起動する ​

bash
# MCPサーバープロセスを再起動
kill $(pgrep -f mcp-server)
mcp-server &

# Claude Code内でMCPを再接続
/reload-plugins

接続設定を確認する ​

json
// .mcp.json
{
  "mcpServers": {
    "my-server": {
      "command": "mcp-server",
      "args": ["--port", "3000"],
      "env": {
        "API_KEY": "${MY_API_KEY}"
      }
    }
  }
}

環境変数 MY_API_KEY が正しく設定されているか確認してください。

注意点 ​

  • 通知はclaude.ai MCPコネクター（リモートMCPサーバー）の接続失敗に関するものです
  • ローカルMCPサーバーの接続失敗も同様に通知されます
  • 頻繁に通知が表示される場合は、MCPサーバーの安定性や接続設定を見直してください

関連情報 ​