MinaSight｜MinaSight MCP 開発者向けチュートリアル

RONDHUIT社が提供するMinaSight MCPサーバーを利用すると、自作のAIエージェントやClaude DesktopなどのMCPクライアントから、MinaSightが保有する膨大な企業データに直接アクセスできるようになります。
本ガイドでは、接続から実際のツール利用までの手順を解説します。

MinaSight MCPサーバーについて

MinaSight MCPサーバーは、Streamable HTTPを利用したリモート接続用エンドポイントを提供しています。そのため、MCPサーバーを各自の環境にインストールする必要はありません。
Claude Desktopアプリなど、リモートMCPサーバーへ直接接続できないクライアントから利用する場合は、Node.jsのmcp-remoteツールを使ってnpx経由でMinaSight MCPサーバーへ接続します。Streamable HTTPへ直接接続できるMCPクライアントでは、この中継は不要です。Pythonで独自のMCPクライアントを構築する場合は、MCP Python SDKのstreamable_http_clientを利用できます。
MCPサーバーへ接続するために必要なエンドポイント情報や、MinaSight MCP APIキーを取得するために、MinaSightアカウントを作成する必要があります。MinaSight開発者用アカウントの作成や利用は無料です。

接続までの流れ

Claude Desktopアプリを使ってMCPサーバーに接続し、会社探索までのステップは次のとおりです。

実行環境の準備
無料のMinaSight開発者アカウント作成
MCP APIキーの取得
MCPサーバー接続情報の取得
MCPクライアント（Claude Desktopアプリ）の設定
会社探索を実行

このチュートリアルでは、macOSで、HomeBrewがインストールされたターミナルとClaude Desktopアプリを利用環境として説明しています。

手順1. 実行環境の準備

ターミナルより次のコマンドを実行し、Node.jsがインストールされていることを確認します。Node.jsがインストールされていない場合はインストールします。

node -v
npx -v

Claude Desktopアプリをインストールし、Claudeアカウントでログインします。無料プランでも本チュートリアルに沿った検証は可能です。

手順2. 無料のMinaSight開発者アカウント作成

ブラウザからMinaSight公式サイトへアクセスし、画面右上の「無料で始める」ボタンをクリックします。
MinaSightのログイン画面が表示されますので、画面下部の「登録」リンクをクリックします。
登録画面で次の情報を入力します。すべての項目が入力必須です。

ユーザー名：ログイン画面のユーザー名欄に入力する情報を指定します。下記で指定するEメールと同じにすることをおすすめします。
パスワード：ログイン時のパスワードを指定します。
パスワード（確認）：直上のパスワード欄に入力したものと同じものを指定します。
Eメール：Eメールアドレスを指定します。以前にMinaSightへの登録で使用したEメールアドレスは利用できません。
名：名を入力します。例：太郎
姓：姓を入力します。例：東京

登録情報の入力に間違いがないことを確認したら「登録」ボタンをクリックします。次画面で利用規約が表示されますので、内容を確認後、「承認」ボタンをクリックすると、登録時に指定したメールアドレスへ確認用のEメールが送信されます。メール本文中の「メールアドレスの確認」リンクをクリックします。確認に成功すると、案件の一覧画面が表示されます。この時点では案件がゼロなので「まだ案件を作成していません。まずは案件を作成しましょう！」というメッセージが表示されます。

手順3. MCP APIキーの取得

MCPサーバーへ接続するには、MinaSight MCP APIキーが必要です。

こちらからMinaSightの管理画面へログインします。
画面右上の歯車アイコンをクリックし、「ユーザー設定」を選択します。ユーザー設定画面が表示されますので、「新しいキーを作成する」ボタンをクリックしキー名を入力してキーを作成します。
キーの一覧画面に表示されている当該キー行のコピーアイコンをクリックすると、クリップボードへキーがコピーされますので、パソコン上のメモ帳などに貼り付けるなどしてメモしておきます。MCP APIキーは第三者に知られることのないよう大切に保管してください。

手順4. MCPサーバー接続情報の取得

次にMCPサーバーへの接続情報を取得します。

MinaSight管理画面右上の歯車アイコンから「ユーザー設定」を選択します。ユーザー設定画面が表示されますので、MCP接続設定セクションから「MCPサーバーURL」情報を取得します。接続方式がStreamable HTTPと表示されていることを確認してください。

