Figranium MCP

MCP で Figranium を使用する

Figranium は、Web サイトのワークフローを再利用可能なタスクに変換します。AI エージェントは MCP を通じてタスクを見つけ、作成し、実行できます。このサーバーは、MCP 対応アプリを Figranium インスタンスに接続するためのローカル STDIO クライアントです。

ホスト型の OAuth MCP をお探しですか？互換性のあるリモート MCP クライアントを https://mcp.figranium.dev/mcp に接続してください。

クイックスタート

起動中の Figranium インスタンスと、Figranium の設定画面で取得した API キーが必要です。

npm から MCP サーバーを直接実行します。

FIGRANIUM_API_KEY=YOUR_API_KEY npx -y figranium-mcp

デフォルトでは、Figranium の http://localhost:11345 に接続します。別のインスタンスを使用する場合：

FIGRANIUM_BASE_URL=https://your-figranium-instance.example.com \
FIGRANIUM_API_KEY=YOUR_API_KEY \
npx -y figranium-mcp

MCP クライアントの設定

ほとんどのローカル MCP クライアントでは、次のような形式の設定を使用できます。

{
  "mcpServers": {
    "figranium": {
      "command": "npx",
      "args": ["-y", "figranium-mcp"],
      "env": {
        "FIGRANIUM_BASE_URL": "http://localhost:11345",
        "FIGRANIUM_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

このサーバーエントリを、Codex、Claude Code、Cursor、GitHub Copilot、Claude Desktop、Cline などの STDIO MCP クライアントで使用してください。

MCP サーバー自体を Docker 内で実行し、Figranium をホスト上で実行する場合は、http://localhost:11345 の代わりに http://host.docker.internal:11345 を使用してください。

エージェントにできること

接続すると、エージェントは API を手動で呼び出すことなく Figranium を操作できます。MCP サーバーは、タスクの主要なライフサイクルに対応するツールを公開します。

ツール	用途
task_list	既存のタスクを確認する
create_task	新しいタスクを作成する
task_execute	オプションの変数上書きを指定してタスクを実行する
execution_list	過去の実行を確認する
schedule_list	スケジュール済みのタスクを探す
schedule_get_all_status	スケジューラーの状態を確認する
schedule_get_status	1 つのタスクのスケジュールを確認する
schedule_set	スケジュールを作成または更新する
schedule_delete	スケジュールを削除する
schedule_describe	スケジュールを検証してプレビューする

また、サーバーは figranium://schemas/task-v1.json を公開しており、クライアントは Figranium のタスクスキーマを直接確認できます。

Figranium の MCP 指示は、エージェントにタスクの構築方法、セレクターの選択方法、変数の使用方法、タスクの順序規則の遵守方法を教えます。無効なタスクのペイロードには、エージェントがリクエストを修正できるように、構造化された検証診断が返されます。

ローカル MCP とホスト型 MCP

npm パッケージには、ローカル STDIO MCP サーバーが含まれています。Figranium MCP のランディングページやホスト型 OAuth UI は含まれていません。

リモート OAuth MCP に対応したクライアントでは、次を使用してください。

https://mcp.figranium.dev/mcp

ホスト型 MCP は OAuth を処理し、クライアントを外部からアクセス可能な Figranium インスタンスに接続します。ローカルクライアントには、通常 npx -y figranium-mcp のほうが簡単で、localhost に直接接続できます。

環境変数

変数	必須	デフォルト	説明
FIGRANIUM_API_KEY	はい	—	Figranium インスタンスで生成された API キー
FIGRANIUM_BASE_URL	いいえ	http://localhost:11345	Figranium インスタンスのベース URL

FIGRANIUM_API_KEY が設定されていない場合、サーバーはセットアップに関するメッセージを表示して終了します。

ソースからビルドする

Node.js 18+ と npm 9+ が必要です。

git clone https://github.com/figranium/figranium-mcp.git
cd figranium-mcp
npm install
npm run build

コンパイル済みサーバーを実行します。

FIGRANIUM_API_KEY=YOUR_API_KEY npm start

開発中に実行する場合：

npm run watch

テストスイートを実行します。

npm test

MCP Inspector

公式の MCP Inspector で公開済みのサーバーを確認できます。

FIGRANIUM_API_KEY=YOUR_API_KEY npx @modelcontextprotocol/inspector npx -y figranium-mcp

Links

• Figranium documentation
• Figranium
• npm package
• MCP server source
• Figranium source