FlowCastle

AI ボット開発向け Telegram ボットテンプレートと MCP サーバー

すぐに使える Telegram ボットテンプレートとMCP サーバー — Claude Code、Codex、Cursor、または MCP 対応の AI エージェントから Telegram ボットを構築、編集、デプロイできます。SDK の定型コードは不要です。ボットの内容を説明すると、エージェントがフローを組み立てます。

FlowCastle は、Telegram ボットとウェブチャット向けのビジュアルワークフロービルダーです。フロー、トリガー、条件、AI ステップ、決済（Stripe / YooKassa / Telegram Stars）、一斉配信、ステップ配信、連携機能（Gmail、Google Sheets、Notion、OpenAI など）を利用できます。REST API と MCP サーバーも備えているため、AI コーディングエージェントから直接ボットを開発できます。エージェントが MCP 経由で作成するブロックは、ドラッグして接続し、ビジュアル編集できるブロックと同じものです。

このリポジトリは開発者向けです。以下が含まれています。

パス	内容
templates/	JSON 形式の本番向けボットテンプレート 23 種類 — テンプレートギャラリーと MCP の get_flow_example ツールで使用されるものと同じソースです
mcp/	MCP サーバーのリファレンス：エンドポイント、認証、全 16 ツール、および apply_actions で使われるフローアクションスキーマのスナップショット

AI エージェントからボットを構築する（MCP）

FlowCastle は Streamable HTTP 経由で MCP サーバーを公開しています。

POST https://api.flowcastle.ai/api/mcp
Authorization: Bearer <your-application-api-key>   # starts with app_

キーを取得するには、サインアップ → アプリケーションを作成 → API ページ → MCP タブに進みます。

Claude Code

export FLOWCASTLE_MCP_TOKEN='<your-application-api-key>'

claude mcp add --transport http flowcastle https://api.flowcastle.ai/api/mcp \
  --header "Authorization: Bearer $FLOWCASTLE_MCP_TOKEN"

Codex

codex mcp add flowcastle \
  --url https://api.flowcastle.ai/api/mcp \
  --bearer-token-env-var FLOWCASTLE_MCP_TOKEN

Cursor / 任意の MCP クライアント（JSON 設定）

{
  "mcpServers": {
    "flowcastle": {
      "type": "http",
      "url": "https://api.flowcastle.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer <your-application-api-key>"
      }
    }
  }
}

あとは、次のようにエージェントに依頼するだけです。

「FlowCastle のワークスペースを確認して、リードの見込み度を判定するフローを追加してください。/start で挨拶し、ボタンで 3 つの質問をして、回答を連絡先変数に保存し、私に通知してください。」

エージェントは get_workspace_summary / get_flow_context でワークスペースを読み込み、フロービルダーのアクションをまとめて作成し、validate_actions で検証してから、apply_actions で適用します。ツールの詳細なリファレンスは mcp/README.md をご覧ください。

テンプレート

templates/ 内の各 JSON ファイルは、メタデータ（タイトル、概要、ユースケース、推奨変数、必須モジュール）と schemaExample.actions 配列を含む、完全なボットです。この配列には、apply_actions が受け付けるものとまったく同じ形式で、create_flow / create_block / create_link / create_variable 操作が順序どおりにまとめられています。

利用方法は 3 通りあります。

1. ギャラリーからワンクリックでインストール：flowcastle.ai/templates
2. MCP 経由 — エージェントに search_flow_examples / get_flow_example を使ってもらい、ワークスペースに適用します（必要に応じてカスタマイズもできます）
3. リファレンスとして — 実際のフローでトリガー、条件、返信待ちステップ、決済、AI ブロックがどのように接続されるかを確認します

全テンプレートの一覧と形式の説明は templates/README.md をご覧ください。

REST Public API

連絡先、連絡先変数、目標イベント、フロー送信、一斉配信用のアプリケーション単位の REST API です。

• ベース URL：https://api.flowcastle.ai/api/public/v1
• インタラクティブドキュメント（Swagger）：https://api.flowcastle.ai/api/public/docs
• OpenAPI 仕様：https://api.flowcastle.ai/api/public/openapi.json

認証には、同じ app_… アプリケーションキーを使用します（Authorization: Bearer または X-API-Key）。

ガイド

FlowCastle ブログの手順に沿った構築ガイド：

• Telegram でリード獲得ボットを 10 分で構築する
• Telegram 向け AI サポートボットを構築する
• 朝のアプリを 1 つの Telegram ボットに置き換えました

リンク

• 製品：https://flowcastle.ai
• ダッシュボード：https://dashboard.flowcastle.ai
• テンプレートギャラリー：https://flowcastle.ai/templates
• API ドキュメント：https://api.flowcastle.ai/api/public/docs

貢献

テンプレートのバグを見つけた場合や、共有する価値のあるフローを作成した場合は、issue または PR を作成してください。テンプレートはプレーンな JSON で、validate_actions（MCP 経由）を使えば、バッチが正しい形式かどうかを確認できます。

ライセンス

このリポジトリの内容は、MIT License のライセンスに基づいています。