AIクライアント（Claude、ChatGPT、Gemini）でAxur MCPを設定する方法 | Axur

概要

Axur MCP（Model Context Protocol） は、AIモデルがAPIを介してAxurプラットフォームの情報に安全にアクセスできるようにするネイティブ統合機能です。

前提条件

設定を開始する前に、以下を準備してください。

Axurプラットフォームへのアクセス権を持っていること。
以下のページでAPI Keyを生成すること。
1. https://one.axur.com/preferences?tab=api-keys
MCPに対応したクライアントを使用すること。

現在、以下のクライアントで動作が確認されています。

Claude Code
ChatGPT Codex
Gemini Antigravity/CLI

公式ドキュメント

Axur MCPの公式ドキュメントは以下から確認できます。

https://mcp.axur.ai/

セキュリティに関するベストプラクティス

API KeyをAIのプロンプトに直接入力しないでください。

推奨される方法は、使用するクライアントに応じて、アシスタントに設定ファイル（mcp_config.json または .mcp.json）を作成してもらい、ファイルが作成された後に、対応するフィールドへAPI Keyを手動で入力することです。

この方法により、モデルとの会話中に認証情報が共有されることを防ぎ、セキュリティのベストプラクティスに従って認証情報を安全に管理できます。

MCP設定用プロンプト

以下のプロンプトは、対応クライアント（Claude Code、ChatGPT Codex、Gemini Antigravity/CLI）で動作確認済みです。

# MCP Configuration Task  

Create or update the client's MCP configuration file (`mcp_config.json`) with all four Axur MCP endpoints using Streamable HTTP (SSE):  

1. Threat Hunting: https://mcp.axur.ai/mcp/th/ 
2. Cyber Threat Intelligence (CTI): https://mcp.axur.ai/mcp/cti/ 
3. Risk Tickets: https://mcp.axur.ai/mcp/tickets/  

# Server Headers Required  

For every server entry, include the following headers:  

- Authorization: Bearer <YOUR_AXUR_API_KEY> 
- Content-Type: application/json 
- Accept: application/json, text/event-stream  

# Verification  

Verify that the initialize handshake connects successfully to https://mcp.axur.ai/mcp/th/ and return a list of available tools.

このプロンプトを実行すると、モデルによってMCP設定ファイルが作成されます。その後、<YOUR_AXUR_API_KEY> のプレースホルダーを、Axurプラットフォームで生成したAPI Keyに置き換えてください。

統合のテスト

設定が完了したら、MCPサーバーとの通信が正常に動作していることを確認するため、簡単な検索を実行することを推奨します。

以下のプロンプトでは、例として指定したブランドを使用してThreat Hunting検索を実行します。

# Objective  

Perform a Threat Hunting audit to detect high-impersonation threats targeting the brand: "[INSERT YOUR BRAND NAME]".  

# Execution Instructions  

1. Build Query: Use build_url_domain_query_tool with parameter impersonated_brands_high: "[INSERT YOUR BRAND NAME]". 
2. Run Threat Search: Call search_urls_domains using the generated query impersonatedBrandsHigh="[INSERT YOUR BRAND NAME]" for top 10 results. 
3. Inspect Credential Risks: Extract references, hostnames, WHOIS registrants, credential harvesting indicators, and ISP geolocations.  

# Report Format  

Return a structured executive threat report with a summary table containing:  

- Reference URL 
- Impersonated Level (High) 
- Credential Harvesting Risk (Yes / No / Possibly) 
- Domain Host & Registrar 
- Geolocation / ISP

クエリを実行する前に、[INSERT YOUR BRAND NAME] を対象のブランド名に置き換えてください。

期待される結果

設定が正しく完了している場合、アシスタントは以下を実行できるはずです。

Axur MCPサーバーへの接続に成功する。
initialize handshakeを完了する。
利用可能なツールを一覧表示する。
設定されたAPI Keyを使用してAxurプラットフォーム上でクエリを実行する。
プロンプトで指定された形式に従って、構造化された結果を返す。

まとめ

AxurプラットフォームでAPI Keyを生成します。
対応クライアント（Claude Code、ChatGPT Codex、Gemini Antigravity/CLI）を使用します。
MCP設定用プロンプトを実行します。
生成された設定ファイルにAPI Keyを手動で入力します。
検証用プロンプトを実行し、統合が正常に動作していることを確認します。