Tls Radar

Claude Code と Cowork 用 TLS Radar プラグイン

Claude Code または Claude Cowork 内から、SSL/TLS スキャンの実行、無料の Let's Encrypt 証明書の発行、証明書モニタリングの管理ができます。設定不要で、単一の MCP サーバーを通じて利用できます。

証明書を販売しないベンダーによる独立したモニタリングです。手動での更新管理がすでに不要となった、90 日証明書の時代に向けて構築されています。

# Public - no account, no setup
/tls-scan example.com                       # free SSL/TLS scan
/tls-cert mydomain.dev                      # free 90-day Let's Encrypt cert (private key stays local)
/tls-renew mydomain.dev                     # renew a cert

# Connect once for monitoring (OAuth via /mcp)
/mcp                                        # built-in Claude Code OAuth flow
/tls-monitor add api.foo.io                 # one or many: /tls-monitor add a.com b.com c.com
/tls-monitor list
/tls-monitor remove api.foo.io
/tls-diagnose                               # health check (use when something's off)
/tls-upgrade                                # open pricing page

インストール前に実際の出力を確認できます： スキャンレポートのサンプル

「まもなく期限切れになる証明書は？」「X のスキャン履歴を見せて」「利用中のプランは？」「モニターをエクスポート／インポートして」「チームメイトを招待して」などの操作は、自然な言葉で尋ねるだけです。プラグインのスキルが適切なツールに振り分けるため、スラッシュコマンドは必要ありません。

仕組み

Claude Code の MCP クライアントは、1 つのリモートサーバーと通信します。

• tlsradar.com/api/v1/mcp

証明書の発行は、そのサーバーを経由して Let's Encrypt のバックエンド（Beacon）にプロキシされます。そのため、接続も認証方式も 1 つだけで、2 つ目のサーバーも、シェルに貼り付けるトークンも必要ありません。

• 公開ツール（scan、create_certificate、check_certificate_propagation、finalize_certificate、get_certificate_status、renew_certificate）はアカウントなしで利用できます。
• 認証が必要なツール（モニタリング、プラン情報、エクスポート／インポート、チーム）では、Claude Code に組み込まれた OAuth 2.0 + PKCE を使用します。/mcp を一度実行し、tlsradar サーバーを選択して、ブラウザーで承認します。トークンは Claude Code が管理します。

/mcp を実行すると、Claude Code は tlsradar.com/.well-known/oauth-authorization-server（RFC 8414）を取得し、パブリッククライアントとして動的に登録（RFC 7591）して、同意を得るためブラウザーを開きます（PKCE / RFC 7636）。以降のリクエストにはトークンが自動的に含まれます。

証明書の秘密鍵はローカルに保持されます

/tls-cert は、お使いのマシン上でキーと CSR を生成します（同梱のテスト済みヘルパーを使用します。このヘルパーはキーを 0600 の権限で書き込み、既存のキーを上書きせず、バックアップします）。送信するのは CSR のみです。秘密鍵がコンピューターの外に出ることはなく、パスフレーズをチャットに入力する必要もありません。発行された証明書を提示する前に、プラグインは返されたチェーンが実際にドメインをカバーしていることをローカルで検証します。.p12 バンドル（Windows／Java へのインポートなど）が必要な場合も、プラグインがローカルでパッケージ化します。

発行が中断されても再開できます。オーダーの状態は ~/.config/tlsradar/orders/<domain>.json に保存されるため、フローの途中でセッションを閉じても、後から「example.com の証明書発行を完了して」と伝えるか、/tls-cert を再実行すれば、中断したところから再開できます。/tls-renew は、そのファイルに保存されたメールアドレスとチャレンジ方式を確認のうえ再利用します。

ドメインの所有権を証明する方法は自分で選べます。選択内容は ~/.config/tlsradar/config.json に保存されます。

