FlowyTeam OKR MCP Server

OKR MCP サーバー — FlowyTeam

Claude、ChatGPT、または任意の MCP クライアントを、OKR、KPI、タスクに接続できます。

FlowyTeam はネイティブの Model Context Protocol サーバーです。接続すると、AI エージェントはワークスペース内のすべての目標と主要な成果を読み取り、チェックインを投稿し、主要な成果の進捗を更新し、KPI を追跡してレポートを作成できます。ダッシュボードを開かずに、自然な言葉で操作できます。

単機能の OKR MCP サーバーとは異なり、同じ接続でタスク、プロジェクト、従業員、出勤状況、休暇、チケット、クライアント、見込み顧客、請求書も利用できます。33 個のツールを、1 つの接続で。

• 📘 セットアップガイド：https://flowyteam.com/get/mcp-server
• 📗 API リファレンス全文：https://flowyteam.com/get/mcp-docs
• 🔌 OAuth コネクターのドキュメント：https://flowyteam.com/mcp-docs

このリポジトリについて。 FlowyTeam の MCP サーバーはホスト型で、FlowyTeam プラットフォームの一部として実行されます。そのため、インストールもセルフホストも不要です。このリポジトリには、接続設定、ツールのリファレンス、実用例が含まれています。npm install のような方法でローカルにサーバーをインストールすることをお探しの場合、このサーバーはそのようには動作しません。クライアントに URL を設定し、認証するだけです。

---

クイックスタート

ご利用のクライアントに合った方法を選択してください。

Claude Desktop、Claude web、Claude mobile、または ChatGPT — OAuth

API トークンをコピーする必要はありません。アプリごとに一度認証してください。

https://flowyteam.com/api/mcp/cloud/rpc

Claude： Settings → Connectors → Add custom connector → URL を貼り付け → Log in → Authorize。確認画面には、コネクターがアクセスできる内容が正確に表示されます。承認するまで、情報が共有されることはありません。

ChatGPT： Settings → Connectors → 同じ URL を追加して認証します。

PKCE を使用した OAuth 2.0 を利用します。ツールには、既存の FlowyTeam のロールと権限が適用されます。

Claude Code（CLI）— Bearer トークン

Claude Code では、OAuth ではなく、別のエンドポイントとトークンを使用します。

claude mcp add --transport http flowyteam \
  https://flowyteam.com/api/v2/mcp/rpc \
  -H "Authorization: Bearer YOUR_API_TOKEN"

YOUR_API_TOKEN は FlowyTeam → Settings → MCP & AI Integration から取得します。

または、mcp.json.example をプロジェクト内の .mcp.json にコピーすると、チーム全体で設定を利用できます。

{
  "mcpServers": {
    "flowyteam": {
      "transport": "http",
      "url": "https://flowyteam.com/api/v2/mcp/rpc",
      "headers": { "Authorization": "Bearer YOUR_API_TOKEN" }
    }
  }
}

⚠️ CLI エンドポイント（/api/v2/mcp/rpc）は、OAuth コネクターエンドポイント（/api/mcp/cloud/rpc）と互換性がありません。Claude Desktop と ChatGPT はトークンエンドポイントを使用できません。また、Claude Code は OAuth エンドポイントを使用できません。ご利用のクライアントに対応する方をお使いください。

まだアカウントをお持ちでない場合

公開ゲートウェイでは、トークン不要で 3 つのオンボーディングツールを利用できるため、エージェントとの会話を通じてアカウントを作成し、有効化できます。

claude mcp add --transport http flowyteam https://flowyteam.com/api/mcp/gateway

その後、エージェントに 「FlowyTeam のアカウントを登録して」 と依頼してください。エージェントが auth_register を呼び出し、認証メールに記載された 6 桁のコードを伝えると、auth_verify_email を呼び出して api_token が返されます。そのトークンを使って再設定すれば、すべてのツールを利用できるようになります。

