概要
Claude Desktop 上で Instana MCP Server Extension を利用し、Instana の API に接続してパフォーマンスデータを取得しようとしたところ、
以下のような SSL 証明書検証エラー が発生しました。
SSLError(SSLCertVerificationError(1, '[SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed:
unable to get local issuer certificate (_ssl.c:1006)'))
結果として、Claude が Instana API（例: /api/application-monitoring/services）へ接続できず、
「Max retries exceeded」「Failed to get services」などのエラーが表示されました。
発生状況
| 項目 | 内容 |
|---|---|
| OS | macOS (Apple Silicon) |
| 環境 | Claude Desktop + Instana MCP Server Extension |
| Python | 3.11 (python.org版) |
| 接続先 | https://sandbox-XXXXXX.instana.io |
| 症状 | Instana MCP Extension が API 通信時に SSL 証明書検証に失敗 |
Prompt例:
nginx-webというアプリケーションのEndpoint一覧をリストお願いします
表示されたエラーメッセージ（抜粋）
Get Application Endpoints
Request
{
`name_filter`: `nginx-web`
}
Response
{"error":"Failed to get application endpoints: HTTPSConnectionPool(host='sandbox-XXXXX.instana.io', port=443): Max retries exceeded with url: /api/application-monitoring/applications/services/endpoints?nameFilter=nginx-web&windowSize=3600000&to=1760429124428 (Caused by SSLError(SSLCertVerificationError(1, '[SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed: unable to get local issuer certificate (_ssl.c:1006)')))"}
原因分析
macOS の curl コマンドでは Instana API に正常にアクセスできた一方で、
Claude Desktop（＝内部的に Python/requests を利用）が同じURLにアクセスすると失敗していました。
つまり：
✅ OS レベルでは証明書が信頼済み
❌ Python の certifi バンドルに CA 証明書が含まれていない
という典型的な macOS 特有の問題です。
macOS ではシステムキーチェーンの証明書は Python から自動では参照されず、
certifi パッケージ経由の CA バンドルを正しく設定する必要があります。
🔧 解決策
結論から言うと、macOS の Python に公式 CA 証明書バンドルを再インストールすることで解決します。
### 実行コマンド
/Applications/Python\ 3.*/*Install\ Certificates.command
例：
user1@jacky-MacBook-Air subdownloads % /Applications/Python\ 3.*/*Install\ Certificates.command
-- pip install --upgrade certifi
Collecting certifi
Obtaining dependency information for certifi from https://files.pythonhosted.org/packages/e4/37/af0d2ef3967ac0d6113837b44a4f0bfe1328c2b9763bd5b1744520e5cfed/certifi-2025.10.5-py3-none-any.whl.metadata
Downloading certifi-2025.10.5-py3-none-any.whl.metadata (2.5 kB)
Downloading certifi-2025.10.5-py3-none-any.whl (163 kB)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 163.3/163.3 kB 2.8 MB/s eta 0:00:00
Installing collected packages: certifi
Successfully installed certifi-2025.10.5
[notice] A new release of pip is available: 23.2.1 -> 25.2
[notice] To update, run: /Library/Frameworks/Python.framework/Versions/3.11/bin/python3.11 -m pip install --upgrade pip
-- removing any existing file or link
-- creating symlink to certifi certificate bundle
-- setting permissions
-- update complete
このコマンドは python.org 版の Python に付属しており、
内部的に以下を行います：
-
pip install --upgrade certifi（最新のルートCA証明書を取得） -
certifiバンドルを Python の SSL 設定にリンク - macOS キーチェーンと統合されるように設定更新
実行後の確認
1. curl での疎通
curl -I https://sandbox-XXXXXX.instana.io/api/instana/health
→ HTTP/2 401 が返れば通信・TLSは正常（401は認証必須を意味）。
2. Python 側での確認
python3 -c "import certifi; print(certifi.where())"
→ /Library/Frameworks/Python.framework/.../site-packages/certifi/cacert.pem のようなパスが出ればOK。
3. Instana API テスト
export INSTANA_TOKEN=<your_api_token>
curl -sS -H "Authorization: apiToken $INSTANA_TOKEN" \
"https://sandbox-XXXXXX.instana.io/api/application-monitoring/services?nameFilter=frontendservice&windowSize=86400000"
→ {} または JSON が返れば接続完了。
Claude Desktop の再起動が必要な理由
Claude Desktop は拡張（MCP Server Extension）を起動時に一度だけロードします。
そのため、Python 側の証明書設定を変更した後は Claude の再起動 が必須です。
# 設定反映には完全再起動
⌘ + Q → Claude Desktop 再起動
再起動後、Instana MCP Extension からの接続が正常化しました。
最終確認：Instana での動作
修復後、Claude MCP Extension にて以下のような操作が正常に動作：
“I'll retrieve the performance data for the robotshop service over the last 24 hours using the available Instana tools.”
- Instana MCP → Instana API 経由でデータ取得
- メトリクス項目：Latency (mean, P95, P99), Error Rate, Call Volume, Erroneous Calls
或いは
📘 補足：SSLエラーの一般的な原因パターン
| 原因 | 対応策 |
|---|---|
| Python の certifi 不備 | /Applications/Python*/Install Certificates.command |
| 社内プロキシ／独自CA |
REQUESTS_CA_BUNDLE=/path/to/ca.pem を設定 |
| VPN/Firewall ブロック | Instana ドメインをホワイトリスト化 |
| 日付/時刻のズレ | NTP 同期 |
| トークン無効 | Instana UIで再発行 |
まとめ
| 項目 | 内容 |
|---|---|
| 現象 | Instana MCP Extension で SSL 証明書検証エラー |
| 原因 | macOS の Python に CA バンドルが未設定 |
| 解決策 |
/Applications/Python*/Install Certificates.command を実行 |
| 再起動 | Claude Desktop を再起動して反映 |
| 確認 | curl / certifi / API 呼び出しで通信確認 |