npm.io
1.0.3 • Published 3d agoCLI

@gmobrandsecurity/brantect-mcp

Licence
MIT
Version
1.0.3
Deps
1
Size
231 kB
Vulns
0
Weekly
210
SummaryDependencyVersions

brantect-mcp

npm version ci License: MIT

AI クライアント（Claude Code、Gemini CLI、Claude Desktop など）を Model Context Protocol (MCP) 経由で BRANTECT アカウントに接続する CLI ブリッジです。

npx @gmobrandsecurity/brantect-mcp configure                          # 1. OAuth ログイン
claude mcp add brantect -- npx -y @gmobrandsecurity/brantect-mcp serve # 2. Claude Code に登録

これだけです。あとは AI に 「brantect で『Sony』の商標を検索して」 と聞くだけ。

他の言語: English

エンドユーザーガイド: docs/end-user.md （English · Tiếng Việt）

動作要件

  • Node.js >= 20 (nodejs.org)
  • BRANTECT アカウント
  • MCP 対応 AI クライアント — 例: Claude Code

インストールと使い方

Claude Code / CLI クライアント
# 1. 初回のみ OAuth ログイン（ブラウザを開き、~/.config/brantect-mcp/ にトークン保存）
npx @gmobrandsecurity/brantect-mcp configure

# 2. AI クライアントに stdio ブリッジを登録
claude mcp add brantect -- npx -y @gmobrandsecurity/brantect-mcp serve

# 3. （任意）Claude Code 用の 12 種類の BRANTECT スキルをインストール
npx @gmobrandsecurity/brantect-mcp skills           # ユーザー全体
npx @gmobrandsecurity/brantect-mcp skills --project # プロジェクトのみ

Claude Code で確認:

claude mcp list
# brantect    ✓ connected    83 tools
Claude Desktop

--desktop フラグを付けると、OAuth ログイン後に claude_desktop_config.json を自動で更新します。

npx @gmobrandsecurity/brantect-mcp configure --desktop

Claude Desktop を再起動 すると brantect-mcp が有効になります。

プラットフォーム 書き込み先
Windows %APPDATA%\Claude\claude_desktop_config.json
macOS ~/Library/Application Support/Claude/claude_desktop_config.json
Linux ~/.config/Claude/claude_desktop_config.json

注意: ファイルが存在する場合は mcpServers.brantect エントリのみ追加／更新し、他の設定（preferences、他の MCP サーバーなど）は保持します。

コマンド

コマンド 説明
brantect-mcp configure OAuth 2.0 + PKCE ログイン。config.json + tokens.json を ~/.config/brantect-mcp/ に保存。
brantect-mcp configure --desktop 上記に加え、claude_desktop_config.json に brantect エントリを自動書き込み。Claude Desktop を再起動すると有効になる。
brantect-mcp logout サーバー側で refresh token を失効（この端末のみ）し、ローカルの認証情報を削除。発行済みアクセストークンは有効期限（最大約23時間）まで有効。
brantect-mcp serve（デフォルト） stdio MCP ブリッジ。AI クライアントと BRANTECT MCP サーバー間で JSON-RPC を転送し、トークンを自動更新。
brantect-mcp skills 12 個の BRANTECT スキルファイルをインストール。--project は ~/.claude/skills/ の代わりに ./.claude/skills/ に書き込む。
brantect-mcp --help 使用方法を表示。
brantect-mcp --version バージョンを表示。

セキュリティ

  • OAuth 2.0 + PKCE (S256) — クライアントシークレットはパッケージに同梱されません。
  • state パラメータ — OAuth コールバックの CSRF 対策。
  • ループバックコールバックのみ — 127.0.0.1 のみ、0.0.0.0 は使用しない。
  • トークンはモード 0600 で保存（POSIX）— 所有ユーザーのみ読み取り可能。
  • OIDC publish — すべてのリリースは GitHub Actions OIDC（npm Trusted Publisher）経由で公開され、長期保存トークンを使用しません。

脆弱性の報告は SECURITY.md のプライベートチャネルからお願いします。

ログ

CLI が実行したタスク（ツール呼び出しの転送、トークン更新、ログイン／ログアウト、起動・終了、エラー）を日次ローテーションのログファイルに JSON Lines 形式で記録します。

  • 場所: ~/.config/brantect-mcp/logs/brantect-mcp-YYYY-MM-DD.log（Windows: %USERPROFILE%\.config\brantect-mcp\logs\）
  • 保持期間: 14 日（起動時に古いファイルを自動削除）
  • 機密情報は記録されません — トークン、Authorization ヘッダー、認可コード、PKCE verifier、リクエストパラメータは、いかなるログレベルでもファイルに書き込まれません。記録されるのはメソッド名・ツール名・リクエスト ID・処理時間・HTTP ステータスのみです。
環境変数 説明
BRANTECT_MCP_LOG_DIR ログディレクトリの変更
BRANTECT_MCP_LOG_LEVEL debug / info（デフォルト）/ warn / error / silent（ファイル出力を無効化）
BRANTECT_MCP_LOG_RETENTION_DAYS 保持日数の変更（デフォルト: 14）

トラブルシューティング

症状 対処
claude mcp list で ✗ Failed to connect と表示 npx @gmobrandsecurity/brantect-mcp configure を実行。node --version >= 20 を確認。
ERR_NOT_CONFIGURED configure が未実行です。
ERR_USER_DENIED OAuth 同意が拒否されました。configure を再実行し 許可 をクリック。
ERR_TIMEOUT OAuth フローが 60 秒を超えました。再試行してください。
ERR_NETWORK ネットワーク／ファイアウォールでブロックされています。BRANTECT サーバー（*.run.app）への接続性を確認。

詳細は docs/end-user.md （EN · VI）参照。

コントリビュート

プロジェクト構成、ローカル開発、リリースプロセスについては CONTRIBUTING.md を参照してください。

ライセンス

MIT GMO BrightsConsulting Inc.

リンク

Keywords

brantectmcpmodel-context-protocolclaudeaioauthpkcecli