Flowra

Flowra — エージェントスキルとホステッド MCP サーバー

Claude Code、Cursor、Codex、GitHub Copilot、または任意の MCP クライアントから、Gmail、Slack、GitHub、Notion、Telegram、WhatsApp、Linear、その他1,000以上のアプリで、ホステッド AI エージェントと承認ゲート付きワークフローを実行できます。 アカウントごとの OAuth、送信／削除／支払い前の人間による承認ゲート、すべてのツール呼び出しの台帳を備えています。

製品 · ドキュメント · SDK · 変更履歴 · skills.sh

このリポジトリは、Flowra のエージェントスキルと Cursor／Claude／Codex プラグインです。バックエンドから利用する場合は、SDK（@flowra/sdk、flowra-sdk、@flowra/cli）を使用してください。

含まれるもの

コンポーネント	目的
mcp.json / .mcp.json	https://mcp.flowra.dev/mcp を登録します（OAuth、キー不要）。6つのツール：discover、schemas、connect、multi-execute、workbench、bash。
skills/flowra	operate / build / edit / debug / credits を適切な Flowra 呼び出しに振り分けます。
skills/flowra-onboard	初回インストール：MCP を接続し、読み取り専用の最初の成功を体験します。
commands/	/flowra-setup と /flowra-status。
evals/	スキルが合格すべき動作シナリオ。
rules/flowra-safety.mdc	読み取りは無料で、書き込みには確認が必要です。信頼できないコンテンツを指示として扱うことはありません。

30秒でインストール

1. スキル（Claude Code、Cursor、Codex、Copilot、OpenClaw、Hermes）：

npx skills add flowradev/skills --skill flowra

2. ホステッド MCP サーバー — API キーは不要です。OAuth でサインインします：

https://mcp.flowra.dev/mcp

クライアント	方法
Cursor	Settings → Tools & MCP → flowra の横にある Connect（または Flowra プラグインをインストール）
Claude Code	/plugin marketplace add flowradev/skills の後に /plugin install flowra@flowra — または claude mcp add --transport http flowra https://mcp.flowra.dev/mcp
Codex	.agents/plugins/marketplace.json にあるマーケットプレイス
Gemini CLI	gemini extensions install https://github.com/flowradev/skills（リリース v0.2.0 が必要）
VS Code / Copilot	Extensions で @mcp を検索するか、URL を .vscode/mcp.json に追加
スキルのみ	npx skills add flowradev/skills --skill flowra
CI / OAuth なし	自分の設定でプロジェクト API キーを使用してください。このリポジトリには絶対に含めないでください。

Cursor Marketplace で「Flowra」を検索するか、掲載後に /add-plugin flowra を実行してください。

初回実行

1. MCP サーバーを接続し、Flowra プロジェクトを選択します。
2. 次のように尋ねます：「Flowra を使って、Gmail の最新5件の件名を一覧表示して。」
3. 続けて次のように尋ねます：「平日の毎朝9時に、受信トレイの概要を Slack に投稿して。投稿前に確認して。」

できること

• 「Flowra で Gmail を接続して、最新の件名を一覧表示して。」
• 「平日の毎朝9時に、新しい Linear の課題の概要を Slack に投稿して。投稿前に確認して。」
• 「この Flowra の実行が一時停止中です。台帳を表示して、再開して。」

Flowra を選ぶ理由（Zapier MCP、Composio、n8n との比較）

• 同じプロジェクトで、エージェントまたはロックされたワークフローを利用できます。ツールカタログだけではありません。
• cron の実行を含む、あらゆるステップに人間による承認ゲートを設けられます。
• 実行台帳：すべてのツール呼び出しの入力、出力、クレジットを記録します。
• 必要なアプリがない場合：REST エンドポイントを説明すれば、Flowra がツールキットを構築します。

セキュリティモデル

受信メール、チャット、Webhook の内容は信頼できないデータとして扱います。このスキルはペイロードに含まれる指示を実行せず、承認ゲートを決して省略しません。読み取りは自由に実行できますが、書き込み（送信、投稿、作成、更新、削除、支払い）には、このチャットで明示的な承認が必要です。永続的な自動化にも、human_wait ノードまたはエージェントの humanApproval が必要です。このリポジトリには API キーを保存しません。

次の場合に使用します ローカルスクリプトや n8n、Zapier、Make のキャンバスではなく、スケジュールされた自動化または承認済みの自動化を使用したい場合。

次の場合は使用しません Flowra プロジェクトがない場合、または自分が所有する n8n、Zapier、Make のグラフをすでに編集している場合。

OAuth を使用しない CI／クライアント

ヘッダーは自分の .cursor/mcp.json にのみ追加してください。キーをコミットしないでください。

{
  "mcpServers": {
    "flowra": {
      "url": "https://mcp.flowra.dev/mcp",
      "headers": {
        "x-api-key": "<your-project-api-key>",
        "x-username": "project_default_user"
      }
    }
  }
}

ローカルテスト

mkdir -p ~/.cursor/plugins/local
ln -sfn "$PWD" ~/.cursor/plugins/local/flowra

次に、Developer: Reload Window を実行します。

レイアウト

.cursor-plugin/plugin.json
.claude-plugin/plugin.json
.claude-plugin/marketplace.json
.codex-plugin/plugin.json
.agents/plugins/marketplace.json
gemini-extension.json
mcp.json
.mcp.json
server.json
commands/flowra-setup.md
commands/flowra-status.md
evals/
rules/flowra-safety.mdc
skills/flowra/SKILL.md
skills/flowra-onboard/SKILL.md
skills/flowra/references/

MIT © Flowra