FlowyTeam には最大 10 ユーザーまでの無料プランがあります。有料プランはユーザー 1 人あたり月額 3.33 USD からです。API の追加オプションなしで、すべてのプランに MCP アクセスが含まれています。

---

プロンプトの例

OKR と KPI のツールは、次のようなリクエストに対応するために作られています。

Show me all Q3 objectives below 50% progress.
Check in on my key results and update this week's numbers.
Create an objective for the sales team with three key results.
Which KPIs are off target this month, and who owns them?
Summarise our OKR progress for the leadership review.
Align my objectives to the company goal for this cycle.
What's the current value of every indicator in the Revenue category?
Close out the Q3 performance cycle and open Q4.

同じ接続でワークスペース内の他の機能にもアクセスできるため、1 つのリクエストで複数の領域をまたいで操作することもできます。

Which team members own a key result that's off track and also have overdue tasks?
Draft a status update covering our OKR progress and open support tickets.
Log 2 hours against the Onboarding project and update the related key result.

---

ツール

OKR と KPI

ツール	メソッド	機能
objectives	GET POST PUT DELETE	OKR の目標の一覧表示、作成、更新、削除。サイクル、種類（会社／チーム／個人）、ステータスで絞り込めます。
key-result	GET POST PUT DELETE	OKR の主要な成果の一覧表示、作成、更新、削除、進捗の更新。目標に紐付けます。
indicators	GET POST PUT DELETE	KPI 指標の一覧表示、作成、更新、削除。カテゴリや従業員で絞り込めます。
indicator-category	GET POST PUT DELETE	KPI 指標のカテゴリ／種類。
indicator-record	GET POST DELETE	期間ごとの KPI 実績値。indicator_id と period_key で検索します。
performance-cycle	GET POST PUT DELETE	OKR のパフォーマンスサイクルの一覧表示、作成、更新、削除。

タスクとプロジェクト

ツール	メソッド	内容
tasks	GET POST PUT DELETE	タスクの一覧表示、作成、更新、削除、完了のマークを行います。ステータス、優先度、プロジェクト、担当者、期限で絞り込めます。
projects	GET POST PUT DELETE	プロジェクトに加え、マイルストーン、メンバー、カテゴリー、ファイルを扱います。すべて名前で検索します。
task-category	GET POST PUT DELETE	タスクカテゴリーを扱います。
timelogs	GET POST PUT DELETE	作業時間の記録を扱います。タイマーの開始、停止・編集、削除ができます。プロジェクト、従業員、日付で絞り込めます。

人事

ツール	メソッド	内容
employees	GET POST PUT DELETE	従業員の一覧表示、詳細プロフィールの表示、作成、更新、無効化を行います。名前またはメールアドレスで検索します。
department	GET POST PUT DELETE	部門・チームを扱います。メンバーの追加・削除もできます。
designation	GET POST PUT DELETE	メンバー数を含む役職・職位を扱います。
attendance	GET POST PUT	出勤、退勤、記録の一覧表示を行います。従業員、日付、月、年で絞り込めます。
leave	GET POST PUT DELETE	休暇申請の一覧表示、作成、承認、却下、キャンセルを行います。
leave-type	GET POST PUT DELETE	休暇の種類（年次休暇、病気休暇など）を扱います。書き込みは管理者のみ可能です。
holiday	GET POST PUT DELETE	会社の休日を扱います。年、今後・過去の休日で絞り込めます。
events	GET POST PUT DELETE	会社のイベント・カレンダーを扱います。
notices	GET POST PUT DELETE	掲示板を扱います。日付範囲または対象者で絞り込めます。

サポート

ツール	メソッド	内容
tickets	GET POST PUT DELETE	チケットと返信、統計情報を扱い、チケットのクローズ・再開もできます。名前で検索します。
ticket-type	GET POST PUT DELETE	チケットの種類・分類を扱います。
ticket-channel	GET POST PUT DELETE	チケットのチャネル（メール、電話、チャットなど）を扱います。
ticket-agent	GET	チケット担当者とそのグループを一覧表示します。

