Skip to main content
Glama
deenesjakoruzh
konsulto

@konsulto/mcp

Official
by konsulto
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

@konsulto/mcp

License: MIT Node

Claude Code（およびその他のMCP対応クライアント）が、CLIからKonsultoサイバーセキュリティ監査プラットフォームを操作できるようにするMCPサーバーです：

  • 読み取り — 参加中の監査の一覧表示、指摘事項やテンプレートの検索、指摘事項の読み取り（LLMが文章を推論できるようにMarkdown形式でレンダリングされた本文を含む）、セクション単位の読み取り。

  • 書き込み — 構造化されたフィールドからの指摘事項作成（バックエンドがTiptap形式の本文を構築）、スカラー値の更新、Markdownを使用したセクション本文の追加・置換、ドライランプレビュー付きのステータス一括変更。

  • 証拠 — ファイル/インラインコンテンツ/base64のアップロード、指摘事項の適切なセクションへの証拠の組み込み。

  • スコープと資産 — スコープの一覧表示、資産の一覧表示・作成、資産の照合・作成および指摘事項へのリンク付け。

ユーザーのロール権限に基づいて動作し、ユーザーごとのMCPトークンによって制御されます。テナントの機能フラグが有効であること、ロールに mcp:use があること、トークンが失効・期限切れでないこと、という3つの実行時ゲートがあります。

クイックスタート

1. KonsultoウェブアプリでMCPトークンを発行する

サインイン → プロフィール → MCPトークン → 新しいMCPトークン。kon_mcp_… の値をコピーしてください（一度しか表示されません）。（テナント管理者が アカウント → APIアクセス でMCP統合を有効にしている必要があります。）

2. トークンをローカルに保存する

mkdir -p ~/.konsulto && chmod 700 ~/.konsulto
cat > ~/.konsulto/credentials <<EOF
token: kon_mcp_REPLACE_WITH_YOUR_TOKEN
endpoint: https://api.konsulto.io
EOF
chmod 600 ~/.konsulto/credentials

ファイルを作成したくない場合は、KONSULTO_TOKEN 環境変数を使用してください。

3. Claude Codeにサーバーを認識させる

~/.claude/mcp.json に以下を追加します：

{
  "mcpServers": {
    "konsulto": {
      "command": "npx",
      "args": ["-y", "@konsulto/mcp"]
    }
  }
}

接続を確認します：

npx @konsulto/mcp doctor

すべて緑色のチェックマークが表示されるはずです。

Related MCP server: claude-sessions-mcp

フォルダーの固定（推奨・任意）

エンゲージメントフォルダー内で npx @konsulto/mcp init を実行し、特定の監査に固定します：

~/audits/acme-q2-pentest/
├── .konsulto.yml          ← pins this folder to one audit
├── recon/
└── notes.md

そのフォルダー（またはサブフォルダー）でClaude Codeを起動すると、MCPが自動的に監査を固定します。監査IDを意識する必要はもうありません。

このファイルはチームと共有可能です。監査IDとオプションのエンドポイントが含まれますが、機密情報は含まれません。

ワークフローパターン

パターン

使用タイミング

フォルダー固定 .konsulto.yml

同じエンゲージメントで繰り返し作業する場合。フォルダーごとに一度 konsulto init を実行。

セッションごとの set_active_audit

1つのワークスペースで、意識的に監査を切り替える場合。Claudeに「<監査名>に切り替えて」と指示。

呼び出しごとの明示的指定

1つのセッションで複数の監査を扱う場合。各ツール呼び出しに audit: を渡す。

ツール

すべてのツールには konsulto_* というプレフィックスが付いているため、設定済みの他のMCP（Burp、nmap、prowlerなど）と競合しません。

IDとコンテキスト

ツール

内容

konsulto_whoami

ID、権限、アクティブな監査。セッションの最初に呼び出します。

konsulto_list_my_audits

参加中の監査の一覧。

konsulto_set_active_audit

セッションの残りの期間、特定の監査を固定（名前によるあいまい一致）。

konsulto_get_audit_context

概要の確認 — 名前、ステータス、スコープ/資産数、重大度の集計、チーム。

テンプレート

ツール

内容

konsulto_search_templates

クエリ/重大度で指摘事項テンプレートを検索。軽量な形式 — ID、タイトル、重大度、概要、スロット名、分類。本文は含まれません。

指摘事項 — 読み取り

ツール

内容

konsulto_search_findings

監査内を検索（デフォルトはアクティブな監査）。

konsulto_get_finding

LLMが文章を推論できるようにMarkdown形式でレンダリングされた本文を含む指摘事項を読み取り。

konsulto_read_section

指摘事項の本文の1セクションのみをMarkdownとして読み取り。「POCを説明して」といった場合に get_finding より低コスト。