• dns-01 - TXT レコードを手動で追加します（どこでも利用できます）。
• dns-01-cloudflare / dns-01-route53 - プラグインがプロバイダー API を使って TXT レコードを設定します。トークンはローカル環境（CLOUDFLARE_API_TOKEN、または設定済みの aws CLI）から読み取ります。これらの認証情報はお使いのマシンに保持され、TLS Radar や Beacon に送信されることはありません。
• http-01 - http://yourdomain（ポート 80）でファイルを提供します。発行対象は apex ドメインのみです。

証明書が発行されると、TLS Radar から継続的なモニタリングについてメールが届きます。証明書からモニタリングへの引き継ぎは、すべてサーバー側で自動的に行われます。

Claude Code と Cowork で動作

標準的なプラグインなので、Claude Code と Claude Cowork の両方で動作します。スキャン、証明書の発行、監視はどちらのクライアントでも利用できます。ツールは単一の MCP サーバーから提供され、証明書発行のフローでは openssl と同梱のヘルパースクリプトをローカルで実行します（どちらのクライアントも、${CLAUDE_PLUGIN_ROOT} を使ってローカルコマンドと同梱スクリプトを実行できます）。監視への接続には、クライアントに組み込まれた OAuth を使います。Claude Code では /mcp を、Cowork では同等の接続手順を実行してください。

Claude.ai での使用（カスタムコネクタ）

Claude からスキャンや監視を行うのに、Claude Code は必要ありません。TLS Radar は標準のリモート MCP サーバーなので、Free を含むすべてのプランで、Claude.ai アプリ（ウェブ、デスクトップ、モバイル）にカスタムコネクタとして追加できます（Free ではコネクタを 1 つ利用できます）。

1. Settings → Connectors を開きます（Team／Enterprise の場合は Organization settings → Connectors。Owner のみ）。
2. Add custom connector をクリックします。
3. コネクタ URL を貼り付けます：https://tlsradar.com/api/v1/mcp/connect
4. 保存し、OAuth のプロンプトが表示されたら TLS Radar にサインインします（コネクタは認証が必要な接続先です。一度サインインしてアカウントを接続すれば、スキャンと監視の両方を利用できます）。

あとは自然な言葉で尋ねるだけです。「example.com をスキャンして」「まもなく期限切れになる証明書は？」「api.foo.io を監視して」などと入力してください。Claude.ai にはスラッシュコマンドはありません。ツールの説明に基づいてリクエストが処理されます。

アカウントがありませんか？代わりに Claude Code をお使いください。 匿名で、サインアップなしで利用できるスキャンと無料の証明書発行は、パブリックな …/api/v1/mcp エンドポイントと通信する Claude Code プラグイン（以下）で利用できます。ホスト型コネクタでは認証が必要なため、Claude.ai コネクタでは一度サインインする必要があります。

証明書の発行は Claude Code／Cowork の機能です。 /tls-cert は openssl で秘密鍵をローカルに生成しますが、Claude.ai アプリではローカルシェルを利用できないため実行できません。コネクタではスキャンと監視を利用できます。鍵を自分のマシンに保管したまま Let's Encrypt 証明書を発行するには、Claude Code／Cowork のプラグイン、または beacon.tlsradar.com のウェブフォームをお使いください。

インストール

Claude Code では、マーケットプレイスを追加してインストールします。クローンやパスの指定は不要で、コマンドは 2 つだけです。

/plugin marketplace add TLS-Radar/tlsradar-claude-plugin
/plugin install tlsradar@tlsradar

（または、マーケットプレイスを追加した後に /plugin メニューから参照できます。）Claude Cowork では、プラグインカタログから追加してください（「TLS Radar」を検索します）。これだけで、スキャンと証明書発行をすぐに利用できます。監視を利用するときは /mcp（または Cowork の接続手順）を実行してください。

git clone https://github.com/TLS-Radar/tlsradar-claude-plugin ~/.claude/plugins/tlsradar

