freispace MCP Server

freispace MCP Server

スケジューリングソフトウェア freispace の分析とインサイトを提供する Model Context Protocol (MCP) サーバーです。このサーバーにより、AI アシスタント (Copilot、Gemini など) は、プロジェクト統計や計画関連情報など、freispace 内のデータを照会できるようになります。

概要

freispace MCP Server は、ツール機能を備えたあらゆる LLM を freispace に接続し、分析データを照会できるようにします。

freispace を使用するメディアチームは、MCP サーバーを活用して、全社的な AI (Copilot など) を通じて計画データを全社で利用可能にできます。ユーザーは freispace を利用している必要も、freispace について知っている必要もありません。また、ポストプロダクションチームがスケジュールや計画を立てる際に、データに基づいた意思決定を行うのにも役立ちます。

当社の MCP Server は常にユーザー権限を尊重し、LLM がアクセスできるデータをユーザー単位に制限することで、データの安全性を確保します。

クエリの例としては、「過去に Person X と一緒に働いたのは誰ですか？」や「残りの休暇日数は何日ですか？」などがあります。

前提条件

1. freispace Flagship アカウント
2. freispace の有効な MCP API キー
   • beta 中は、freispace サポートチームに連絡して MCP API キーを取得してください。

利用可能なツール

すべての検索は名前ベースです。部分一致が可能で、最初に一致したものが使用されます。

get_current_user

呼び出し元ユーザーの情報: 名前、メールアドレス、リンクされたスタッフレコード。引数なし。「私/自分/自分の」をスタッフ名に解決するために使用します。

「誰としてログインしていますか？」

get_staffs

スタッフメンバーを名前、役職、スタッフ番号で一覧表示します。

• status (オプション): active (デフォルト), inactive, all

「すべてのスタッフメンバーをリストして」 · 「会社の開発者は誰ですか？」

find_resources

部屋/スタジオ (スイート)、機材/ライセンス (リソース)、スタッフを名前で一度に検索し、タイプ別にグループ化します。

• search (オプション): 名前または部分的な名前。省略するとすべてをリストします。
• staff (オプション): internal または external
• site (オプション): 一致するサイトのスイートのみ
• status (オプション): active (デフォルト), inactive, all

「Sammy を探して」 · 「外部フリーランサーをリストして」

get_availability

指定された日付ウィンドウ (デフォルト 14 日間、最大 92 日間) で、予約、祝日、スタッフの不在/勤務時間を考慮して、スタッフ、スイート、またはリソースが空いている時間を確認します。

• type (必須): staff, resource, suite または site
• search, staff, site, status (オプション): find_resources と同様のエンティティ選択
• from, to, days, weeks (オプション): 日付ウィンドウ
• duration + duration_unit (オプション): 必要な空き時間の長さ (minutes, hours または days)

「来週の火曜日に3時間空いているスタジオはありますか？」 · 「次の2週間で完全に空いている日が2日あるのは誰ですか？」

get_my_schedule

呼び出し元ユーザー自身の予約を日付ウィンドウで表示します (デフォルト: 次の7日間)。

• from, to, days, weeks (オプション): 日付ウィンドウ

「今週の私のスケジュールは？」

get_my_tasks

呼び出し元ユーザーに割り当てられたタスクを、期限、優先度、参照情報とともに表示します。

• include_done (オプション): 完了したタスクも含める

「私の未完了タスクは？」

get_open_tasks

チームのすべての未完了タスクを、担当者とともに表示します。

• reference (オプション): project, booking または user

「まだ未完了のプロジェクトタスクはどれですか？」

get_staff_projects

スタッフメンバーが予約されているプロジェクトを、日付範囲と期間とともに一覧表示します。

• staff_name (必須)

「Karl が予約されているプロジェクトは？」

get_staff_collaborators

共有予約に基づいて、スタッフメンバーが一緒に働いたことのある人を表示します。

• staff_name (必須)

「Alexander が一緒に働いたことのある人は？」

get_staff_next_holiday

スタッフメンバーの次の休暇 (開始日、終了日、期間、コメント) を取得します。

• staff_name (オプション。呼び出し元ユーザーの場合は省略)

「私の次の休暇はいつですか？」 · 「Hendrikje の休暇はいつですか？」

get_staff_holiday_quota

スタッフメンバーの1年間の休暇割り当てを取得します: 合計日数、取得済み日数、残り日数。

• staff_name (オプション。呼び出し元ユーザーの場合は省略)
• year (オプション。デフォルトは現在の年)

「残りの休暇日数は何日ですか？」

get_project_stats

1つのプロジェクトの予約統計: ステータス別の内訳を含む過去と今後の予約、およびプロジェクトの期間 (最初の予約開始日、最後の予約終了日、およびそれらの間の日数)。

• project_name (必須)

「Project Alpha の予約統計を表示して」 · 「Project Alpha の期間はどのくらいですか？」

get_project_team

プロジェクトに携わったスタッフメンバーを、そのプロジェクトでの予約数とともに一覧表示します。

• project_name (必須)

「ウェブサイトのリニューアルに携わったのは誰ですか？」

get_project_tasks

1つのプロジェクトのタスクステータス: プロジェクトとその予約に関するすべてのタスクと、未完了/完了/期限超過のサマリー。

• project_name (必須)

「ドキュメンタリープロジェクトに未完了のタスクはありますか？」

get_invoices

フィルターと通貨別合計で請求書を一覧表示します。ページネーション対応。ステータスバケット: draft, open, overdue, paid, partially-paid, canceled, locked。

• search (オプション): 番号、注文番号、件名、受取人住所に一致
• status, number, date_min/date_max, due_date_min/due_date_max, sum_min/sum_max, outstanding_min/outstanding_max, sort, order, page, per_page (オプション)

「期限超過の請求書はどれですか？」 · 「Acme の未払い請求書」

get_offers

フィルターと通貨別の税抜合計でオファー (見積もり) を一覧表示します。ページネーション対応。ステータスバケット: draft, locked, open, accepted, declined。

• search, status, number, date_min/date_max, sum_min/sum_max, sort, order, page, per_page (オプション)

「今年の辞退されたオファーを表示して」

get_orders

接続されたオファーと請求書をインラインで含む注文 (ジョブ) を一覧表示します。ページネーション対応。

• search (オプション): 注文番号と名前に一致
• status, number, date_min/date_max, sort, order, page, per_page (オプション)

「注文 2026-014 で見積もられ、請求されたものは何ですか？」

search_docs

freispace ドキュメントを検索し、最も関連性の高い抜粋を返します。

• query (必須)
• limit (オプション): 最大抜粋数、デフォルト 5

「freispace でシフト計画を設定するにはどうすればよいですか？」

エラー処理

エラーは、短く実用的なメッセージ (例: Not found (404): Staff member with name 'X' not found. Call get_staffs to list valid staff names.) として呼び出し元のモデルに返されます。診断情報は stderr に記録され、stdout は MCP プロトコルのみを伝送します。

⚠️ ベータ版に関する注意事項

当社の freispace MCP サーバーは現在ベータ版です。この期間中、すべての機能は無料でご利用いただけます。プラットフォームの改善を続ける中で、皆様からのフィードバックとご辛抱に感謝いたします。

ライセンス

MIT License - 詳細は LICENSE ファイルを参照してください。

サポート

サポートとお問い合わせ:

• ドキュメント: freispace ドキュメント
• 問題: GitHub Issues
• お問い合わせ: freispace サポート