CRM と財務

ツール	メソッド	内容
clients	GET POST PUT DELETE	クライアントの一覧表示、作成、更新、削除を行います。
leads	GET POST PUT DELETE	営業リードを扱います。ステータス、担当者、日付範囲で絞り込めます。
contracts	GET POST PUT DELETE	クライアントとの契約を扱います。
invoices	GET POST PUT DELETE	クライアント向け請求書の一覧表示、作成、ステータスの更新、削除を行います。
estimates	GET POST PUT DELETE	クライアント向けの見積もり・価格提示を扱います。
expenses	GET POST PUT DELETE	経費と精算申請を扱います。承認・却下もできます。
expense-category	GET POST PUT DELETE	経費カテゴリーを扱います。書き込みは管理者のみ可能です。

アカウント（公開ゲートウェイ — トークン不要）

ツール	メソッド	内容
auth_register	POST	FlowyTeam の新しい会社アカウントを作成します。6 桁の確認コードが送信されます。
auth_verify_email	POST	確認コードでアカウントを有効化し、api_token を返します。
auth_login	POST	既存アカウントの api_token を取得します。

各アクションの全パラメーター、リクエスト例、エラーコード： https://flowyteam.com/get/mcp-docs

---

エンドポイント

エンドポイント	認証	用途
https://flowyteam.com/api/mcp/cloud/rpc	OAuth 2.0 + PKCE	Claude Desktop ／ Web ／ モバイル、ChatGPT
https://flowyteam.com/api/v2/mcp/rpc	Authorization: Bearer <api_token>	Claude Code（CLI）、n8n、その他の HTTP MCP クライアント
https://flowyteam.com/api/mcp/gateway	なし	auth_register、auth_verify_email、auth_login 専用

権限

ツールはあなたとして実行されます。すべての呼び出しは、あなたのワークスペースおよび既存の FlowyTeam ロールの範囲内で行われます。エージェントが読み取りや変更できるのは、UI 上であなた自身が読み取り・変更できる内容に限られます。管理者にはすべてのアクセス権が付与され、メンバーは自分の記録と、ロールで許可された内容にアクセスできます。

エラーコード

コード	意味
200	成功
401	未認証 — Bearer トークンがないか、無効です
403	アクセス禁止 — 認証済みですが、権限がありません
404	リソースが見つかりません
422	検証に失敗しました
429	レート制限に達しました

トラブルシューティング

Claude Code に FlowyTeam のツールが表示されません。 サーバーを追加した後、新しいセッションを開始してください。ツールはセッション開始時に検出されます。claude mcp list を確認してください。

401 Unauthenticated。 トークンがないか、有効期限が切れているか、Bearer プレフィックスが重複した状態で貼り付けられています。Settings → MCP & AI Integration からトークンをコピーし直してください。

Claude Desktop が CLI エンドポイントに接続できません。 これは想定どおりです。代わりに OAuth コネクター URL（/api/mcp/cloud/rpc）を使用してください。クイックスタートの警告をご覧ください。

本来使えるはずのツールで 403 Forbidden が発生します。 FlowyTeam でのロールにその権限がないか、ご利用のプランでモジュールが無効になっています。ワークスペースの管理者に確認してください。

リンク

• セットアップガイド — https://flowyteam.com/get/mcp-server
• API リファレンス — https://flowyteam.com/get/mcp-docs
• OAuth コネクター — https://flowyteam.com/mcp-docs
• ヘルプセンター — https://resource.flowyteam.com/help-center/
• FlowyTeam — https://flowyteam.com

ライセンス

このリポジトリのドキュメントとサンプルは、MIT License のもとで公開されています。 FlowyTeam プラットフォーム自体は商用ソフトウェアです。