Free プランの制限

• モニター 1 件を無料で利用できます
• 月 1 件のアラート（有効期限の 7 日前に配信）
• 無料スキャンは無制限（レート制限あり）
• Let's Encrypt による証明書発行は無料
• Free を含むすべてのプランで REST API を利用可能

モニターの上限に達すると、ツールの応答に推奨されるアップグレードプランと料金ページの URL が表示されます。

設定

設定は不要です。任意の環境変数：

• TLSRADAR_BASE_URL - TLS Radar の URL を上書きします（デフォルトは https://tlsradar.com）。ステージング環境やセルフホストで便利です。

匿名利用 ID。 スキャンまたは証明書コマンドを初めて実行すると、プラグインは ~/.config/tlsradar/install_id にランダムな ID を生成し、client_id 引数として渡します。これにより、匿名の利用状況を 1 つのインストールに紐付けられます。これはインストールを識別するものであり、個人を識別するものではありません。プラグインは起動フックを実行せず、シェル設定を変更せず、トラッキング用ヘッダーも送信しません。ID はローカルファイルから読み取られ、引数としてのみ送信されます。

オプトアウトするには： rm ~/.config/tlsradar/install_id を実行します。ファイルがなくなると、ID は送信されません。

プライバシーとセキュリティ

• このプラグインにはトークンや認証情報は含まれていません。このリポジトリに秘密情報はありません。詳しくはSECURITY.mdをご覧ください。
• OAuth トークンはこのプラグインではなく、Claude Code の MCP クライアントによって管理されます。
• 証明書の秘密鍵はローカルで生成され、サーバーに送信されることはありません。
• DNS プロバイダーの認証情報（CLOUDFLARE_API_TOKEN、AWS CLI）はローカル環境から読み取られ、TLS Radar や Beacon に送信されることはありません。
• 匿名のインストール ID が利用状況の把握のために送信されます。ツールの引数として渡され、~/.config/tlsradar/install_idから読み取られます（送信を無効にするには「設定」をご覧ください）。このプラグインはシェルファイルを変更せず、トラッキング用ヘッダーも送信しません。個人ではなく、インストールを識別します。
• アクセスを取り消すには、https://tlsradar.com/oauth/authorized_applicationsにアクセスするか、/mcpで MCP サーバーを削除してください。
• アクセストークンの有効期限は 2 時間です。リフレッシュトークンは使用時にローテーションされ、最大 90 日まで有効です。

構成

.
├── README.md                        # this file
├── CLAUDE.md                        # architecture / funnel / contracts (humans + AI agents)
├── CONTRIBUTING.md                  # dev loop + how to add commands
├── CHANGELOG.md                     # version history
├── SECURITY.md                      # reporting + why the plugin holds no secrets
├── LICENSE                          # MIT
├── .claude-plugin/plugin.json       # plugin manifest
├── .claude-plugin/marketplace.json  # self-hosting marketplace entry
├── .mcp.json                        # MCP server config (one remote URL)
├── commands/                        # slash commands (how to add one: CONTRIBUTING.md)
├── skills/                          # NL skill router (with its own README)
├── tools/manifest.json              # single source of truth for tool names
├── scripts/                         # CI guards + tested local helpers (DNS provider, cert CSR/chain)
└── evals/                           # tool-routing evals (prompt → expected tool)

コントリビューション

開発サイクルについては、まずCONTRIBUTING.mdをご覧ください（すべてのチェックはオフラインで実行でき、python3を使用します）。アーキテクチャ、ファネル、コントラクト上の落とし穴、リリースプロセスについてはCLAUDE.mdをご覧ください。人間にも AI エージェントにも役立ちます。変更はCHANGELOG.mdで追跡されています。

セキュリティに関する報告先：[email protected]（公開 issue にはしないでください）。詳しくはSECURITY.mdをご覧ください。

ライセンス

MIT © TLS Radar