5. MCPクライアント（Claude Desktopアプリ）に設定

Claude DesktopアプリのコンフィグにMCPサーバーへの接続情報を設定します。

Finderを起動し、/Users/【ユーザー名】/Library/Application Support/Claudeフォルダ内のclaude_desktop_config.jsonファイルをVSCODEなどのエディターで開きます。
mcpServersの設定がない場合は、以下をファイル全体として保存します。既存の設定がある場合は、他のルートプロパティを残したままmcpServersを追加し、必要なカンマを入れてください。すでにmcpServersがある場合は、重複して作成せず、その中にminasightの設定だけを追加します。

{
  "mcpServers": {
    "minasight": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "【手順4で取得したMCPサーバーURL】",
        "--transport",
        "http-only",
        "--header",
        "X-API-KEY: ${MINASIGHT_API_KEY}"
      ],
      "env": {
        "MINASIGHT_API_KEY": "【手順3で取得したMCP APIキー】"
      }
    }
  }
}

注意: 現在のMinaSight MCPサーバーはStreamable HTTPを使用します。旧SSEエンドポイント（例：/api/v1/internal/fukurou-mcp/sse）や--transport sse-onlyは使用しないでください。mcp-remoteでは--transport http-onlyを指定します。

Claude Desktopアプリをいったん終了し、再度起動します。
macOSのメニューバーにて「Claude」→「設定」をクリックします。設定画面が表示されますので、左サイドメニューより「開発者」を選択し、画面右側のminasightセクションにrunningと表示されていることを確認します。

6. 会社探索を実行

Claude Desktopアプリのメッセージ入力欄に質問文を入力し、会社探索を実行します。なお、各ツールの初回実行時に「ClaudeがminasightのGet Industry taxonomyを使用します」というような確認ダイアログが画面に表示されることがあります。処理を進めるために「常に許可」をクリックして実行を許可してください。

探索時の質問例

法人営業エージェントの例

製造業向けにAIサービスを販売できそうな会社を探してください。地域は関東を中心にしてください。

人材紹介エージェントの例

海外営業経験があり、英語が使える候補者に合いそうな企業を探してください。中堅企業を優先してください。

M&A探索エージェントの例

地方の介護事業を買収して成長したい会社の候補を探してください。異業種からの参入可能性も考慮してください。

MCPクライアントはこれらの依頼内容を解釈し、適切なツール（例：search_japanese_companies）を自動的に呼び出して結果を回答します。

上記で説明したClaude Desktopを使った「MCPサーバーへの依頼」の例は、エージェントフレームワークやSDKを使ってアプリケーションを作成するのと同じ意味での、独自のAIエージェントの実装とは言えません。
Claude Desktopでは、主に既存のMCPサーバーへの接続情報を設定し、MinaSightツールへのアクセス権限を与えることに重点を置いており、独自のオーケストレーション／制御ループを実装しているわけではないからです。

エラーが発生したり期待の結果が得られない場合、次の項目を確認してください。

インターネットに接続し、MCPサーバーへ接続できる状態ですか？
Node.jsはインストールされていますか？
MCP APIキーは正しいですか？
MCPサーバーのStreamable HTTPエンドポイントURLは正しいですか？
Claude Desktopアプリのステータスはrunningになっていますか？
Claude Desktopアプリ検索オプションで「コネクタ」のminasightはONになっていますか？
Claude Desktopアプリの検索オプションで、「コネクタ」のウェブ検索は未選択になっていますか？

利用可能なツール

MCPサーバーへの接続が成功すると、以下の4つのツールが利用可能になります。（ツールの構成は変更となる場合があります）
MCPサーバーで提供するツールの一覧は、MCPのtools/listリクエストで取得できます。そのツールの1つにget_field_hintsがあり、このツールを呼び出すことで、MinaSightの検索やフィルタリングに使用できるフィールドの情報を取得できます。

ツール名	説明
`search_japanese_companies`	メインの企業検索ツールです。条件に合う企業を探索します。
`get_field_hints`	検索やフィルタリングに使用できるフィールドの情報を取得します。
`get_industry_taxonomy`	業種フィルタリングに使用する正規の階層構造を取得します。
`get_location_taxonomy`	地域フィルタリングに使用する正規の場所情報を取得します。