blinkbox

BlinkBox

ネイティブ MCP サーバーを備えたオープンソースの自動化プラットフォーム（Zapier／Make／n8n の代替）。Claude Code、Cursor、ChatGPT を接続して、エージェントにワークフローの構築、実行、デバッグを任せられます。

blinkbox.net で無料のホステッドプランを利用できます（カード不要） · Node 22 + MongoDB + Redis でセルフホストできます · MIT。

---

できること

• MCP サーバー — プラットフォーム全体を Model Context Protocol（Streamable HTTP）経由で利用できます。コーディングエージェントはツール呼び出しでワークフローを一覧表示、作成、実行、有効化、デバッグできます。詳しくはClaude Code から使うをご覧ください
• エージェントスキル — エージェントにノードのフィールド、式の構文、実行ルールを教える SKILL.md です。推測しながら約 12 回ツールを呼び出す代わりに、約 4 回で動作するフローを作成できます
• ドラッグ＆ドロップ式キャンバス — エージェントが構築したものはすべて、開いて視覚的に編集できる通常のワークフローです
• AI エージェント — データを推論し、構造化された結果を出力する LLM ノードです
• ヘッドレススクレイピング — Chromium のフルプールを備え、ボット対策を回避して JavaScript をレンダリングします
• コードサンドボックス — メモリー制限付きの隔離された V8 サンドボックスで JavaScript を記述できます
• 250 以上のインテグレーション — Gmail、Slack、Stripe、GitHub、Notion、Airtable、Shopify などに対応しています
• 暗号化された認証情報ボールト — AES-256-GCM を使用し、秘密情報が復号された状態でサーバーから外に出ることはありません

---

Claude Code、Cursor、ChatGPT から使う（60 秒）

1. blinkbox.net で登録 → Dashboard → MCP → API キーを作成します。

2. クライアントにサーバーを追加します。

   # Claude Code
   claude mcp add --transport http blinkbox https://mcp.blinkbox.net/mcp \
     --header "Authorization: Bearer <your key>"
   

   // Cursor / Claude Desktop / any client that takes a JSON config
   {
     "mcpServers": {
       "blinkbox": {
         "url": "https://mcp.blinkbox.net/mcp",
         "headers": { "Authorization": "Bearer <your key>" }
       }
     }
   }
   

   ヘッダーを送信できないクライアントでは、代わりに URL にキーを渡せます。https://mcp.blinkbox.net/mcp?key=<your key>。

3. （推奨）エージェントがノードカタログと式の構文を把握できるよう、スキルをインストールします。

   mkdir -p ~/.claude/skills/blinkbox && curl -fsSL \
     https://raw.githubusercontent.com/blinkboxhq/Blinkbox/main/.claude/skills/blinkbox/SKILL.md \
     -o ~/.claude/skills/blinkbox/SKILL.md
   

4. 実現したいことを依頼します。

   「毎朝 8 時に、OpenStreetMap でウェブサイト、メールアドレス、電話番号を掲載しているベルリンの歯科医を探し、Google スプレッドシートと重複チェックして、新しいものを追記して。」

   エージェントは create_automation を呼び出し、run_automation で実行します。失敗した場合は get_execution_logs でログを確認し、問題がなければ activate_automation で有効化します。OAuth アプリ（Google、Slack、Notion など）はダッシュボードで一度だけユーザーが接続します。エージェントがトークンを見ることはありません。

ツール： list_automations · get_automation · create_automation · run_automation · activate_automation · deactivate_automation · rename_automation · delete_automation · list_executions · get_execution · get_execution_logs · list_nodes · get_node · list_node_actions · list_credentials · create_credential · blinkbox_api_get · blinkbox_api

セルフホストする場合、同じサーバーは <your backend>/api/mcp で利用できます。ご自身のダッシュボードでキーを作成してください。

---

技術スタック

レイヤー	技術
フロントエンド	React 18 + Vite + Tailwind CSS + ReactFlow
バックエンド	Node.js + Express + MongoDB Atlas + Redis
AI	Anthropic Claude（主要）→ Groq → Gemini（フォールバック）
スクレイピング	Puppeteer + Chromium
実行	カーソルベースの分散エンジン、4 つのワーカーセル
デプロイ	Railway（nixpacks）

---

ローカル環境のセットアップ

前提条件

• Node.js ≥ 22
• MongoDB Atlas クラスター（またはローカル MongoDB）
• Redis（ローカルまたは Upstash）

1. クローン

git clone https://github.com/blinkboxhq/Blinkbox.git
cd Blinkbox
npm install

2. 環境を設定

cp apps/backend/.env.example apps/backend/.env

apps/backend/.env を編集します。最低限、次が必要です。

MONGODB_URI=mongodb+srv://...
REDIS_URL=redis://localhost:6379
JWT_SECRET=your-32-char-secret
ENCRYPTION_KEY=your-exactly-32-char-key
ANTHROPIC_API_KEY=sk-ant-...          # enables the AI workflow builder behind create_automation

3. 起動

# Terminal 1 — backend (port 3000)
cd apps/backend && npm run dev

# Terminal 2 — frontend (port 5174)
cd apps/frontend && npm run dev

http://localhost:5174 を開きます。

---

環境変数

必須

