FlexOrch MCP

flexorch-mcp

FlexOrch 向け MCP サーバー — 機械のための SDK です。

Claude やその他の MCP 対応エージェントを、FlexOrch のドキュメントインテリジェンスパイプラインに接続します。自然言語によるツール呼び出しだけで、ドキュメントの処理、構造化データの抽出、PII の検出、LLM 対応データセットのエクスポートができます。

---

これは何ですか

flexorch-mcp は、FlexOrch API を MCP ツールとして公開する薄いプロキシです。すべての処理は FlexOrch のマネージドインフラストラクチャ上で行われます。FlexOrch のアカウントと API キーが必要です。

コードを書く人向け： flexorch-sdk（Python）または flexorch-sdk-js（TypeScript）を使用してください。
エージェント向け： このパッケージを使用してください。

---

ツール

ツール	説明
document.process	ドキュメント（PDF、DOCX、TXT、XLSX、HTML、XML、EML、JPG、PNG、TIFF）をアップロードして処理します
document.reprocess	アップロード済みのドキュメントをパイプラインで再処理するようキューに登録します
job.status	処理ジョブの完了または失敗まで状態を確認します
job.result	完了したジョブから構造化された抽出フィールドを取得します
dataset.build	完了した実行から構造化データセットを構築します
dataset.search	インデックス化されたデータセットを横断して意味検索します（Pro 以上）
dataset.export	データセットを JSONL、CSV、JSON、XML、MD、または RAG（LangChain／LlamaIndex のチャンク）としてエクスポートします
dataset.index	データセットの意味ベクトルインデックス作成を開始します（Pro 以上）
dataset.chunks	インデックス化されたデータセットから、ページネーションに対応した RAG 対応テキストチャンクを取得します（Pro 以上）

---

インストール

pip install flexorch-mcp

Python 3.10 以上が必要です。

---

設定

Claude Desktop

Claude Desktop の設定ファイルに追加してください（存在しない場合は作成してください）。

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

{
  "mcpServers": {
    "flexorch": {
      "command": "flexorch-mcp",
      "env": {
        "FLEXORCH_API_KEY": "dfx_your_key_here"
      }
    }
  }
}

Cursor

Cursor の MCP 設定に追加してください。

{
  "flexorch": {
    "command": "flexorch-mcp",
    "env": {
      "FLEXORCH_API_KEY": "dfx_your_key_here"
    }
  }
}

OpenAI Codex

~/.codex/config.toml に追加してください。

[mcp_servers.flexorch]
command = "uvx"
args = ["flexorch-mcp"]

[mcp_servers.flexorch.env]
FLEXORCH_API_KEY = "dfx_your_key_here"

API キーは app.flexorch.com/settings から取得してください。

---

接続を確認する

flexorch-mcp --check
# → FlexOrch API key: dfx_xxx*** ✓
# → Connection: OK (api.flexorch.com)
# → Plan: Starter (1,200 credits/mo)
# → Tools: 9 registered

---

エージェントのワークフロー例

User: "Process this invoice and export it as JSONL for fine-tuning."

Agent:
  1. document.process(file_url="https://...")   → job_id: 1234
  2. job.status(1234)                           → completed, execution_id: 567
  3. job.result(567)                            → vendor, total, date, PII masked
  4. dataset.build(execution_id=567)            → job_id: 1235
  5. job.status(1235)                           → completed, dataset_id: 89
  6. dataset.export(89, format="jsonl")         → inline JSONL content

---

プランの上限

すべての FlexOrch プランの上限は、MCP ツールの呼び出しにも適用されます。クレジットはドキュメントを処理するごとに消費されます。

プラン	クレジット／月	意味検索
トライアル	1,200（30 日間）	—
Starter	1,200	—
Pro	6,000	✓
Enterprise	カスタム	✓

---

セキュリティ

• API キーは FLEXORCH_API_KEY 環境変数から読み取られ、ツールの引数として渡されることはありません
• このサーバーはデータを保存またはキャッシュしません。ステートレスなプロキシです
• 結果が返される前に、FlexOrch のパイプラインによって PII マスキングが適用されます
• api.flexorch.com との通信にはすべて HTTPS が使用されます

---

関連プロジェクト

• flexorch-audit — スタンドアロンの PII 検出とドキュメント品質スコアリング（アカウント不要）
• flexorch-sdk — 開発者向け Python SDK
• flexorch-sdk-js — 開発者向け TypeScript SDK
• docs.flexorch.com — ドキュメント一式

---

ライセンス

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