IFC MCP

ChatGPT デスクトップアプリは、STDIO 経由のローカル MCP サーバーに対応しています。

1. ChatGPT デスクトップアプリを開きます。
2. Settings を開きます。
3. Plugins、続いて MCPs を選択します。
4. Add をクリックします。サーバーの種類を求められた場合は、STDIO を選択します。
5. 次のように入力します。
   • Name：ifc-mcp
   • Command to launch：npx
   • First argument：-y
   • Second argument：ifc-mcp
6. 環境変数の欄は空欄のままにして、サーバーを保存します。
7. ChatGPT デスクトップアプリを再起動します。
8. 新しいチャットを開始し、/mcp と入力して、ifc-mcp が接続されていることを確認します。

詳しくは、OpenAI の MCP ドキュメントをご覧ください。

オプション 1：Claude Desktop の UI を使用する

1. Claude Desktop を開きます。
2. Settings を開きます。
3. Developer または Desktop app の開発者設定を開きます。
4. Edit Config ボタンがある場合はクリックします。Claude Desktop の MCP 設定ファイルが開きます。
5. 以下の JSON を貼り付けてファイルを保存し、Claude Desktop を完全に終了してから再起動します。

{
  "mcpServers": {
    "ifc-mcp": {
      "command": "npx",
      "args": ["-y", "ifc-mcp"]
    }
  }
}

ファイルにすでに JSON が含まれている場合は、既存の mcpServers オブジェクト内に ifc-mcp エントリだけを追加してください。mcpServers オブジェクトを 2 つ作成しないでください。

オプション 2：設定ファイルを直接開く

Claude Desktop に Edit Config が表示されない場合にのみ、この方法を使用してください。

• Windows：%APPDATA%\Claude\claude_desktop_config.json
• macOS：~/Library/Application Support/Claude/claude_desktop_config.json

オプション 1 と同じ JSON を貼り付けてファイルを保存し、Claude Desktop を完全に終了してから再起動します。

確認

設定を確認するには、Claude Desktop を開いて新しいチャットを開始し、チャットボックスの近くにある + ボタンをクリックして、Connectors を探します。Claude Desktop の再起動後、IFC MCP がそこに表示されます。上記の仕組みのセクションに記載されているツールが一覧表示されていることを確認してください。

オプション 1：インストールボタンを使用する

VS Code が開き、IFC MCP が追加されます。

VS Code からサーバーを信頼するか尋ねられた場合は、許可してください。 ツールが表示されない場合は、VS Code を再読み込みしてください。チャットを開き、ツール／ツールの構成ボタンを使って IFC MCP ツールを確認してください。

オプション 2：.vscode/mcp.json を手動で追加する

{
  "servers": {
    "IFC MCP": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "ifc-mcp"]
    }
  }
}

ファイルを保存した後、VS Code を再読み込みしてください。

チャットを開き、ツール／ツールの構成ボタンを使って IFC MCP ツールを確認してください。

詳細については、VS Code MCP サーバーのドキュメントをご覧ください。

オプション 1：Codex の設定 UI を使用する

1. VS Code を開きます。
2. Codex パネルを開きます。
3. Codex の設定を開きます。
4. MCP servers を選択します。
5. Add server をクリックします。
6. 次の情報を入力します。
   • 名前：ifc-mcp
   • コマンド：npx
   • 引数：-y ifc-mcp
7. サーバーを保存します。
8. VS Code を再読み込みするか、新しい Codex セッションを開始します。
9. 新しい Codex セッションで IFC MCP ツールを利用できることを確認します。

オプション 2：ターミナルコマンドを使用する

1. VS Code で Terminal -> New Terminal を開きます。
2. 次のコマンドを貼り付けて実行します。

codex mcp add ifc-mcp -- npx -y ifc-mcp

3. VS Code を再読み込みするか、新しい Codex セッションを開始します。
4. 新しい Codex セッションで IFC MCP ツールを利用できることを確認します。

詳細については、Codex MCP のドキュメントをご覧ください。

オプション 1：プロジェクトの JSON ファイルを使用する

1. VS Code でプロジェクトを開きます。
2. プロジェクトのルートにある .mcp.json を作成または編集します。
3. 次の JSON を追加してファイルを保存します。

{
  "mcpServers": {
    "ifc-mcp": {
      "command": "npx",
      "args": ["-y", "ifc-mcp"]
    }
  }
}

4. VS Code で Claude Code を再度開きます。
5. /mcp と入力し、Claude から求められた場合はプロジェクトサーバーを承認します。
6. ifc-mcp が接続されていることを確認します。

オプション 2：すべてのプロジェクトにターミナルコマンドを使用する

claude mcp add --transport stdio ifc-mcp --scope user -- npx -y ifc-mcp

その後、VS Code で Claude Code を再度開き、/mcp と入力して、ifc-mcp が 接続されていることを確認します。

claude コマンドが見つからない場合は、先に Claude Code をインストールしてください。

詳細については、Claude Code VS Code のドキュメントとClaude Code MCP のドキュメントをご覧ください。

次のサーバーエントリを MCP クライアントの設定に追加します。

{
  "mcpServers": {
    "ifc-mcp": {
      "command": "npx",
      "args": ["-y", "ifc-mcp"]
    }
  }
}

設定を保存した後、MCP クライアントを再起動してください。

詳細については、Model Context Protocol のドキュメントをご覧ください。

ローカルのファイルパスを受け取るハンドラーを用意します。以下の関数をアプリのビューアアクションに置き換えてください。

import { createServer } from "ifc-mcp";
import { serveStdio } from "@modelcontextprotocol/server/stdio";

serveStdio(() => createServer({
  viewer: {
    "open-ifc-viewer": () => openThisViewer(),
    "show-ifc-file": ({ file_path }) => loadIfcIntoThisViewer(file_path),
    "set-bcf-view": ({ bcf_path }) => applyBcfToThisViewer(bcf_path),
    "clear-ifc-viewer": () => clearThisViewer(),
  },
}));

ハンドラーから MCP ツールの結果を返します。content にはフィードバックを格納し、失敗を示すには isError: true を指定します。

アプリで選択したファイルと、既存のビューア用コールバックを渡します。ここでは、file は選択した IFC File で、viewer はビューアのインスタンスです。

import { createIfcMcpHost } from "ifc-mcp/browser";

const files = new Map([
  [file.name, { name: file.name, source: file }],
]);

const host = createIfcMcpHost({
  files,
  viewer: {
    "show-ifc-file": (name, bytes) => viewer.add(name, bytes),
    "set-bcf-view": (name, bytes) => viewer.add(name, bytes),
    "clear-ifc-viewer": () => viewer.clear(),
  },
});

const result = await host.handleToolCall({
  name: "show-ifc-file",
  input: { file_path: file.name },
});

ファイルのコールバックには、ファイル名と Uint8Array のバイト列が渡されます。BCF コールバックは、視点が適用されたかどうかを説明する MCP ツールの結果を返す必要があります。ツール定義には host.tools を、生成されたダウンロードファイルには host.getGeneratedFiles() を使用します。ダウンロードが不要になったら、host.clearFiles() を呼び出してください。