変数	説明
MONGODB_URI	MongoDB 接続文字列
REDIS_URL	Redis 接続文字列
JWT_SECRET	32 文字以上の任意のランダム文字列
ENCRYPTION_KEY	ちょうど 32 文字 — 認証情報ボールトの AES 暗号化に使用します

AI（少なくとも1つを推奨）

変数	説明
ANTHROPIC_API_KEY	create_automation MCP ツールで使用するAIワークフロービルダー（Claude）を有効にします
GROQ_API_KEY	フォールバック LLM（Llama 3.3 70B）
GOOGLE_AI_KEY	フォールバック LLM（Gemini 2.0 Flash）

OAuth 統合（任意）

変数	説明
GOOGLE_CLIENT_ID / GOOGLE_CLIENT_SECRET	Gmail、Drive、Calendar の OAuth
SLACK_CLIENT_ID / SLACK_CLIENT_SECRET	Slack の OAuth
GITHUB_CLIENT_ID / GITHUB_CLIENT_SECRET	GitHub の OAuth
MICROSOFT_CLIENT_ID / MICROSOFT_CLIENT_SECRET	Microsoft 365 の OAuth
NOTION_CLIENT_ID / NOTION_CLIENT_SECRET	Notion の OAuth
AIRTABLE_CLIENT_ID / AIRTABLE_CLIENT_SECRET	Airtable の OAuth

デプロイ

変数	説明
BACKEND_PUBLIC_URL	外部公開されるバックエンドの URL（例：https://api.blinkbox.net）— OAuth コールバックに必須です
FRONTEND_URL	CORS 許可リストに登録するフロントエンドの URL
PORT	バックエンドのポート（デフォルト：3000）

---

アーキテクチャ

┌─────────────────────────────────────────────────────┐
│                    Frontend (Vite)                  │
│  Dashboard · Workspace Canvas · MCP keys            │
└───────────────────────┬─────────────────────────────┘
                        │ REST API
┌───────────────────────▼─────────────────────────────┐
│                Backend (Express)                    │
│  Auth · Automations · Executions · Credentials      │
│  MCP server · AI builder · OAuth · Webhooks         │
└──────────┬──────────────────┬───────────────────────┘
           │                  │
    ┌──────▼──────┐    ┌──────▼──────┐
    │  MongoDB    │    │    Redis    │
    │  Atlas      │    │   Queues   │
    └─────────────┘    └──────┬──────┘
                              │
                    ┌─────────▼───────────┐
                    │  Execution Workers  │
                    │  (4 cursor cells)   │
                    │  Chromium pool      │
                    └─────────────────────┘

実行エンジン

ワークフローはカーソルベースのステートマシンとして実行されます。各実行はカーソル配列を持つ MongoDB ドキュメントです。ワーカーは arrayFilters を介してカーソルをアトミックに取得し、ノードハンドラーを実行してカーソルを進め、解放します。Redis キューにより、トリガーのファンアウトと実行が分離されます。再開プロセスは、クラッシュした実行を5秒ごとに復旧します。

ノードシステム

すべての統合は、次の2つの部分で構成されるノードです。

• フロントエンド（nodeRegistry.js）— 設定パネル、アイコン、ラベル、カテゴリ
• バックエンド（nodes/）— ステートレスなハンドラー async (config, context) => result

同じ backendType キーで両側を連携させます。250以上のノードが登録されています。

---

AI ワークフロービルダー

create_automation（MCP ツール）は、説明をサーバー側のビルダーに渡します。

「新しい Stripe の支払いが入ったら、HubSpot で顧客を検索し、#revenue に Slack アラートを送信する」

ビルダーはノードのナレッジベースと強制的なツール使用を指定して Claude を呼び出し、完全に設定され、キャンバス上で正しく配置されたワークフローを返します。実際のフィールド値、変数の連鎖（{{trigger.data.from}}）、ノードの位置などを含むワークフローはドラフトとして返され、エージェントまたは UI から実行、確認、有効化できます。

プロバイダーのフォールバック順序： Anthropic → Groq → Gemini

---

セキュリティ

• すべての API ルートで JWT 認証を使用し、ワークスペースのスコープに限定してクエリを実行します
• AES-256-GCM で認証情報を暗号化します（キーは DB に保存されません）
• すべての外部 HTTP リクエストに SSRF ガードを適用します
• コードサンドボックス：メモリと時間の制限を設けた分離済み V8（isolated-vm）
• シェルツールノードは ENABLE_SHELL_TOOLS=true の場合にのみ使用できます（デフォルトでは無効）
• OAuth の状態トークン（CSRF 保護）を使用し、postMessage の送信先は明示的なオリジンのみに限定します
• Webhook トリガーにレート制限を適用します（Redis ベースで、再起動後も維持されます）

---

Railway へのデプロイ

1. Railway プロジェクトを作成し、リポジトリを追加します
2. Railway ダッシュボードですべての必須環境変数を設定します
3. BACKEND_PUBLIC_URL に Railway のバックエンド URL を設定します
4. Gmail を使用する場合は、その URL を Google Cloud Console の OAuth リダイレクト URI として登録します

apps/backend/ の nixpacks.toml により、Chromium と必要なネイティブ依存関係が自動的にインストールされます。

---

ライセンス

MIT