指摘事項 — 書き込み

ツール

内容

konsulto_compose_finding

構造化フィールド + オプションのテンプレート + 証拠から作成。バックエンドがTiptap形式の本文を構築。

konsulto_update_finding

スカラーフィールド（タイトル、重大度、ステータス、分類、資産）を変更。

konsulto_bulk_update_status

ステータスの一括変更。プレビュー用の dryRun: true をサポート。

konsulto_append_to_section

セクションにMarkdownの文章を追加。セクション名はエイリアス（recommendations, mitigation, fix, summaryなど）を受け入れ、サーバー側で正規のキーに正規化されます。

konsulto_replace_section

セクションの文章を置換。古い内容は監査証跡に保存されます。

証拠

ツール

内容

konsulto_attach_evidence

ファイルパス / インラインコンテンツ / base64をアップロード。evidenceIdを返します。

konsulto_add_evidence_to_finding

既存の指摘事項の本文にevidenceIdを組み込みます（auto 配置は poc → description → impact → remediation → end の順で探索）。

スコープと資産

ツール

内容

konsulto_list_scope

監査のスコープ要素 — テストが許可されている対象。

konsulto_list_assets

監査内（またはテナント全体）の資産。

konsulto_create_asset

スキャンで未追跡の資産が見つかった場合に、ホスト / URL / IAMロールなどを作成。

konsulto_link_asset

名前で資産を照合または作成し、指摘事項にリンク付け。

ヘルパーCLI

パッケージには2つのバイナリが含まれています：

  • konsulto-mcp — stdio MCPサーバー。Claude Codeがこれを起動します。直接実行することはありません。

  • konsulto — 対話型ヘルパー：

    • konsulto init — 現在のフォルダーに .konsulto.yml を作成

    • konsulto whoami — トークンの検証、ID + 権限 + アクティブな監査の表示

    • konsulto doctor — 認証ファイルモード、トークンの有効性、ネットワーク到達性、MCP機能の有効化、ロールの mcp:use 権限の健全性チェック

トラブルシューティング

症状

考えられる原因

修正方法

No Konsulto credentials found

KONSULTO_TOKEN 環境変数なし、~/.konsulto/credentials ファイルなし

環境変数を設定するか、ファイルを作成してください（クイックスタートの手順2を参照）。

This token is a tenant integration key, not an MCP token

kon_live_* トークンを使用している

プロフィール → MCPトークンから kon_mcp_* トークンを発行してください。

すべてのツールで401 / "authentication failed"

トークンが失効または期限切れ

新しいトークンを発行し、~/.konsulto/credentials を更新してください。

403 / "tenant has disabled MCP"

テナント管理者がMCPをオフにしている

管理者にアカウント → APIアクセスから再度有効にするよう依頼してください。

403 / "role no longer permits MCP"

ロールから mcp:use が削除された

管理者にロールへの権限付与を依頼してください。

permissions file mode is 644

認証ファイルの権限が緩い

chmod 600 ~/.konsulto/credentials を実行してください。

konsulto doctor は、これらそれぞれに対して1行の修正案を提示します。

セキュリティモデル

  • すべてのAPIリクエストに対する3つのライブゲート: テナント機能フラグが有効であること、ロールに mcp:use があること、トークンが失効・期限切れでないこと。いずれかが変更されると、MCPトラフィックは即座に遮断されます（トークンごとの失効処理は不要）。

  • トークンストレージ: ~/.konsulto/credentials (chmod 600) または KONSULTO_TOKEN 環境変数。~/.claude/mcp.json には決して保存しないでください。

  • 新しいIPからの初回アクセス時のメール通知: 未知のIPからトークンが使用されるとメールが届くため、漏洩を検知できます。メールには失効フローへのリンクが含まれています。

  • デフォルトの有効期限: 90日。最大365日。

  • 権限はライブで読み取り: ロールを変更すると1リクエスト以内に反映されるため、トークンの再発行は不要です。

1台のマシンでの複数エンゲージメント

KONSULTO_PROFILE=acme を設定すると、デフォルトの代わりに ~/.konsulto/credentials.acme を読み取ります。自社のテナントと顧客のテナントを同じノートPCから操作する場合に便利です。

ライセンス

MIT — LICENSE を参照してください。

Install Server
A
license - permissive license
A
quality
B
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Related MCP Servers

View all related MCP servers

Related MCP Connectors

  • mcp-server

    MCP server for Pentest-Tools.com: run scans, manage findings and reports via your preffered LLM.

  • clianythingharness-mcp

    A paid remote MCP for CLI tool MCP, built to return verdicts, receipts, usage logs, and audit-ready

  • mcp

    Augments MCP Server - A comprehensive framework documentation provider for Claude Code

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/konsulto/konsulto-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server